Method: documents.create

יצירת מסמך ריק לפי הכותרת שמופיעה בבקשה. המערכת מתעלמת משדות אחרים בבקשה, כולל תוכן שסופק.

הפונקציה מחזירה את המסמך שנוצר.

בקשת HTTP

POST https://docs.googleapis.com/v1/documents

בכתובת ה-URL נעשה שימוש בתחביר המרת קידוד של gRPC.

גוף הבקשה

גוף הבקשה מכיל נתונים במבנה הבא:

ייצוג ב-JSON
{
  "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)
    },
    ...
  }
}
שדות
documentId

string

פלט בלבד. המזהה של המסמך.

title

string

כותרת המסמך.

tabs[]

object (Tab)

כרטיסיות שהן חלק ממסמך.

כרטיסיות יכולות להכיל כרטיסיות צאצא, כרטיסייה שבתוך כרטיסייה אחרת. הכרטיסיות הצאצאיות מיוצגות בשדה Tab.childTabs.

revisionId

string

פלט בלבד. מזהה הגרסה של המסמך. אפשר להשתמש בו בבקשות לעדכון כדי לציין על איזו גרסה של מסמך להחיל את העדכונים ואיך הבקשה צריכה לפעול אם המסמך עבר עריכה מאז הגרסה הזו. השדה הזה מאוכלס רק אם למשתמש יש גישת עריכה למסמך.

מזהה הגרסה הוא לא מספר רציף, אלא מחרוזת אטומה. הפורמט של מזהה הגרסה הקודמת עשוי להשתנות עם הזמן. מובטח שמזהה הגרסה שהוחזר יהיה תקף רק ל-24 שעות לאחר החזרתו, ולא ניתן לשתף אותו עם משתמשים. אם מזהה הגרסה לא משתנה בין הקריאות, סימן שהמסמך לא השתנה. לעומת זאת, מזהה שהשתנה (באותו מסמך ובאותו משתמש) בדרך כלל מציין שהמסמך עודכן. עם זאת, שינוי המזהה יכול גם לנבוע מגורמים פנימיים, כמו שינויים בפורמט של המזהה.

suggestionsViewMode

enum (SuggestionsViewMode)

פלט בלבד. מצב תצוגת ההצעות שהוחל על המסמך.

הערה: כשעורכים מסמך, השינויים חייבים להתבסס על מסמך עם SUGGESTIONS_INLINE.

body

object (Body)

פלט בלבד. התוכן הראשי של המסמך.

השדה 'מדור קודם': במקום זאת, צריך להשתמש ב-Document.tabs.documentTab.body, שחושף את תוכן המסמך עצמו מכל הכרטיסיות כשהפרמטר includeTabsContent מוגדר ל-true. אם המדיניות false או לא מוגדרת, השדה הזה מכיל מידע על הכרטיסייה הראשונה במסמך.

headers

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

פלט בלבד. הכותרות במסמך, לפי מפתח של מזהה כותרת.

השדה 'מדור קודם': במקום זאת, צריך להשתמש ב-Document.tabs.documentTab.headers, שחושף את תוכן המסמך עצמו מכל הכרטיסיות כשהפרמטר includeTabsContent מוגדר ל-true. אם השדה מוגדר כ-false או לא מוגדר, הוא מכיל מידע על הכרטיסייה הראשונה במסמך.

footers

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

פלט בלבד. כותרות התחתונות במסמך, לפי מפתח של מזהה כותרת תחתונה.

שדה מדור קודם: במקום זאת, משתמשים ב-Document.tabs.documentTab.footers, שמציג את תוכן המסמך בפועל מכל הכרטיסיות כשהפרמטר includeTabsContent מוגדר כ-true. אם המדיניות false או לא מוגדרת, השדה הזה מכיל מידע על הכרטיסייה הראשונה במסמך.

footnotes

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

פלט בלבד. הערות השוליים במסמך, כשהן מקובצות לפי מזהה של הערת שוליים.

השדה 'מדור קודם': במקום זאת, צריך להשתמש ב-Document.tabs.documentTab.footnotes, שחושף את תוכן המסמך עצמו מכל הכרטיסיות כשהפרמטר includeTabsContent מוגדר ל-true. אם השדה מוגדר כ-false או לא מוגדר, הוא מכיל מידע על הכרטיסייה הראשונה במסמך.

documentStyle

object (DocumentStyle)

פלט בלבד. סגנון המסמך.

שדה מדור קודם: במקום זאת, משתמשים ב-Document.tabs.documentTab.documentStyle, שמציג את תוכן המסמך בפועל מכל הכרטיסיות כשהפרמטר includeTabsContent מוגדר כ-true. אם השדה מוגדר כ-false או לא מוגדר, הוא מכיל מידע על הכרטיסייה הראשונה במסמך.

suggestedDocumentStyleChanges

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

פלט בלבד. השינויים המוצעים בסגנון של המסמך, לפי מזהה ההצעה.

השדה 'מדור קודם': במקום זאת, צריך להשתמש ב-Document.tabs.documentTab.suggestedDocumentStyleChanges, שחושף את תוכן המסמך עצמו מכל הכרטיסיות כשהפרמטר includeTabsContent מוגדר ל-true. אם המדיניות false או לא מוגדרת, השדה הזה מכיל מידע על הכרטיסייה הראשונה במסמך.

namedStyles

object (NamedStyles)

פלט בלבד. סגנונות המסמך בעלי השם.

השדה 'דור קודם': במקום זאת, צריך להשתמש ב-Document.tabs.documentTab.namedStyles, שחושף את תוכן המסמך עצמו מכל הכרטיסיות כשהפרמטר includeTabsContent מוגדר ל-true. אם המדיניות false או לא מוגדרת, השדה הזה מכיל מידע על הכרטיסייה הראשונה במסמך.

suggestedNamedStylesChanges

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

פלט בלבד. ההצעות לשינויים לסגנונות של המסמך שקיבלו שם, עם מזהה ההצעה.

השדה 'דור קודם': במקום זאת, צריך להשתמש ב-Document.tabs.documentTab.suggestedNamedStylesChanges, שחושף את תוכן המסמך עצמו מכל הכרטיסיות כשהפרמטר includeTabsContent מוגדר ל-true. אם המדיניות false או לא מוגדרת, השדה הזה מכיל מידע על הכרטיסייה הראשונה במסמך.

lists

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

פלט בלבד. הרשימות במסמך, לפי מפתח של מזהה רשימה.

שדה מדור קודם: במקום זאת, משתמשים ב-Document.tabs.documentTab.lists, שמציג את תוכן המסמך בפועל מכל הכרטיסיות כשהפרמטר includeTabsContent מוגדר כ-true. אם השדה מוגדר כ-false או לא מוגדר, הוא מכיל מידע על הכרטיסייה הראשונה במסמך.

namedRanges

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

פלט בלבד. טווחי השמות במסמך, עם קידוד לפי שם.

שדה מדור קודם: במקום זאת, משתמשים ב-Document.tabs.documentTab.namedRanges, שמציג את תוכן המסמך בפועל מכל הכרטיסיות כשהפרמטר includeTabsContent מוגדר כ-true. אם השדה מוגדר כ-false או לא מוגדר, הוא מכיל מידע על הכרטיסייה הראשונה במסמך.

inlineObjects

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

פלט בלבד. האובייקטים המוטבעים במסמך, עם קידוד לפי מזהה אובייקט.

השדה 'מדור קודם': במקום זאת, צריך להשתמש ב-Document.tabs.documentTab.inlineObjects, שחושף את תוכן המסמך עצמו מכל הכרטיסיות כשהפרמטר includeTabsContent מוגדר ל-true. אם השדה מוגדר כ-false או לא מוגדר, הוא מכיל מידע על הכרטיסייה הראשונה במסמך.

positionedObjects

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

פלט בלבד. האובייקטים הממוקמים במסמך, עם קידוד לפי מזהה אובייקט.

השדה 'מדור קודם': במקום זאת, צריך להשתמש ב-Document.tabs.documentTab.positionedObjects, שחושף את תוכן המסמך עצמו מכל הכרטיסיות כשהפרמטר includeTabsContent מוגדר ל-true. אם המדיניות false או לא מוגדרת, השדה הזה מכיל מידע על הכרטיסייה הראשונה במסמך.

גוף התשובה

אם הפעולה בוצעה ללא שגיאות, גוף התגובה יכיל מופע חדש של Document.

היקפי ההרשאות

נדרש אחד מהיקפי ההרשאות הבאים של OAuth:

  • https://www.googleapis.com/auth/documents
  • https://www.googleapis.com/auth/drive
  • https://www.googleapis.com/auth/drive.file

מידע נוסף זמין במדריך ההרשאות.