REST Resource: documents

{
  "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 או לא מוגדרת, השדה הזה מכיל מידע על הכרטיסייה הראשונה במסמך.

{
  "tabProperties": {
    object (TabProperties)
  },
  "childTabs": [
    {
      object (Tab)
    }
  ],

  // Union field content can be only one of the following:
  "documentTab": {
    object (DocumentTab)
  }
  // End of list of possible types for union field content.
}

object (TabProperties)

המאפיינים של הכרטיסייה, כמו ID ו-title.

object (Tab)

הכרטיסיות המשניות שמוטמעות בכרטיסייה הזו.

object (DocumentTab)

כרטיסייה עם תוכן המסמך, כמו טקסט ותמונות.

{
  "tabId": string,
  "title": string,
  "parentTabId": string,
  "index": integer,
  "nestingLevel": integer
}

string

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

string

השם של הכרטיסייה שגלוי למשתמש.

string

זה שינוי אופציונלי. המזהה של כרטיסיית ההורה. ריקה אם הכרטיסייה הנוכחית היא כרטיסייה ברמה הבסיסית (root), כלומר אין לה תבניות הורה.

integer

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

integer

פלט בלבד. עומק הכרטיסייה בתוך המסמך. כרטיסיות ברמה הבסיסית מתחילות ב-0.

{
  "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)
    },
    ...
  }
}

object (Body)

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

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

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

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

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

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

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

object (DocumentStyle)

הסגנון של הכרטיסייה של המסמך.

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

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

object (NamedStyles)

הסגנונות עם השמות בכרטיסיית המסמך.

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

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

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

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

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

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

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

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

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

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

{
  "content": [
    {
      object (StructuralElement)
    }
  ]
}

object (StructuralElement)

תוכן הגוף.

האינדקסים של תוכן הגוף מתחילים באפס.

{
  "startIndex": integer,
  "endIndex": integer,

  // Union field content can be only one of the following:
  "paragraph": {
    object (Paragraph)
  },
  "sectionBreak": {
    object (SectionBreak)
  },
  "table": {
    object (Table)
  },
  "tableOfContents": {
    object (TableOfContents)
  }
  // End of list of possible types for union field content.
}

integer

אינדקס ההתחלה שמתחיל באפס של רכיב המבנה הזה, ביחידות קוד UTF-16.

integer

אינדקס הסיום שמתחיל באפס של רכיב המבנה הזה, לא כולל, ביחידות קוד UTF-16.

object (Paragraph)

אלמנט מבני מסוג פסקאות.

object (SectionBreak)

סוג של אלמנט מבני של מעבר בין קטעים.

object (Table)

סוג טבלה של אלמנט מבני.

object (TableOfContents)

סוג תוכן עניינים של רכיב מבני.

{
  "elements": [
    {
      object (ParagraphElement)
    }
  ],
  "paragraphStyle": {
    object (ParagraphStyle)
  },
  "suggestedParagraphStyleChanges": {
    string: {
      object (SuggestedParagraphStyle)
    },
    ...
  },
  "bullet": {
    object (Bullet)
  },
  "suggestedBulletChanges": {
    string: {
      object (SuggestedBullet)
    },
    ...
  },
  "positionedObjectIds": [
    string
  ],
  "suggestedPositionedObjectIds": {
    string: {
      object (ObjectReferences)
    },
    ...
  }
}

object (ParagraphElement)

תוכן הפסקה בחלוקה לחלקים שמרכיבים אותה.

object (ParagraphStyle)

הסגנון של הפסקה הזו.

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

סגנון הפסקה המוצע ישתנה לפסקה הזו, כשהוא מקודד לפי מזהה ההצעה.

object (Bullet)

סמליל הנקודה בפסקה הזו. אם הוא לא מופיע, הפסקה לא שייכת לרשימה.

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

ההצעות לשינויים בתבליט של פסקה זו.

string

המזהים של האובייקטים הממוקמים, הקשורים לפיסקה זו.

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

המזהים של האובייקטים הממוקמים שהוצעו לצירוף לפסקה הזו, עם קידוד לפי מזהה הצעה.

{
  "startIndex": integer,
  "endIndex": integer,

  // Union field content can be only one of the following:
  "textRun": {
    object (TextRun)
  },
  "autoText": {
    object (AutoText)
  },
  "pageBreak": {
    object (PageBreak)
  },
  "columnBreak": {
    object (ColumnBreak)
  },
  "footnoteReference": {
    object (FootnoteReference)
  },
  "horizontalRule": {
    object (HorizontalRule)
  },
  "equation": {
    object (Equation)
  },
  "inlineObjectElement": {
    object (InlineObjectElement)
  },
  "person": {
    object (Person)
  },
  "richLink": {
    object (RichLink)
  }
  // End of list of possible types for union field content.
}

integer

אינדקס ההתחלה שמתחיל באפס של רכיב הפיסקה הזה, ביחידות קוד UTF-16.

integer

אינדקס הסיום של רכיב הפסקה הזה, לא כולל, בבסיס אפס ביחידות קוד UTF-16.

object (TextRun)

רכיב פסקה של טקסט רצוף.

object (AutoText)

רכיב של פסקה עם טקסט אוטומטי.

object (PageBreak)

רכיב פסקה של מעבר דף.

object (ColumnBreak)

רכיב פסקאות של מעבר עמודה.

object (FootnoteReference)

רכיב פסקה של הפניה להערת שוליים.

object (HorizontalRule)

רכיב פסקה של קו אופקי.

object (Equation)

רכיב של פסקה עם משוואה.

object (InlineObjectElement)

רכיב פסקה של אובייקט בתוך שורה.

object (Person)

רכיב פסקה שמקושר לאדם או לכתובת אימייל.

object (RichLink)

רכיב פסקה שמקושר למשאב של Google (כמו קובץ ב-Google Drive, סרטון ב-YouTube או אירוע ביומן).

{
  "content": string,
  "suggestedInsertionIds": [
    string
  ],
  "suggestedDeletionIds": [
    string
  ],
  "textStyle": {
    object (TextStyle)
  },
  "suggestedTextStyleChanges": {
    string: {
      object (SuggestedTextStyle)
    },
    ...
  }
}

string

הטקסט של ההרצה הזו.

רכיבים שאינם טקסט בהרצה מוחלפים בתו Unicode U+E907.

string

המזהים המוצעים של המודעות. ל-TextRun יכולים להיות מספר מזהי הטמעה אם מדובר בהצעת שינוי בתצוגת עץ. אם השדה ריק, זו לא הצעה להוספה.

string

מזהי המחיקה המוצעים. אם השדה ריק, אין הצעות למחיקה של התוכן.

object (TextStyle)

סגנון הטקסט של ההרצה הזו.

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

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

{
  "bold": boolean,
  "italic": boolean,
  "underline": boolean,
  "strikethrough": boolean,
  "smallCaps": boolean,
  "backgroundColor": {
    object (OptionalColor)
  },
  "foregroundColor": {
    object (OptionalColor)
  },
  "fontSize": {
    object (Dimension)
  },
  "weightedFontFamily": {
    object (WeightedFontFamily)
  },
  "baselineOffset": enum (BaselineOffset),
  "link": {
    object (Link)
  }
}

boolean

מציין אם הטקסט מודגש או לא.

boolean

אם הטקסט נטוי או לא.

boolean

האם הטקסט מופיע עם קו תחתון או לא.

boolean

האם הטקסט מסומן בקו חוצה או לא.

boolean

האם הטקסט מופיע באותיות קטנות.

object (OptionalColor)

צבע הרקע של הטקסט. אם האפשרות מוגדרת, הצבע הוא צבע RGB או שקוף, בהתאם לשדה color.

object (OptionalColor)

צבע החזית של הטקסט. אם האפשרות מוגדרת, הצבע הוא צבע RGB או שקוף, בהתאם לשדה color.

object (Dimension)

גודל הגופן של הטקסט.

object (WeightedFontFamily)

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

אם בבקשת עדכון מצוינים ערכים גם ל-weightedFontFamily וגם ל-bold, המערכת תחיל קודם את המאפיין weightedFontFamily ואז את bold.

אם לא מגדירים את weightedFontFamily#weight, ברירת המחדל היא 400.

אם מגדירים את weightedFontFamily, צריך להגדיר גם את weightedFontFamily#fontFamily עם ערך שאינו ריק. אחרת, תוחזר השגיאה 'בקשה שגויה' 400.

enum (BaselineOffset)

ההיסט האנכי של הטקסט מהמיקום הרגיל שלו.

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

object (Link)

היעד של ההיפר-קישור בטקסט. אם המדיניות לא מוגדרת, אין קישור. הקישורים לא עוברים בירושה מטקסט ההורה.

שינוי הקישור בבקשת עדכון גורם לשינויים נוספים בסגנון הטקסט של הטווח:

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

{
  "color": {
    object (Color)
  }
}

object (Color)

אם הערך הזה מוגדר, הוא ישמש כצבע אטום. אם השדה לא מוגדר, הוא מייצג צבע שקוף.

{
  "rgbColor": {
    object (RgbColor)
  }
}

object (RgbColor)

ערך צבע ה-RGB.

{
  "red": number,
  "green": number,
  "blue": number
}

number

הרכיב האדום של הצבע, מ-0.0 עד 1.0.

number

הרכיב הירוק של הצבע, מ-0.0 עד 1.0.

number

הרכיב הכחול של הצבע, מ-0.0 עד 1.0.

{
  "magnitude": number,
  "unit": enum (Unit)
}

number

העוצמה.

enum (Unit)

יחידות העוצמה.

{
  "fontFamily": string,
  "weight": integer
}

string

משפחת הגופנים של הטקסט.

משפחת הגופנים יכולה להיות כל גופן מתפריט הגופנים ב-Docs או מ-Google Fonts. אם שם הגופן לא מזוהה, הטקסט מעובד ב-Arial.

integer

עובי הגופן. השדה הזה יכול להכיל כל ערך שהוא כפולה של 100 בין 100 ל-900, כולל. הטווח הזה תואם לערכים המספריים שמתוארים במפרט של CSS 2.1, סעיף 15.6, שבהם אסור להשתמש בערכים לא מספריים.

ערך ברירת המחדל הוא 400 ('רגיל').

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

• אם הטקסט מודגש והמשקל קטן מ-400, המשקל לאחר עיבוד הוא 400.
• אם הטקסט מודגש והמשקל גדול מ-400 או שווה לו, אבל קטן מ-700, המשקל לאחר עיבוד הוא 700.
• אם המשקל גדול מ-700 או שווה לו, המשקל לאחר עיבוד שווה למשקל.
• אם הטקסט לא מודגש, המשקל לאחר עיבוד שווה למשקל.

{

  // Union field destination can be only one of the following:
  "url": string,
  "tabId": string,
  "bookmark": {
    object (BookmarkLink)
  },
  "heading": {
    object (HeadingLink)
  },
  "bookmarkId": string,
  "headingId": string
  // End of list of possible types for union field destination.
}

string

כתובת URL חיצונית.

string

המזהה של כרטיסייה במסמך הזה.

object (BookmarkLink)

סימנייה במסמך הזה.

במסמכים שמכילים כרטיסייה יחידה, קישורים לסימניות בכרטיסייה היחידה ממשיכים להחזיר Link.bookmarkId כשהפרמטר includeTabsContent מוגדר ל-false או לא מוגדר. אחרת, השדה הזה מוחזר.

object (HeadingLink)

כותרת במסמך הזה.

במסמכים שמכילים כרטיסייה יחידה, קישורים לכותרות בכרטיסייה היחידה ממשיכים להחזיר Link.headingId כשהפרמטר includeTabsContent מוגדר ל-false או לא מוגדר. אחרת, השדה הזה מוחזר.

string

המזהה של סימנייה במסמך הזה.

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

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

string

המזהה של כותרת במסמך הזה.

השדה 'דור קודם': במקום זאת, צריך להגדיר את includeTabsContent לערך true ולהשתמש ב-Link.heading לפעולות קריאה וכתיבה. שדה זה מוחזר רק כאשר includeTabsContent מוגדר לערך false במסמכים שמכילים כרטיסייה יחידה ומקשר לכותרת בתוך הכרטיסייה היחידה. אחרת, מוחזר Link.heading.

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

{
  "id": string,
  "tabId": string
}

string

המזהה של סימנייה במסמך הזה.

string

מזהה הכרטיסייה שמכילה את הסימנייה הזו.

{
  "id": string,
  "tabId": string
}

string

המזהה של כותרת במסמך הזה.

string

מזהה הכרטיסייה שמכילה את הכותרת הזו.

{
  "textStyle": {
    object (TextStyle)
  },
  "textStyleSuggestionState": {
    object (TextStyleSuggestionState)
  }
}

object (TextStyle)

TextStyle שכולל רק את השינויים שבוצעו בהצעה הזו. אפשר להשתמש בנתונים האלה ביחד עם textStyleSuggestionState כדי לראות אילו שדות השתנו והערכים החדשים שלהם.

object (TextStyleSuggestionState)

מסכה שמציינת אילו מהשדות בבסיס TextStyle השתנו בהצעה הזו.

{
  "boldSuggested": boolean,
  "italicSuggested": boolean,
  "underlineSuggested": boolean,
  "strikethroughSuggested": boolean,
  "smallCapsSuggested": boolean,
  "backgroundColorSuggested": boolean,
  "foregroundColorSuggested": boolean,
  "fontSizeSuggested": boolean,
  "weightedFontFamilySuggested": boolean,
  "baselineOffsetSuggested": boolean,
  "linkSuggested": boolean
}

boolean

מציין אם הייתה הצעה לשינוי ב-bold.

boolean

שדה זה מציין אם הוצע שינוי ל-italic.

boolean

שדה זה מציין אם הוצע שינוי ל-underline.

boolean

שדה זה מציין אם הוצע שינוי ל-strikethrough.

boolean

שדה זה מציין אם הוצע שינוי ל-smallCaps.

boolean

שדה זה מציין אם הוצע שינוי ל-backgroundColor.

boolean

מציין אם הייתה הצעה לשינוי ב-foregroundColor.

boolean

מציין אם הייתה הצעה לשינוי ב-fontSize.

boolean

שדה זה מציין אם הוצע שינוי ל-weightedFontFamily.

boolean

מציין אם הייתה הצעה לשינוי ב-baselineOffset.

boolean

מציין אם הייתה הצעה לשינוי ב-link.

{
  "type": enum (Type),
  "suggestedInsertionIds": [
    string
  ],
  "suggestedDeletionIds": [
    string
  ],
  "textStyle": {
    object (TextStyle)
  },
  "suggestedTextStyleChanges": {
    string: {
      object (SuggestedTextStyle)
    },
    ...
  }
}

enum (Type)

הסוג של טקסט אוטומטי זה.

string

מזהי ההוספה המוצעים. ב-AutoText יכולים להיות כמה מזהי הוספה, אם מדובר בהצעה לשינוי מקונן. אם השדה ריק, לא ניתן להשתמש בהצעה להזנה.

string

מזהי המחיקה המוצעים. אם השדה ריק, אין הצעות למחיקת התוכן.

object (TextStyle)

סגנון הטקסט של הטקסט האוטומטי הזה.

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

סגנון הטקסט המוצע ישתנה לטקסט האוטומטי הזה, לפי מפתח של מזהה ההצעה.

{
  "suggestedInsertionIds": [
    string
  ],
  "suggestedDeletionIds": [
    string
  ],
  "textStyle": {
    object (TextStyle)
  },
  "suggestedTextStyleChanges": {
    string: {
      object (SuggestedTextStyle)
    },
    ...
  }
}

string

המזהים המוצעים של המודעות. ל-PageBreak יכולים להיות כמה מזהי הוספה, אם מדובר בהצעה לשינוי מקונן. אם השדה ריק, לא ניתן להשתמש בהצעה להזנה.

string

מזהי המחיקה המוצעים. אם השדה ריק, אין הצעות למחיקה של התוכן.

object (TextStyle)

סגנון הטקסט של הפס ההפרדה הזה.

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

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

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

{
  "suggestedInsertionIds": [
    string
  ],
  "suggestedDeletionIds": [
    string
  ],
  "textStyle": {
    object (TextStyle)
  },
  "suggestedTextStyleChanges": {
    string: {
      object (SuggestedTextStyle)
    },
    ...
  }
}

string

המזהים המוצעים של המודעות. ל-ColumnBreak יכולים להיות כמה מזהי הוספה, אם מדובר בהצעה לשינוי מקונן. אם השדה ריק, זו לא הצעה להוספה.

string

מזהי המחיקה המוצעים. אם השדה ריק, אין הצעות למחיקה של התוכן.

object (TextStyle)

סגנון הטקסט של ה-ColumnBreak הזה.

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

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

סגנון הטקסט המוצע משתנה ל-ColumnBreak הזה, לפי המפתח של מזהה ההצעה.

{
  "footnoteId": string,
  "footnoteNumber": string,
  "suggestedInsertionIds": [
    string
  ],
  "suggestedDeletionIds": [
    string
  ],
  "textStyle": {
    object (TextStyle)
  },
  "suggestedTextStyleChanges": {
    string: {
      object (SuggestedTextStyle)
    },
    ...
  }
}

string

המזהה של footnote שמכיל את התוכן של ההפניה להערת שוליים.

string

המספר של הערת השוליים הזו לאחר עיבוד.

string

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

string

מזהי המחיקה המוצעים. אם השדה הזה ריק, אין הצעות למחיקת התוכן הזה.

object (TextStyle)

סגנון הטקסט של FootnoteReference הזה.

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

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

{
  "suggestedInsertionIds": [
    string
  ],
  "suggestedDeletionIds": [
    string
  ],
  "textStyle": {
    object (TextStyle)
  },
  "suggestedTextStyleChanges": {
    string: {
      object (SuggestedTextStyle)
    },
    ...
  }
}

string

מזהי ההוספה המוצעים. ל-HorizontalRule יכולים להיות מספר מזהי הטמעה אם מדובר בהצעת שינוי בתצוגת עץ. אם השדה ריק, זו לא הצעה להוספה.

string

מזהי המחיקה המוצעים. אם השדה הזה ריק, אין הצעות למחיקת התוכן הזה.

object (TextStyle)

סגנון הטקסט של הכלל האופקי הזה.

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

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

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

{
  "suggestedInsertionIds": [
    string
  ],
  "suggestedDeletionIds": [
    string
  ]
}

string

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

string

מזהי המחיקה המוצעים. אם השדה ריק, אין הצעות למחיקת התוכן.

{
  "inlineObjectId": string,
  "suggestedInsertionIds": [
    string
  ],
  "suggestedDeletionIds": [
    string
  ],
  "textStyle": {
    object (TextStyle)
  },
  "suggestedTextStyleChanges": {
    string: {
      object (SuggestedTextStyle)
    },
    ...
  }
}

string

המזהה של InlineObject שהרכיב הזה מכיל.

string

מזהי ההוספה המוצעים. ל-InlineObjectElement יכולים להיות מספר מזהי הטמעה אם מדובר בהצעת שינוי בתצוגת עץ. אם השדה ריק, זו לא הצעה להוספה.

string

מזהי המחיקה המוצעים. אם השדה הזה ריק, אין הצעות למחיקת התוכן הזה.

object (TextStyle)

סגנון הטקסט של InlineObjectElement הזה.

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

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

סגנון הטקסט המוצע ישתנה ל-InlineObject הזה, עם מפתח לפי מזהה ההצעה.

{
  "personId": string,
  "suggestedInsertionIds": [
    string
  ],
  "suggestedDeletionIds": [
    string
  ],
  "textStyle": {
    object (TextStyle)
  },
  "suggestedTextStyleChanges": {
    string: {
      object (SuggestedTextStyle)
    },
    ...
  },
  "personProperties": {
    object (PersonProperties)
  }
}

string

פלט בלבד. המזהה הייחודי של הקישור הזה.

string

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

string

מזהים של הצעות להסרת הקישור לאדם הזה מהמסמך. ל-Person יכולים להיות כמה מזהי מחיקה, אם, לדוגמה, כמה משתמשים מציעים למחוק אותו. אם השדה ריק, הקישור למשתמש הזה לא מוצע למחיקה.

object (TextStyle)

סגנון הטקסט של Person הזה.

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

סגנון הטקסט המוצע ישתנה ל-Person הזה, לפי מפתח של מזהה ההצעה.

object (PersonProperties)

פלט בלבד. המאפיינים של Person. השדה הזה תמיד מוצג.

{
  "name": string,
  "email": string
}

string

פלט בלבד. השם של האדם, אם הוא מוצג בטקסט של הקישור במקום כתובת האימייל שלו.

string

פלט בלבד. כתובת האימייל שמקושרת ל-Person הזה. השדה הזה תמיד מוצג.

{
  "richLinkId": string,
  "suggestedInsertionIds": [
    string
  ],
  "suggestedDeletionIds": [
    string
  ],
  "textStyle": {
    object (TextStyle)
  },
  "suggestedTextStyleChanges": {
    string: {
      object (SuggestedTextStyle)
    },
    ...
  },
  "richLinkProperties": {
    object (RichLinkProperties)
  }
}

string

פלט בלבד. המזהה של הקישור הזה.

string

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

string

המזהים של ההצעות להסרת הקישור הזה מהמסמך. יכול להיות של-RichLink יהיו כמה מזהי מחיקה אם, לדוגמה, כמה משתמשים מציעים למחוק אותו. אם השדה ריק, המערכת לא תציע למחוק את הקישור לאותו אדם.

object (TextStyle)

סגנון הטקסט של RichLink.

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

סגנון הטקסט המוצע ישתנה ל-RichLink הזה, לפי מפתח של מזהה ההצעה.

object (RichLinkProperties)

פלט בלבד. המאפיינים של ה-RichLink הזה. השדה הזה תמיד מוצג.

{
  "title": string,
  "uri": string,
  "mimeType": string
}

string

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

string

פלט בלבד. ה-URI ל-RichLink. השדה הזה תמיד קיים.

string

פלט בלבד. סוג ה-MIME של ה-RichLink, אם יש כזה (לדוגמה, כשמדובר בקובץ ב-Drive).

{
  "headingId": string,
  "namedStyleType": enum (NamedStyleType),
  "alignment": enum (Alignment),
  "lineSpacing": number,
  "direction": enum (ContentDirection),
  "spacingMode": enum (SpacingMode),
  "spaceAbove": {
    object (Dimension)
  },
  "spaceBelow": {
    object (Dimension)
  },
  "borderBetween": {
    object (ParagraphBorder)
  },
  "borderTop": {
    object (ParagraphBorder)
  },
  "borderBottom": {
    object (ParagraphBorder)
  },
  "borderLeft": {
    object (ParagraphBorder)
  },
  "borderRight": {
    object (ParagraphBorder)
  },
  "indentFirstLine": {
    object (Dimension)
  },
  "indentStart": {
    object (Dimension)
  },
  "indentEnd": {
    object (Dimension)
  },
  "tabStops": [
    {
      object (TabStop)
    }
  ],
  "keepLinesTogether": boolean,
  "keepWithNext": boolean,
  "avoidWidowAndOrphan": boolean,
  "shading": {
    object (Shading)
  },
  "pageBreakBefore": boolean
}

string

מזהה הכותרת של הפסקה. אם השדה ריק, הפסקה הזו אינה כותרת.

הנכס הזה הוא לקריאה בלבד.

enum (NamedStyleType)

סוג הסגנון של הפסקה, בעל השם.

מאחר שעדכון סוג הסגנון המוגדר בשם משפיע על מאפיינים אחרים ב-ParagraphStyle, סוג הסגנון המוגדר בשם מוחל לפני ששאר המאפיינים מתעדכנים.

enum (Alignment)

יישור הטקסט בפסקה הזו.

number

כמות הרווח בין השורות, כאחוז מהנורמלי, כאשר הערך הרגיל מיוצג באמצעות 100.0. אם הערך לא מוגדר, הוא עובר בירושה מההורה.

enum (ContentDirection)

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

enum (SpacingMode)

מצב הריווח בין הפסקה.

object (Dimension)

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

object (Dimension)

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

object (ParagraphBorder)

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

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

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

object (ParagraphBorder)

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

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

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

object (ParagraphBorder)

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

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

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

object (ParagraphBorder)

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

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

object (ParagraphBorder)

הגבול מימין לפיסקה זו. אם הערך לא מוגדר, הוא עובר בירושה מההורה.

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

object (Dimension)

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

object (Dimension)

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

object (Dimension)

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

object (TabStop)

רשימה של עגילי התאמת הטקסט לפסיק בפסקה הזו. הרשימה של עצירות הטאב לא עוברת בירושה.

הנכס הזה הוא לקריאה בלבד.

boolean

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

boolean

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

boolean

האם להימנע מאלמונים ויתומים בפסקה. אם הערך לא מוגדר, הוא עובר בירושה מההורה.

object (Shading)

ההצללה של הפסקה. אם הערך לא מוגדר, הוא עובר בירושה מההורה.

boolean

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

ניסיון לעדכן את pageBreakBefore בקטעים באזורים שלא נתמכים, כולל Table,‏ Header,‏ Footer ו-Footnote, עלול לגרום למצב מסמך לא חוקי שיחזיר את השגיאה 400 Bad Request.

{
  "color": {
    object (OptionalColor)
  },
  "width": {
    object (Dimension)
  },
  "padding": {
    object (Dimension)
  },
  "dashStyle": enum (DashStyle)
}

object (OptionalColor)

צבע הגבול.

object (Dimension)

רוחב הגבול.

object (Dimension)

המרווח הפנימי של הגבול.

enum (DashStyle)

סגנון המקף של הגבול.

{
  "offset": {
    object (Dimension)
  },
  "alignment": enum (TabStopAlignment)
}

object (Dimension)

ההזזה בין עצור הכרטיסייה הזה לבין שולי ההתחלה.

enum (TabStopAlignment)

היישור של עצירת הטאב הזו. אם המדיניות לא מוגדרת, ערך ברירת המחדל הוא START.

{
  "backgroundColor": {
    object (OptionalColor)
  }
}

object (OptionalColor)

צבע הרקע של ההצללה של הפסקה הזו.

{
  "paragraphStyle": {
    object (ParagraphStyle)
  },
  "paragraphStyleSuggestionState": {
    object (ParagraphStyleSuggestionState)
  }
}

object (ParagraphStyle)

קובץ ParagraphStyle שכולל רק את השינויים שבוצעו בהצעה הזו. אפשר להשתמש בנתונים האלה ביחד עם paragraphStyleSuggestionState כדי לראות אילו שדות השתנו והערכים החדשים שלהם.

object (ParagraphStyleSuggestionState)

מסכה שמציינת אילו מהשדות בבסיס ParagraphStyle השתנו בהצעה הזו.

{
  "headingIdSuggested": boolean,
  "namedStyleTypeSuggested": boolean,
  "alignmentSuggested": boolean,
  "lineSpacingSuggested": boolean,
  "directionSuggested": boolean,
  "spacingModeSuggested": boolean,
  "spaceAboveSuggested": boolean,
  "spaceBelowSuggested": boolean,
  "borderBetweenSuggested": boolean,
  "borderTopSuggested": boolean,
  "borderBottomSuggested": boolean,
  "borderLeftSuggested": boolean,
  "borderRightSuggested": boolean,
  "indentFirstLineSuggested": boolean,
  "indentStartSuggested": boolean,
  "indentEndSuggested": boolean,
  "keepLinesTogetherSuggested": boolean,
  "keepWithNextSuggested": boolean,
  "avoidWidowAndOrphanSuggested": boolean,
  "shadingSuggestionState": {
    object (ShadingSuggestionState)
  },
  "pageBreakBeforeSuggested": boolean
}

boolean

מציין אם הייתה הצעה לשינוי ב-headingId.

boolean

שדה זה מציין אם הוצע שינוי ל-namedStyleType.

boolean

שדה זה מציין אם הוצע שינוי ל-alignment.

boolean

מציין אם הייתה הצעה לשינוי ב-lineSpacing.

boolean

שדה זה מציין אם הוצע שינוי ל-direction.

boolean

שדה זה מציין אם הוצע שינוי ל-spacingMode.

boolean

שדה זה מציין אם הוצע שינוי ל-spaceAbove.

boolean

מציין אם הייתה הצעה לשינוי ב-spaceBelow.

boolean

מציין אם הייתה הצעה לשינוי ב-borderBetween.

boolean

מציין אם הייתה הצעה לשינוי ב-borderTop.

boolean

שדה זה מציין אם הוצע שינוי ל-borderBottom.

boolean

מציין אם הייתה הצעה לשינוי ב-borderLeft.

boolean

מציין אם הייתה הצעה לשינוי ב-borderRight.

boolean

מציין אם הייתה הצעה לשינוי ב-indentFirstLine.

boolean

מציין אם הייתה הצעה לשינוי ב-indentStart.

boolean

מציין אם הייתה הצעה לשינוי ב-indentEnd.

boolean

מציין אם הייתה הצעה לשינוי ב-keepLinesTogether.

boolean

שדה זה מציין אם הוצע שינוי ל-keepWithNext.

boolean

שדה זה מציין אם הוצע שינוי ל-avoidWidowAndOrphan.

object (ShadingSuggestionState)

מסכה שמציינת אילו מהשדות ב-shading השתנו בהצעה הזו.

boolean

שדה זה מציין אם הוצע שינוי ל-pageBreakBefore.

{
  "backgroundColorSuggested": boolean
}

boolean

מציין אם הייתה הצעה לשינוי ב-Shading.

{
  "listId": string,
  "nestingLevel": integer,
  "textStyle": {
    object (TextStyle)
  }
}

string

המזהה של הרשימה שאליה שייכת הפיסקה הזו.

integer

רמת הסידור הפנימי של הפסקה הזו ברשימה.

object (TextStyle)

סגנון הטקסט הספציפי לפסקה שהוחל על הנקודה הזו.

{
  "bullet": {
    object (Bullet)
  },
  "bulletSuggestionState": {
    object (BulletSuggestionState)
  }
}

object (Bullet)

Bullet שכולל רק את השינויים שבוצעו בהצעה הזו. אפשר להשתמש באפשרות הזו יחד עם bulletSuggestionState כדי לראות אילו שדות השתנו ואת הערכים החדשים שלהם.

object (BulletSuggestionState)

מסכה שמציינת אילו מהשדות בבסיס Bullet השתנו בהצעה הזו.

{
  "listIdSuggested": boolean,
  "nestingLevelSuggested": boolean,
  "textStyleSuggestionState": {
    object (TextStyleSuggestionState)
  }
}

boolean

שדה זה מציין אם הוצע שינוי ב-listId.

boolean

מציין אם הייתה הצעה לשינוי ב-nestingLevel.

object (TextStyleSuggestionState)

מסכה שמציינת אילו מהשדות ב-text style השתנו בהצעה הזו.

{
  "objectIds": [
    string
  ]
}

string

מזהי האובייקטים

{
  "suggestedInsertionIds": [
    string
  ],
  "suggestedDeletionIds": [
    string
  ],
  "sectionStyle": {
    object (SectionStyle)
  }
}

string

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

string

מזהי המחיקה המוצעים. אם השדה ריק, אין הצעות למחיקת התוכן.

object (SectionStyle)

הסגנון של הקטע אחרי ההפסקה הזו.

{
  "columnProperties": [
    {
      object (SectionColumnProperties)
    }
  ],
  "columnSeparatorStyle": enum (ColumnSeparatorStyle),
  "contentDirection": enum (ContentDirection),
  "marginTop": {
    object (Dimension)
  },
  "marginBottom": {
    object (Dimension)
  },
  "marginRight": {
    object (Dimension)
  },
  "marginLeft": {
    object (Dimension)
  },
  "marginHeader": {
    object (Dimension)
  },
  "marginFooter": {
    object (Dimension)
  },
  "sectionType": enum (SectionType),
  "defaultHeaderId": string,
  "defaultFooterId": string,
  "firstPageHeaderId": string,
  "firstPageFooterId": string,
  "evenPageHeaderId": string,
  "evenPageFooterId": string,
  "useFirstPageHeaderFooter": boolean,
  "pageNumberStart": integer,
  "flipPageOrientation": boolean
}

object (SectionColumnProperties)

מאפייני העמודות של הקטע.

אם השדה ריק, הקטע מכיל עמודה אחת עם מאפייני ברירת המחדל בעורך Docs. אפשר לעדכן קטע כך שיכלול עד 3 עמודות.

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

enum (ColumnSeparatorStyle)

הסגנון של תווי הפרדה בין עמודות.

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

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

enum (ContentDirection)

כיוון התוכן של הקטע הזה. אם לא מגדירים את הערך, ערך ברירת המחדל הוא LEFT_TO_RIGHT.

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

object (Dimension)

שוליים העליונים של הדף בקטע. אם לא מוגדר, ערך ברירת המחדל הוא marginTop מ-DocumentStyle.

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

object (Dimension)

השוליים התחתונים של הדף בקטע. אם לא מגדירים ערך, הערך שמוגדר כברירת מחדל הוא marginBottom מ-DocumentStyle.

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

object (Dimension)

שוליים הדף הימני של הקטע. אם לא מוגדר, ערך ברירת המחדל הוא marginRight מ-DocumentStyle. עדכון השוליים הימניים גורם לשינוי הגודל של העמודות בקטע הזה. השוליים משפיעים על רוחב העמודות, ולכן הוא מיושם לפני מאפייני העמודות.

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

object (Dimension)

השוליים השמאליים של הדף בקטע. אם לא מוגדר, ערך ברירת המחדל הוא marginLeft מ-DocumentStyle. עדכון השוליים השמאליים גורם לשינוי הגודל של העמודות בקטע הזה. השוליים משפיעים על רוחב העמודות, ולכן הוא מיושם לפני מאפייני העמודות.

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

object (Dimension)

השוליים של הכותרת העליונה של הקטע. אם לא מוגדר, ערך ברירת המחדל הוא marginHeader מ-DocumentStyle. אם המדיניות עודכנה, useCustomHeaderFooterMargins מוגדר כ-True ב-DocumentStyle. הערך של useCustomHeaderFooterMargins ב-DocumentStyle מציין אם המערכת מתייחסת לשוליים של הכותרת בקטע הזה.

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

object (Dimension)

השוליים של הכותרת התחתונה של הקטע. אם לא מגדירים ערך, הערך שמוגדר כברירת מחדל הוא marginFooter מ-DocumentStyle. אם המאפיין עודכן, הערך של useCustomHeaderFooterMargins מוגדר כ-true ב-DocumentStyle. הערך של useCustomHeaderFooterMargins ב-DocumentStyle מציין אם הוגדר שימוש בשוליים של הכותרת התחתונה עבור הקטע הזה

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

enum (SectionType)

פלט בלבד. סוג הקטע.

string

המזהה של הכותרת שמוגדרת כברירת מחדל. אם לא מגדירים את הערך, הוא עובר בירושה מה-SectionStyle הקודם של SectionBreak's. אם הערך לא מוגדר בקטע ה-sectionBreak הראשון, הוא יורש את המאפיין defaultHeaderId של DocumentStyle.

הנכס הזה הוא לקריאה בלבד.

string

המזהה של הכותרת התחתונה המוגדרת כברירת המחדל. אם המדיניות לא מוגדרת, הערך עובר בירושה מסגנון המדור הקודם של SectionBreak's. אם הערך לא מוגדר ב-SectionBreak הראשון, הוא עובר בירושה מ-defaultFooterId של DocumentStyle.

הנכס הזה הוא לקריאה בלבד.

string

המזהה של הכותרת שמשמש רק בדף הראשון של הקטע. אם הערך של useFirstPageHeaderFooter הוא true, המערכת תשתמש בערך הזה לכותרת בדף הראשון של הקטע. אם הערך הוא false, הכותרת בדף הראשון של הקטע תשתמש ב-defaultHeaderId. אם המדיניות לא מוגדרת, הערך עובר בירושה מסגנון המדור הקודם של SectionBreak's. אם הערך לא מוגדר ב-SectionBreak הראשון, הוא עובר בירושה מ-firstPageHeaderId של DocumentStyle.

הנכס הזה הוא לקריאה בלבד.

string

המזהה של הכותרת התחתונה שמיועדת רק לדף הראשון בקטע. אם הערך של useFirstPageHeaderFooter הוא true, המערכת תשתמש בערך הזה לכותרת התחתונה בדף הראשון של הקטע. אם הערך הוא false, הכותרת התחתונה בדף הראשון של הקטע תשתמש ב-defaultFooterId. אם המדיניות לא מוגדרת, הערך עובר בירושה מסגנון המדור הקודם של SectionBreak's. אם הערך לא מוגדר בקטע ה-sectionBreak הראשון, הוא יורש את המאפיין firstPageFooterId של DocumentStyle.

הנכס הזה הוא לקריאה בלבד.

string

מזהה הכותרת שמשמשת רק לדפים זוגיים. אם הערך של useEvenPageHeaderFooter של DocumentStyle הוא True, ערך זה משמש עבור הכותרות בדפים זוגיים בקטע. אם הערך הוא false, הכותרות בדפים זוגיים ישתמשו ב-defaultHeaderId. אם לא מגדירים את הערך, הוא עובר בירושה מה-SectionStyle הקודם של SectionBreak's. אם הערך לא מוגדר בקטע ה-sectionBreak הראשון, הוא יורש את המאפיין evenPageHeaderId של DocumentStyle.

הנכס הזה הוא לקריאה בלבד.

string

המזהה של הכותרת התחתונה שמשמש רק בדפים זוגיים. אם הערך של useEvenPageHeaderFooter של DocumentStyle הוא true, המערכת משתמשת בערך הזה בכותרות התחתונות בדפים הזוגיים בקטע. אם הערך הוא false, הכותרות התחתונות בדפים זוגיים ישתמשו ב-defaultFooterId. אם המדיניות לא מוגדרת, הערך עובר בירושה מסגנון המדור הקודם של SectionBreak's. אם הערך לא מוגדר ב-SectionBreak הראשון, הוא עובר בירושה מ-evenPageFooterId של DocumentStyle.

הנכס הזה הוא לקריאה בלבד.

boolean

מציין אם להשתמש במזהים של הכותרת העליונה / הכותרת התחתונה בדף הראשון של הקטע. אם לא מגדירים אותו, הוא עובר בירושה מ-useFirstPageHeaderFooter של DocumentStyle עבור הקטע הראשון. אם הערך לא מוגדר בקטעים הבאים, צריך לפרש אותו כ-false.

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

integer

מספר הדף שממנו מתחילים לספור את מספר הדפים בקטע הזה. אם לא מגדירים את הפרמטר, מספור הדפים ממשיך מהקטע הקודם. אם הערך לא מוגדר ב-SectionBreak הראשונים, יש לעיין ב-pageNumberStart של DocumentStyle.

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

boolean

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

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

{
  "width": {
    object (Dimension)
  },
  "paddingEnd": {
    object (Dimension)
  }
}

object (Dimension)

פלט בלבד. רוחב העמודה.

object (Dimension)

המרווח הפנימי בסוף העמודה.

{
  "rows": integer,
  "columns": integer,
  "tableRows": [
    {
      object (TableRow)
    }
  ],
  "suggestedInsertionIds": [
    string
  ],
  "suggestedDeletionIds": [
    string
  ],
  "tableStyle": {
    object (TableStyle)
  }
}

integer

מספר השורות בטבלה.

integer

מספר העמודות בטבלה.

טבלה יכולה להיות לא מלבנית, ולכן בחלק מהשורות מספר התאים שונה.

object (TableRow)

התוכן והסגנון של כל שורה.

string

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

string

מזהי המחיקה המוצעים. אם השדה הזה ריק, אין הצעות למחיקת התוכן הזה.

object (TableStyle)

הסגנון של הטבלה.

{
  "startIndex": integer,
  "endIndex": integer,
  "tableCells": [
    {
      object (TableCell)
    }
  ],
  "suggestedInsertionIds": [
    string
  ],
  "suggestedDeletionIds": [
    string
  ],
  "tableRowStyle": {
    object (TableRowStyle)
  },
  "suggestedTableRowStyleChanges": {
    string: {
      object (SuggestedTableRowStyle)
    },
    ...
  }
}

integer

אינדקס ההתחלה של השורה הזו, שמתחיל באפס, ביחידות קוד UTF-16.

integer

אינדקס הקצה מבוסס אפס של שורה זו, בלעדי, ביחידות קוד UTF-16.

object (TableCell)

התוכן והסגנון של כל תא בשורה הזו.

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

string

המזהים המוצעים של המודעות. ל-TableRow יכולים להיות כמה מזהי הוספה, אם מדובר בהצעה לשינוי מקונן. אם השדה ריק, זו לא הצעה להוספה.

string

מזהי המחיקה המוצעים. אם השדה ריק, אין הצעות למחיקה של התוכן.

object (TableRowStyle)

הסגנון של השורה בטבלה.

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

הסגנון שהוצעה משתנה לשורה הזו, לפי מפתח של מזהה ההצעה.

{
  "startIndex": integer,
  "endIndex": integer,
  "content": [
    {
      object (StructuralElement)
    }
  ],
  "tableCellStyle": {
    object (TableCellStyle)
  },
  "suggestedInsertionIds": [
    string
  ],
  "suggestedDeletionIds": [
    string
  ],
  "suggestedTableCellStyleChanges": {
    string: {
      object (SuggestedTableCellStyle)
    },
    ...
  }
}

integer

אינדקס ההתחלה של התא הזה, שמתחיל באפס, ביחידות קוד UTF-16.

integer

אינדקס הקצה מבוסס אפס של התא הזה, בלעדי, ביחידות קוד UTF-16.

object (StructuralElement)

התוכן של התא.

object (TableCellStyle)

הסגנון של התא.

string

מזהי ההוספה המוצעים. ל-TableCell יכולים להיות כמה מזהי הוספה, אם מדובר בהצעה לשינוי מקונן. אם השדה ריק, לא ניתן להשתמש בהצעה להזנה.

string

מזהי המחיקה המוצעים. אם השדה הזה ריק, אין הצעות למחיקת התוכן הזה.

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

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

{
  "rowSpan": integer,
  "columnSpan": integer,
  "backgroundColor": {
    object (OptionalColor)
  },
  "borderLeft": {
    object (TableCellBorder)
  },
  "borderRight": {
    object (TableCellBorder)
  },
  "borderTop": {
    object (TableCellBorder)
  },
  "borderBottom": {
    object (TableCellBorder)
  },
  "paddingLeft": {
    object (Dimension)
  },
  "paddingRight": {
    object (Dimension)
  },
  "paddingTop": {
    object (Dimension)
  },
  "paddingBottom": {
    object (Dimension)
  },
  "contentAlignment": enum (ContentAlignment)
}

integer

טווח השורה של התא.

הנכס הזה הוא לקריאה בלבד.

integer

היקף העמודות של התא.

הנכס הזה הוא לקריאה בלבד.

object (OptionalColor)

צבע הרקע של התא.

object (TableCellBorder)

הגבול השמאלי של התא.

object (TableCellBorder)

הגבול הימני של התא.

object (TableCellBorder)

הגבול העליון של התא.

object (TableCellBorder)

הגבול התחתון של התא.

object (Dimension)

המרווח הפנימי השמאלי של התא.

object (Dimension)

המרווח הפנימי הימני של התא.

object (Dimension)

המרווח הפנימי העליון של התא.

object (Dimension)

הריווח התחתון של התא.

enum (ContentAlignment)

היישור של התוכן בתא הטבלה. יישור ברירת המחדל תואם ליישור של תאים חדשים בטבלה שנוצרו בעורך Docs.

{
  "color": {
    object (OptionalColor)
  },
  "width": {
    object (Dimension)
  },
  "dashStyle": enum (DashStyle)
}

object (OptionalColor)

צבע הגבול.

הצבע הזה לא יכול להיות שקוף.

object (Dimension)

רוחב הגבול.

enum (DashStyle)

סגנון המקף של הגבול.

{
  "tableCellStyle": {
    object (TableCellStyle)
  },
  "tableCellStyleSuggestionState": {
    object (TableCellStyleSuggestionState)
  }
}

object (TableCellStyle)

TableCellStyle שכולל רק את השינויים שבוצעו בהצעה הזו. אפשר להשתמש באפשרות הזו יחד עם tableCellStyleSuggestionState כדי לראות אילו שדות השתנו ואת הערכים החדשים שלהם.

object (TableCellStyleSuggestionState)

מסכה שמציינת אילו מהשדות בבסיס TableCellStyle השתנו בהצעה הזו.

{
  "rowSpanSuggested": boolean,
  "columnSpanSuggested": boolean,
  "backgroundColorSuggested": boolean,
  "borderLeftSuggested": boolean,
  "borderRightSuggested": boolean,
  "borderTopSuggested": boolean,
  "borderBottomSuggested": boolean,
  "paddingLeftSuggested": boolean,
  "paddingRightSuggested": boolean,
  "paddingTopSuggested": boolean,
  "paddingBottomSuggested": boolean,
  "contentAlignmentSuggested": boolean
}

boolean

שדה זה מציין אם הוצע שינוי ל-rowSpan.

boolean

מציין אם הייתה הצעה לשינוי ב-columnSpan.

boolean

שדה זה מציין אם הוצע שינוי ל-backgroundColor.

boolean

מציין אם הייתה הצעה לשינוי ב-borderLeft.

boolean

מציין אם הייתה הצעה לשינוי ב-borderRight.

boolean

מציין אם הייתה הצעה לשינוי ב-borderTop.

boolean

מציין אם הייתה הצעה לשינוי ב-borderBottom.

boolean

שדה זה מציין אם הוצע שינוי ל-paddingLeft.

boolean

מציין אם הייתה הצעה לשינוי ב-paddingRight.

boolean

שדה זה מציין אם הוצע שינוי ל-paddingTop.

boolean

שדה זה מציין אם הוצע שינוי ל-paddingBottom.

boolean

מציין אם הייתה הצעה לשינוי ב-contentAlignment.

{
  "minRowHeight": {
    object (Dimension)
  },
  "tableHeader": boolean,
  "preventOverflow": boolean
}

object (Dimension)

הגובה המינימלי של השורה. השורה תומרן בעורך של Docs בגובה שווה לערך הזה או גבוה ממנו, כדי להציג את כל התוכן בתאים של השורה.

boolean

האם השורה היא כותרת של טבלה.

boolean

אם השורה לא יכולה לגלוש מעבר לגבולות הדף או העמודה.

{
  "tableRowStyle": {
    object (TableRowStyle)
  },
  "tableRowStyleSuggestionState": {
    object (TableRowStyleSuggestionState)
  }
}

object (TableRowStyle)

קובץ TableRowStyle שכולל רק את השינויים שבוצעו בהצעה הזו. אפשר להשתמש בנתונים האלה ביחד עם tableRowStyleSuggestionState כדי לראות אילו שדות השתנו והערכים החדשים שלהם.

object (TableRowStyleSuggestionState)

מסכה שמציינת אילו מהשדות בבסיס TableRowStyle השתנו בהצעה הזו.

{
  "minRowHeightSuggested": boolean
}

boolean

מציין אם הייתה הצעה לשינוי ב-minRowHeight.

{
  "tableColumnProperties": [
    {
      object (TableColumnProperties)
    }
  ]
}

object (TableColumnProperties)

המאפיינים של כל עמודה.

שימו לב שב-Docs, טבלאות מכילות שורות ושורות מכילות תאים, בדומה ל-HTML. לכן, המאפיינים של שורה נמצאים ב-tableRowStyle של השורה.

{
  "widthType": enum (WidthType),
  "width": {
    object (Dimension)
  }
}

enum (WidthType)

סוג רוחב העמודה.

object (Dimension)

רוחב העמודה. מגדירים מתי הערך של widthType בעמודה הוא FIXED_WIDTH.

{
  "content": [
    {
      object (StructuralElement)
    }
  ],
  "suggestedInsertionIds": [
    string
  ],
  "suggestedDeletionIds": [
    string
  ]
}

object (StructuralElement)

התוכן של תוכן העניינים.

string

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

string

מזהי המחיקה המוצעים. אם השדה ריק, אין הצעות למחיקה של התוכן.

{
  "headerId": string,
  "content": [
    {
      object (StructuralElement)
    }
  ]
}

string

המזהה של הכותרת.

object (StructuralElement)

תוכן הכותרת.

האינדקסים של תוכן הכותרת מתחילים באפס.

{
  "footerId": string,
  "content": [
    {
      object (StructuralElement)
    }
  ]
}

string

המזהה של הכותרת התחתונה.

object (StructuralElement)

תוכן הכותרת התחתונה.

האינדקסים של תוכן כותרת תחתונה מתחילים באפס.

{
  "footnoteId": string,
  "content": [
    {
      object (StructuralElement)
    }
  ]
}

string

המזהה של הערת השוליים.

object (StructuralElement)

התוכן של הערת השוליים.

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

{
  "background": {
    object (Background)
  },
  "defaultHeaderId": string,
  "defaultFooterId": string,
  "evenPageHeaderId": string,
  "evenPageFooterId": string,
  "firstPageHeaderId": string,
  "firstPageFooterId": string,
  "useFirstPageHeaderFooter": boolean,
  "useEvenPageHeaderFooter": boolean,
  "pageNumberStart": integer,
  "marginTop": {
    object (Dimension)
  },
  "marginBottom": {
    object (Dimension)
  },
  "marginRight": {
    object (Dimension)
  },
  "marginLeft": {
    object (Dimension)
  },
  "pageSize": {
    object (Size)
  },
  "marginHeader": {
    object (Dimension)
  },
  "marginFooter": {
    object (Dimension)
  },
  "useCustomHeaderFooterMargins": boolean,
  "flipPageOrientation": boolean
}

object (Background)

הרקע של המסמך. לא ניתן להשתמש בצבע רקע שקוף במסמכים.

string

המזהה של כותרת ברירת המחדל. אם המדיניות לא מוגדרת, אין כותרת ברירת מחדל.

הנכס הזה הוא לקריאה בלבד.

string

המזהה של הכותרת התחתונה המוגדרת כברירת המחדל. אם המדיניות לא מוגדרת, אין כותרת תחתונה שתשמש כברירת מחדל.

הנכס הזה הוא לקריאה בלבד.

string

המזהה של הכותרת העליונה שמשמש רק בדפים זוגיים. הערך של useEvenPageHeaderFooter קובע אם להשתמש בערך defaultHeaderId או בערך הזה לגבי הכותרת בדפים זוגיים. אם המדיניות לא מוגדרת, אין כותרת עליונה בדף זוגי.

הנכס הזה הוא לקריאה בלבד.

string

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

הנכס הזה הוא לקריאה בלבד.

string

המזהה של הכותרת שמשמש רק לדף הראשון. אם לא תגדירו את השדה, לא תהיה כותרת ייחודית לדף הראשון. הערך של useFirstPageHeaderFooter קובע אם להשתמש ב-defaultHeaderId או בערך הזה לכותרת בדף הראשון. אם המדיניות לא מוגדרת, אין כותרת עליונה בדף הראשון.

הנכס הזה הוא לקריאה בלבד.

string

המזהה של הכותרת התחתונה המשמש רק לדף הראשון. אם המדיניות לא מוגדרת, לא קיימת כותרת תחתונה ייחודית לדף הראשון. הערך של useFirstPageHeaderFooter קובע אם להשתמש ב-defaultFooterId או בערך הזה בכותרת התחתונה בדף הראשון. אם לא תגדירו את השדה, לא תופיע כותרת תחתונה בדף הראשון.

הנכס הזה הוא לקריאה בלבד.

boolean

מציין אם להשתמש במזהי הכותרת העליונה או התחתונה של הדף הראשון בדף הראשון.

boolean

מציין אם להשתמש במזהים של כותרות / תחתונות בדפים זוגיים.

integer

מספר הדף שממנו יש להתחיל בספירת הדפים.

object (Dimension)

השוליים העליונים של הדף.

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

object (Dimension)

השוליים התחתונים של הדף.

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

object (Dimension)

שולי הדף הימני.

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

object (Dimension)

השוליים השמאליים של הדף.

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

object (Size)

גודל הדף במסמך.

object (Dimension)

הרווח בין החלק העליון של הדף לתוכן של הכותרת.

object (Dimension)

הרווח בין החלק התחתון של הדף לתוכן של הכותרת התחתונה.

boolean

מציין אם נעשה שימוש ב-DocumentStyle marginHeader, SegmentStyle marginHeader וב-DocumentStyle marginFooter, sectionStyle marginFooter. כשהערך הוא false, המערכת משתמשת בערכי ברירת המחדל של מרווח הכותרת והכותרת התחתונה בעורך Docs.

הנכס הזה הוא לקריאה בלבד.

boolean

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

{
  "color": {
    object (OptionalColor)
  }
}

object (OptionalColor)

צבע הרקע.