ينشئ مستندًا فارغًا باستخدام العنوان الوارد في الطلب. ويتم تجاهل الحقول الأخرى في الطلب، بما في ذلك أي محتوى تم تقديمه.
تعرض المستند الذي تم إنشاؤه.
طلب HTTP
POST https://docs.googleapis.com/v1/documents
يستخدِم عنوان URL بنية تحويل ترميز gRPC.
نص الطلب
يحتوي نص الطلب على بيانات بالبنية التالية:
تمثيل JSON |
---|
{ "documentId": string, "title": string, "tabs": [ { object ( |
الحقول | |
---|---|
documentId |
النتائج فقط. رقم تعريف المستند. |
title |
عنوان المستند. |
tabs[] |
علامات التبويب التي تشكّل جزءًا من مستند يمكن أن تحتوي علامات التبويب على علامات تبويب فرعية، وهي علامة تبويب مضمّنة في علامة تبويب أخرى. يتم تمثيل علامات التبويب الفرعية بالحقل |
revisionId |
النتائج فقط. رقم تعريف المراجعة للمستند. يمكن استخدامها في طلبات التحديث لتحديد مراجعة المستند التي تريد تطبيق التحديثات عليها وكيف يجب أن يتصرف الطلب إذا تم تعديل المستند منذ تلك المراجعة. لا تتم تعبئة هذا الحقل إلا إذا كان لدى المستخدم الإذن بتعديل المستند. معرّف المراجعة ليس رقمًا تسلسليًا، بل سلسلة غير شفافة. قد يتغير تنسيق رقم تعريف النسخة السابقة بمرور الوقت. لا يمكن ضمان صلاحية معرّف المراجعة الذي تم إرجاعه إلا لمدة 24 ساعة بعد إرجاعه، ولا يمكن مشاركته مع جميع المستخدمين. إذا لم يتغيّر رقم تعريف المراجعة بين المكالمات، يعني ذلك أنّه لم يتم تغيير المستند. في المقابل، يعني رقم التعريف المتغيّر (للمستند والمستخدم نفسهما) عادةً أنّه تم تعديل المستند. ومع ذلك، يمكن أن يرجع سبب تغيير رقم التعريف أيضًا إلى عوامل داخلية، مثل تغييرات تنسيق رقم التعريف. |
suggestionsViewMode |
النتائج فقط. وضع عرض الاقتراحات الذي تم تطبيقه على المستند ملاحظة: عند تعديل مستند، يجب أن تستند التغييرات إلى مستند يحتوي على |
body |
النتائج فقط. النص الرئيسي للمستند. حقل قديم: بدلاً من ذلك، يمكنك استخدام |
headers |
النتائج فقط. العناوين في المستند، مفعَّلة حسب رقم تعريف العنوان حقل قديم: بدلاً من ذلك، يمكنك استخدام |
footers |
النتائج فقط. التذييلات في المستند، مرتبطة برقم تعريف التذييل. حقل قديم: بدلاً من ذلك، يمكنك استخدام |
footnotes |
النتائج فقط. الحواشي السفلية في المستند، مرتبطة برقم تعريف الحاشية السفلية. حقل قديم: بدلاً من ذلك، يمكنك استخدام |
documentStyle |
النتائج فقط. نمط المستند. الحقل القديم: استخدِم بدلاً من ذلك |
suggestedDocumentStyleChanges |
النتائج فقط. التغييرات المقترَحة على نمط المستند، استنادًا إلى رقم تعريف الاقتراح حقل قديم: بدلاً من ذلك، يمكنك استخدام |
namedStyles |
النتائج فقط. الأنماط المُسَمّاة للمستند الحقل القديم: استخدِم بدلاً من ذلك |
suggestedNamedStylesChanges |
النتائج فقط. التغييرات المقترحة على الأنماط المُسَمّاة للمستند، استنادًا إلى رقم تعريف الاقتراح الحقل القديم: استخدِم بدلاً من ذلك |
lists |
النتائج فقط. القوائم في المستند، مفعَّلة حسب معرّف القائمة الحقل القديم: استخدِم بدلاً من ذلك |
namedRanges |
النتائج فقط. النطاقات المُعنونة في المستند، مفصولة حسب الاسم. حقل قديم: بدلاً من ذلك، يمكنك استخدام |
inlineObjects |
النتائج فقط. تمثّل هذه السمة العناصر المضمَّنة في المستند، استنادًا إلى رقم تعريف الكائن. حقل قديم: بدلاً من ذلك، يمكنك استخدام |
positionedObjects |
النتائج فقط. العناصر التي تمّ وضعها في المستند، مع ترتيبها حسب معرّف العنصر حقل قديم: بدلاً من ذلك، يمكنك استخدام |
نص الاستجابة
في حال نجاح الإجراء، يحتوي نص الاستجابة على مثيل Document
تم إنشاؤه حديثًا.
نطاقات التفويض
يتطلب هذا الإعداد أحد نطاقات OAuth التالية:
https://www.googleapis.com/auth/documents
https://www.googleapis.com/auth/drive
https://www.googleapis.com/auth/drive.file
لمزيد من المعلومات، يمكنك الاطّلاع على دليل التفويض.