Method: documents.create

{
  "documentId": string,
  "title": string,
  "tabs": [
    {
      object (Tab)
    }
  ],
  "revisionId": string,
  "suggestionsViewMode": enum (SuggestionsViewMode),
  "body": {
    object (Body)
  },
  "headers": {
    string: {
      object (Header)
    },
    ...
  },
  "footers": {
    string: {
      object (Footer)
    },
    ...
  },
  "footnotes": {
    string: {
      object (Footnote)
    },
    ...
  },
  "documentStyle": {
    object (DocumentStyle)
  },
  "suggestedDocumentStyleChanges": {
    string: {
      object (SuggestedDocumentStyle)
    },
    ...
  },
  "namedStyles": {
    object (NamedStyles)
  },
  "suggestedNamedStylesChanges": {
    string: {
      object (SuggestedNamedStyles)
    },
    ...
  },
  "lists": {
    string: {
      object (List)
    },
    ...
  },
  "namedRanges": {
    string: {
      object (NamedRanges)
    },
    ...
  },
  "inlineObjects": {
    string: {
      object (InlineObject)
    },
    ...
  },
  "positionedObjects": {
    string: {
      object (PositionedObject)
    },
    ...
  }
}

string

النتائج فقط. رقم تعريف المستند.

string

تمثّل هذه السمة عنوان المستند.

object (Tab)

علامات التبويب التي تشكِّل جزءًا من مستند

يمكن أن تحتوي علامات التبويب على علامات تبويب فرعية، وهي علامة تبويب مدمجة في علامة تبويب أخرى. يتم تمثيل علامات التبويب الفرعية بالحقل Tab.childTabs.

string

النتائج فقط. معرّف النسخة السابقة للمستند. يمكن استخدامها في طلبات التحديث لتحديد مراجعة المستند التي تريد تطبيق التحديثات عليها وكيف يجب أن يتصرف الطلب إذا تم تعديل المستند منذ تلك المراجعة. لا تتم تعبئة هذا الحقل إلا إذا كان لدى المستخدم الإذن بتعديل المستند.

معرّف النسخة السابقة ليس رقمًا تسلسليًا ولكنه سلسلة مبهمة. قد يتغير تنسيق رقم تعريف النسخة السابقة بمرور الوقت. إنّ معرّف النسخة السابقة الذي تم إرجاعه مضمون فقط لمدة 24 ساعة بعد إرجاعه ولا يمكن مشاركته بين المستخدمين. إذا لم يتغير رقم تعريف النسخة السابقة بين المكالمات، فلن يتغير المستند. وفي المقابل، يعني تغيير المعرّف (للمستند والمستخدم نفسه) عادةً أنّه تم تعديل المستند. ومع ذلك، قد يرجع تغيير رقم التعريف أيضًا إلى عوامل داخلية، مثل التغييرات في تنسيق المعرّف.

enum (SuggestionsViewMode)

النتائج فقط. وضع عرض الاقتراحات المطبَّق على المستند

ملاحظة: عند تعديل مستند، يجب أن تستند التغييرات إلى مستند يحتوي على SUGGESTIONS_INLINE.

object (Body)

النتائج فقط. تمثّل هذه السمة النص الأساسي للمستند.

حقل قديم: بدلاً من ذلك، يمكنك استخدام Document.tabs.documentTab.body التي تعرض المحتوى الفعلي للمستند من جميع علامات التبويب عند ضبط مَعلمة includeTabsContent على true. في حال اختيار false أو تركها بدون ضبط، سيحتوي هذا الحقل على معلومات حول علامة التبويب الأولى في المستند.

map (key: string, value: object (Header))

النتائج فقط. العناوين في المستند، مرتبطة بمعرّف العنوان.

حقل قديم: بدلاً من ذلك، يمكنك استخدام Document.tabs.documentTab.headers التي تعرض المحتوى الفعلي للمستند من جميع علامات التبويب عند ضبط مَعلمة includeTabsContent على true. في حال اختيار false أو تركها بدون ضبط، سيحتوي هذا الحقل على معلومات حول علامة التبويب الأولى في المستند.

map (key: string, value: object (Footer))

النتائج فقط. التذييلات في المستند، مرتبطة برقم تعريف التذييل.

حقل قديم: بدلاً من ذلك، يمكنك استخدام Document.tabs.documentTab.footers التي تعرض المحتوى الفعلي للمستند من جميع علامات التبويب عند ضبط مَعلمة includeTabsContent على true. في حال اختيار false أو تركها بدون ضبط، سيحتوي هذا الحقل على معلومات حول علامة التبويب الأولى في المستند.

map (key: string, value: object (Footnote))

النتائج فقط. الحواشي السفلية في المستند، مرتبطة برقم تعريف الحاشية السفلية.

حقل قديم: بدلاً من ذلك، يمكنك استخدام Document.tabs.documentTab.footnotes التي تعرض المحتوى الفعلي للمستند من جميع علامات التبويب عند ضبط مَعلمة includeTabsContent على true. في حال اختيار false أو تركها بدون ضبط، سيحتوي هذا الحقل على معلومات حول علامة التبويب الأولى في المستند.

object (DocumentStyle)

النتائج فقط. نمط المستند.

حقل قديم: بدلاً من ذلك، يمكنك استخدام Document.tabs.documentTab.documentStyle التي تعرض المحتوى الفعلي للمستند من جميع علامات التبويب عند ضبط مَعلمة includeTabsContent على true. في حال اختيار false أو تركها بدون ضبط، سيحتوي هذا الحقل على معلومات حول علامة التبويب الأولى في المستند.

map (key: string, value: object (SuggestedDocumentStyle))

النتائج فقط. التغييرات المقترَحة على نمط المستند، استنادًا إلى رقم تعريف الاقتراح

حقل قديم: بدلاً من ذلك، يمكنك استخدام Document.tabs.documentTab.suggestedDocumentStyleChanges التي تعرض المحتوى الفعلي للمستند من جميع علامات التبويب عند ضبط مَعلمة includeTabsContent على true. في حال اختيار false أو تركها بدون ضبط، سيحتوي هذا الحقل على معلومات حول علامة التبويب الأولى في المستند.

object (NamedStyles)

النتائج فقط. الأنماط المُسَمّاة للمستند

حقل قديم: بدلاً من ذلك، يمكنك استخدام Document.tabs.documentTab.namedStyles التي تعرض المحتوى الفعلي للمستند من جميع علامات التبويب عند ضبط مَعلمة includeTabsContent على true. في حال اختيار false أو تركها بدون ضبط، سيحتوي هذا الحقل على معلومات حول علامة التبويب الأولى في المستند.

map (key: string, value: object (SuggestedNamedStyles))

النتائج فقط. التغييرات المقترحة على الأنماط المُسَمّاة للمستند، استنادًا إلى رقم تعريف الاقتراح

حقل قديم: بدلاً من ذلك، يمكنك استخدام Document.tabs.documentTab.suggestedNamedStylesChanges التي تعرض المحتوى الفعلي للمستند من جميع علامات التبويب عند ضبط مَعلمة includeTabsContent على true. في حال اختيار false أو تركها بدون ضبط، سيحتوي هذا الحقل على معلومات حول علامة التبويب الأولى في المستند.

map (key: string, value: object (List))

النتائج فقط. القوائم الموجودة في المستند، مرتبطة برقم تعريف القائمة.

حقل قديم: بدلاً من ذلك، يمكنك استخدام Document.tabs.documentTab.lists التي تعرض المحتوى الفعلي للمستند من جميع علامات التبويب عند ضبط مَعلمة includeTabsContent على true. في حال اختيار false أو تركها بدون ضبط، سيحتوي هذا الحقل على معلومات حول علامة التبويب الأولى في المستند.

map (key: string, value: object (NamedRanges))

النتائج فقط. النطاقات المُعنونة في المستند، مفصولة حسب الاسم.

حقل قديم: بدلاً من ذلك، يمكنك استخدام Document.tabs.documentTab.namedRanges التي تعرض المحتوى الفعلي للمستند من جميع علامات التبويب عند ضبط مَعلمة includeTabsContent على true. في حال اختيار false أو تركها بدون ضبط، سيحتوي هذا الحقل على معلومات حول علامة التبويب الأولى في المستند.

map (key: string, value: object (InlineObject))

النتائج فقط. تمثّل هذه السمة العناصر المضمَّنة في المستند، استنادًا إلى رقم تعريف الكائن.

حقل قديم: بدلاً من ذلك، يمكنك استخدام Document.tabs.documentTab.inlineObjects التي تعرض المحتوى الفعلي للمستند من جميع علامات التبويب عند ضبط مَعلمة includeTabsContent على true. في حال اختيار false أو تركها بدون ضبط، سيحتوي هذا الحقل على معلومات حول علامة التبويب الأولى في المستند.

map (key: string, value: object (PositionedObject))

النتائج فقط. يشير ذلك المصطلح إلى العناصر الموضوعة في المستند، استنادًا إلى رقم تعريف الكائن.

حقل قديم: بدلاً من ذلك، يمكنك استخدام Document.tabs.documentTab.positionedObjects التي تعرض المحتوى الفعلي للمستند من جميع علامات التبويب عند ضبط مَعلمة includeTabsContent على true. في حال اختيار false أو تركها بدون ضبط، سيحتوي هذا الحقل على معلومات حول علامة التبويب الأولى في المستند.