REST Resource: documents

Ressource: Dokument

Ein Google-Dokument.

JSON-Darstellung 
{
  "documentId": string,
  "title": string,
  "tabs": [
    {
      object (Tab)
    }
  ],
  "revisionId": string,
  "suggestionsViewMode": enum (SuggestionsViewMode),
  "commentsViewMode": enum (CommentsViewMode),
  "comments": [
    {
      object (CommentThread)
    }
  ],
  "suggestions": [
    {
      object (SuggestionThread)
    }
  ],
  "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)
    },
    ...
  }
}
Felder
documentId

string

Nur Ausgabe. Die ID des Dokuments.
title

string

Der Titel des Dokuments
tabs[]

object (Tab)

Nur Ausgabe. Tabs, die Teil eines Dokuments sind

Tabs können untergeordnete Tabs enthalten, d. h. Tabs, die in einem anderen Tab verschachtelt sind. Untergeordnete Tabs werden durch das Feld Tab.childTabs dargestellt.
revisionId

string

Nur Ausgabe. Die Versions-ID des Dokuments. Kann in Aktualisierungsanfragen verwendet werden, um anzugeben, auf welche Version eines Dokuments Aktualisierungen angewendet werden sollen und wie sich die Anfrage verhalten soll, wenn das Dokument seit dieser Version bearbeitet wurde. Wird nur angegeben, wenn der Nutzer Bearbeitungszugriff auf das Dokument hat.

Die Überarbeitungs-ID ist keine fortlaufende Nummer, sondern ein undurchsichtiger String. Das Format der Revisions-ID kann sich im Laufe der Zeit ändern. Eine zurückgegebene Revisions-ID ist nur 24 Stunden nach der Rückgabe gültig und kann nicht für mehrere Nutzer freigegeben werden. Wenn die Überarbeitungs-ID zwischen den Aufrufen unverändert ist, hat sich das Dokument nicht geändert. Eine geänderte ID (für dasselbe Dokument und denselben Nutzer) bedeutet in der Regel, dass das Dokument aktualisiert wurde. Eine geänderte ID kann jedoch auch auf interne Faktoren wie Änderungen des ID-Formats zurückzuführen sein.
suggestionsViewMode

enum (SuggestionsViewMode)

Nur Ausgabe. Der auf das Dokument angewendete Vorschlagsansichtsmodus.

Hinweis: Wenn Sie ein Dokument bearbeiten, müssen die Änderungen auf einem Dokument mit SUGGESTIONS_INLINE basieren.
commentsViewMode

enum (CommentsViewMode)

Nur Ausgabe. Der auf das Dokument angewendete Ansichtsmodus für Kommentare.
comments[]

object (CommentThread)

Nur Ausgabe. Die mit dem Dokument verknüpften Kommentare. Wird nur ausgefüllt, wenn für den Parameter commentsViewMode Kommentare erforderlich sind (z. B. COMMENTS_VIEW_MODE_INCLUDED).
suggestions[]

object (SuggestionThread)

Nur Ausgabe. Die mit dem Dokument verknüpften Vorschläge. Wird nur ausgefüllt, wenn für den Parameter commentsViewMode Kommentare erforderlich sind (z. B. COMMENTS_VIEW_MODE_INCLUDED).
body

object (Body)

Nur Ausgabe. Der Hauptteil des Dokuments.

Altes Feld: Verwenden Sie stattdessen Document.tabs.documentTab.body. Damit wird der tatsächliche Dokumentinhalt von allen Tabs verfügbar gemacht, wenn der Parameter includeTabsContent auf true gesetzt ist. Wenn false oder nicht festgelegt, enthält dieses Feld Informationen zum ersten Tab im Dokument.
headers

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

Nur Ausgabe. Die Header im Dokument, die nach Header-ID sortiert sind.

Altes Feld: Verwenden Sie stattdessen Document.tabs.documentTab.headers. Damit wird der tatsächliche Dokumentinhalt von allen Tabs verfügbar gemacht, wenn der Parameter includeTabsContent auf true gesetzt ist. Wenn false oder nicht festgelegt, enthält dieses Feld Informationen zum ersten Tab im Dokument.
footers

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

Nur Ausgabe. Die Fußzeilen im Dokument, die nach Fußzeilen-ID sortiert sind.

Altes Feld: Verwenden Sie stattdessen Document.tabs.documentTab.footers. Damit wird der tatsächliche Dokumentinhalt von allen Tabs verfügbar gemacht, wenn der Parameter includeTabsContent auf true gesetzt ist. Wenn false oder nicht festgelegt, enthält dieses Feld Informationen zum ersten Tab im Dokument.
footnotes

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

Nur Ausgabe. Die Fußnoten im Dokument, die nach Fußnoten-ID sortiert sind.

Altes Feld: Verwenden Sie stattdessen Document.tabs.documentTab.footnotes. Damit wird der tatsächliche Dokumentinhalt von allen Tabs verfügbar gemacht, wenn der Parameter includeTabsContent auf true gesetzt ist. Wenn false oder nicht festgelegt, enthält dieses Feld Informationen zum ersten Tab im Dokument.
documentStyle

object (DocumentStyle)

Nur Ausgabe. Der Stil des Dokuments.

Altes Feld: Verwenden Sie stattdessen Document.tabs.documentTab.documentStyle. Damit wird der tatsächliche Dokumentinhalt von allen Tabs verfügbar gemacht, wenn der Parameter includeTabsContent auf true gesetzt ist. Wenn false oder nicht festgelegt, enthält dieses Feld Informationen zum ersten Tab im Dokument.
suggestedDocumentStyleChanges

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

Nur Ausgabe. Die vorgeschlagenen Änderungen am Stil des Dokuments, die nach Vorschlags-ID sortiert sind.

Altes Feld: Verwenden Sie stattdessen Document.tabs.documentTab.suggestedDocumentStyleChanges. Damit wird der tatsächliche Dokumentinhalt von allen Tabs verfügbar gemacht, wenn der Parameter includeTabsContent auf true gesetzt ist. Wenn false oder nicht festgelegt, enthält dieses Feld Informationen zum ersten Tab im Dokument.
namedStyles

object (NamedStyles)

Nur Ausgabe. Die benannten Formatvorlagen des Dokuments.

Altes Feld: Verwenden Sie stattdessen Document.tabs.documentTab.namedStyles. Damit wird der tatsächliche Dokumentinhalt von allen Tabs verfügbar gemacht, wenn der Parameter includeTabsContent auf true gesetzt ist. Wenn false oder nicht festgelegt, enthält dieses Feld Informationen zum ersten Tab im Dokument.
suggestedNamedStylesChanges

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

Nur Ausgabe. Die vorgeschlagenen Änderungen an den benannten Stilen des Dokuments, die nach Vorschlags-ID sortiert sind.

Altes Feld: Verwenden Sie stattdessen Document.tabs.documentTab.suggestedNamedStylesChanges. Damit wird der tatsächliche Dokumentinhalt von allen Tabs verfügbar gemacht, wenn der Parameter includeTabsContent auf true gesetzt ist. Wenn false oder nicht festgelegt, enthält dieses Feld Informationen zum ersten Tab im Dokument.
lists

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

Nur Ausgabe. Die Listen im Dokument, die nach Listen-ID sortiert sind.

Altes Feld: Verwenden Sie stattdessen Document.tabs.documentTab.lists. Damit wird der tatsächliche Dokumentinhalt von allen Tabs verfügbar gemacht, wenn der Parameter includeTabsContent auf true gesetzt ist. Wenn false oder nicht festgelegt, enthält dieses Feld Informationen zum ersten Tab im Dokument.
namedRanges

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

Nur Ausgabe. Die benannten Bereiche im Dokument, nach Namen sortiert.

Altes Feld: Verwenden Sie stattdessen Document.tabs.documentTab.namedRanges. Damit wird der tatsächliche Dokumentinhalt von allen Tabs verfügbar gemacht, wenn der Parameter includeTabsContent auf true gesetzt ist. Wenn false oder nicht festgelegt, enthält dieses Feld Informationen zum ersten Tab im Dokument.
inlineObjects

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

Nur Ausgabe. Die Inline-Objekte im Dokument, die nach Objekt-ID sortiert sind.

Altes Feld: Verwenden Sie stattdessen Document.tabs.documentTab.inlineObjects. Damit wird der tatsächliche Dokumentinhalt von allen Tabs verfügbar gemacht, wenn der Parameter includeTabsContent auf true gesetzt ist. Wenn false oder nicht festgelegt, enthält dieses Feld Informationen zum ersten Tab im Dokument.
positionedObjects

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

Nur Ausgabe. Die positionierten Objekte im Dokument, die nach Objekt-ID sortiert sind.

Altes Feld: Verwenden Sie stattdessen Document.tabs.documentTab.positionedObjects. Damit wird der tatsächliche Dokumentinhalt von allen Tabs verfügbar gemacht, wenn der Parameter includeTabsContent auf true gesetzt ist. Wenn false oder nicht festgelegt, enthält dieses Feld Informationen zum ersten Tab im Dokument.

Tabulatortaste

Ein Tab in einem Dokument.

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

  "documentTab": {
    object (DocumentTab)
  }
}
Felder
tabProperties

object (TabProperties)

Die Eigenschaften des Tabs, z. B. ID und Titel.
childTabs[]

object (Tab)

Die untergeordneten Tabs, die in diesem Tab enthalten sind.
Der Inhalt des Tabs. Im Folgenden finden Sie eine Liste von sich gegenseitig ausschließenden Feldern. In einer Antwort wird höchstens eines der Felder festgelegt:
documentTab

object (DocumentTab)

Ein Tab mit Dokumentinhalten wie Text und Bildern.
Ende der sich gegenseitig ausschließenden Felder.

TabProperties

Eigenschaften eines Tabs.

JSON-Darstellung 
{
  "tabId": string,
  "title": string,
  "parentTabId": string,
  "index": integer,
  "nestingLevel": integer,
  "iconEmoji": string
}
Felder
tabId

string

Die unveränderliche ID des Tabs.
title

string

Der für Nutzer sichtbare Name des Tabs.
parentTabId

string

Optional. Die ID des übergeordneten Tabs. Leer, wenn der aktuelle Tab ein Tab auf Stammebene ist, d. h., er hat keine übergeordneten Elemente.
index

integer

Der nullbasierte Index des Tabs im übergeordneten Element.
nestingLevel

integer

Nur Ausgabe. Die Tiefe des Tabs im Dokument. Die Tabs auf der Stammebene beginnen bei 0.
iconEmoji

string

Optional. Das Emojisymbol, das mit dem Tab angezeigt wird. Ein gültiges Emoji-Symbol wird durch einen nicht leeren Unicode-String dargestellt. Jede Gruppe von Zeichen, die kein einzelnes Emoji darstellt, ist ungültig.

Wenn ein Emoji ungültig ist, wird ein 400-Fehler („Bad Request“) zurückgegeben.

Wenn dieser Wert nicht festgelegt oder leer ist, wird auf dem Tab das Standardsymbol angezeigt.

DocumentTab

Ein Tab mit Dokumentinhalten.

JSON-Darstellung 
{
  "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)
    },
    ...
  },
  "commentAnchors": {
    string: {
      object (CommentAnchor)
    },
    ...
  }
}
Felder
body

object (Body)

Der Hauptteil des Dokument-Tabs.
headers

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

Die Header auf dem Dokument-Tab, die nach Header-ID sortiert sind.
footers

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

Die Fußzeilen auf dem Dokument-Tab, die nach Fußzeilen-ID sortiert sind.
footnotes

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

Die Fußnoten auf dem Dokument-Tab, die nach Fußnoten-ID sortiert sind.
documentStyle

object (DocumentStyle)

Der Stil des Dokument-Tabs.
suggestedDocumentStyleChanges

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

Die vorgeschlagenen Änderungen am Stil des Dokument-Tabs, die nach Vorschlags-ID sortiert sind.
namedStyles

object (NamedStyles)

Die benannten Formatvorlagen des Dokument-Tabs.
suggestedNamedStylesChanges

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

Die vorgeschlagenen Änderungen an den benannten Stilen des Dokument-Tabs, die nach Vorschlags-ID sortiert sind.
lists

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

Die Listen auf dem Dokument-Tab, die nach Listen-ID sortiert sind.
namedRanges

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

Die benannten Bereiche auf dem Dokument-Tab, nach Namen sortiert.
inlineObjects

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

Die Inline-Objekte auf dem Dokument-Tab, die nach Objekt-ID sortiert sind.
positionedObjects

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

Die positionierten Objekte auf dem Dokument-Tab, die nach Objekt-ID sortiert sind.
commentAnchors

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

Die Kommentaranker auf einem Dokument-Tab, die nach Anker-ID sortiert sind. Wird nur ausgefüllt, wenn für den Parameter commentsViewMode Kommentare erforderlich sind (z. B. COMMENTS_VIEW_MODE_INCLUDED).

Text

Der Text des Dokuments.

Der Textkörper enthält in der Regel den vollständigen Dokumentinhalt, mit Ausnahme von headers, footers und footnotes.

JSON-Darstellung 
{
  "content": [
    {
      object (StructuralElement)
    }
  ]
}
Felder
content[]

object (StructuralElement)

Der Inhalt des Textkörpers.

Die Indexierung des Inhalts des Hauptteils beginnt bei null.

StructuralElement

Ein StructuralElement beschreibt Inhalte, die dem Dokument Struktur verleihen.

JSON-Darstellung 
{
  "startIndex": integer,
  "endIndex": integer,

  "paragraph": {
    object (Paragraph)
  },
  "sectionBreak": {
    object (SectionBreak)
  },
  "table": {
    object (Table)
  },
  "tableOfContents": {
    object (TableOfContents)
  }
}
Felder
startIndex

integer

Der nullbasierte Startindex dieses Strukturelements in UTF-16-Codeeinheiten.
endIndex

integer

Der nullbasierte Endindex dieses Strukturelements (exklusiv) in UTF-16-Codeeinheiten.
Der Inhalt des Strukturelements. Im Folgenden finden Sie eine Liste von sich gegenseitig ausschließenden Feldern. In einer Antwort wird höchstens eines der Felder festgelegt:
paragraph

object (Paragraph)

Ein strukturelles Element vom Typ „Absatz“.
sectionBreak

object (SectionBreak)

Ein strukturelles Element vom Typ „Abschnittsumbruch“.
table

object (Table)

Ein Tabellentyp von strukturellem Element.
tableOfContents

object (TableOfContents)

Ein strukturelles Element vom Typ „Inhaltsverzeichnis“.
Ende der sich gegenseitig ausschließenden Felder.

Absatz

Ein StructuralElement, das einen Absatz darstellt. Ein Absatz ist ein Bereich mit Inhalt, der mit einem Zeilenumbruchzeichen endet.

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

object (ParagraphElement)

Der Inhalt des Absatzes, aufgeschlüsselt in seine Bestandteile.
paragraphStyle

object (ParagraphStyle)

Der Stil dieses Absatzes.
suggestedParagraphStyleChanges

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

Die vorgeschlagenen Änderungen am Absatzstil für diesen Absatz, die durch die Vorschlags-ID gekennzeichnet sind.
bullet

object (Bullet)

Das Aufzählungszeichen für diesen Absatz. Wenn nicht vorhanden, gehört der Absatz nicht zu einer Liste.
suggestedBulletChanges

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

Die vorgeschlagenen Änderungen am Aufzählungszeichen dieses Absatzes.
positionedObjectIds[]

string

Die IDs der positionierten Objekte, die an diesen Absatz angehängt sind.
suggestedPositionedObjectIds

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

Die IDs der positionierten Objekte, die an diesen Absatz angehängt werden sollen, nach Vorschlags-ID.

ParagraphElement

Ein ParagraphElement beschreibt Inhalte innerhalb eines Paragraph.

JSON-Darstellung 
{
  "startIndex": integer,
  "endIndex": integer,

  "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)
  },
  "dateElement": {
    object (DateElement)
  }
}
Felder
startIndex

integer

Der nullbasierte Startindex dieses Absatzelements in UTF‑16-Codeeinheiten.
endIndex

integer

Der nullbasierte Endindex dieses Absatzelements (exklusiv) in UTF-16-Codeeinheiten.
Der Inhalt des Absatzelements. Im Folgenden finden Sie eine Liste von sich gegenseitig ausschließenden Feldern. In einer Antwort wird höchstens eines der Felder festgelegt:
textRun

object (TextRun)

Ein Absatz-Element für einen Textlauf.
autoText

object (AutoText)

Ein Absatz-Element für automatischen Text.
pageBreak

object (PageBreak)

Ein Absatz-Element für einen Seitenumbruch.
columnBreak

object (ColumnBreak)

Ein Absatz-Element für einen Spaltenumbruch.
footnoteReference

object (FootnoteReference)

Ein Absatz-Element für einen Fußnotenverweis.
horizontalRule

object (HorizontalRule)

Ein Absatz-Element für eine horizontale Linie.
equation

object (Equation)

Ein Gleichungsabsatzelement.
inlineObjectElement

object (InlineObjectElement)

Ein Inline-Objekt-Absatzelement.
person

object (Person)

Ein Absatzelement, das mit einer Person oder E‑Mail-Adresse verknüpft ist.
dateElement

object (DateElement)

Ein Absatzelement, das ein Datum darstellt.
Ende der sich gegenseitig ausschließenden Felder.

TextRun

Ein ParagraphElement, das einen Textabschnitt mit einheitlicher Formatierung darstellt.

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

string

Der Text dieses Laufs.

Alle Nicht-Textelemente im Lauf werden durch das Unicode-Zeichen U+E907 ersetzt.
suggestedInsertionIds[]

string

Die vorgeschlagenen Einfügungs-IDs. Ein TextRun kann mehrere Einfüge-IDs haben, wenn es sich um eine verschachtelte vorgeschlagene Änderung handelt. Wenn leer, handelt es sich nicht um eine vorgeschlagene Einfügung.
suggestedDeletionIds[]

string

Die IDs der vorgeschlagenen Löschungen. Wenn das Feld leer ist, gibt es keine vorgeschlagenen Löschungen für diese Inhalte.
textStyle

object (TextStyle)

Der Textstil dieses Laufs.
suggestedTextStyleChanges

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

Die vorgeschlagenen Änderungen am Textstil für diesen Lauf, die nach Vorschlags-ID sortiert sind.

TextStyle

Stellt die Formatierung dar, die auf Text angewendet werden kann.

Geerbte Textstile werden in dieser Nachricht als nicht festgelegte Felder dargestellt. Der übergeordnete Stil eines Textstils hängt davon ab, wo der Textstil definiert ist:

  • Der TextStyle von Text in einem Paragraph wird vom entsprechenden named style type des Absatzes übernommen.
  • Der TextStyle für ein named style wird vom benannten Stil normal text übernommen.
  • Der TextStyle des Stils mit dem Namen normal text wird vom Standardtextstil im Docs-Editor übernommen.
  • Der TextStyle eines Paragraph-Elements, das in einer Tabelle enthalten ist, kann seinen Textstil vom Tabellenstil übernehmen.

Wenn der Textstil nicht von einem übergeordneten Element übernommen wird, werden durch das Aufheben der Festlegung von Feldern die Standardwerte des Stils im Docs-Editor wiederhergestellt.

JSON-Darstellung 
{
  "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)
  }
}
Felder
bold

boolean

Gibt an, ob der Text fett gerendert wird.
italic

boolean

Gibt an, ob der Text kursiv formatiert ist.
underline

boolean

Gibt an, ob der Text unterstrichen ist.
strikethrough

boolean

Gibt an, ob der Text durchgestrichen ist.
smallCaps

boolean

Gibt an, ob der Text in Kapitälchen gerendert wird.
backgroundColor

object (OptionalColor)

Die Hintergrundfarbe des Texts. Wenn festgelegt, ist die Farbe entweder eine RGB-Farbe oder transparent, je nach dem Feld color.
foregroundColor

object (OptionalColor)

Die Vordergrundfarbe des Texts. Wenn festgelegt, ist die Farbe entweder eine RGB-Farbe oder transparent, je nach dem Feld color.
fontSize

object (Dimension)

Die Größe der Schriftart des Texts.
weightedFontFamily

object (WeightedFontFamily)

Die Schriftfamilie und die gerenderte Schriftstärke des Texts.

Wenn in einer Aktualisierungsanfrage Werte für weightedFontFamily und bold angegeben sind, wird zuerst weightedFontFamily und dann bold angewendet.

Wenn weightedFontFamily#weight nicht festgelegt ist, wird standardmäßig 400 verwendet.

Wenn weightedFontFamily festgelegt ist, muss auch weightedFontFamily#fontFamily mit einem nicht leeren Wert festgelegt werden. Andernfalls wird der Fehler „400 Falsche Anfrage“ zurückgegeben.
baselineOffset

enum (BaselineOffset)

Der vertikale Versatz des Texts relativ zu seiner Normalposition.

Text mit SUPERSCRIPT- oder SUBSCRIPT-Baseline-Offsets wird automatisch in einer kleineren Schriftgröße gerendert, die anhand des Felds fontSize berechnet wird. Änderungen in diesem Feld haben keine Auswirkungen auf fontSize.

OptionalColor

Eine Farbe, die entweder vollständig opak oder vollständig transparent sein kann.

JSON-Darstellung 
{
  "color": {
    object (Color)
  }
}
Felder
color

object (Color)

Wenn festgelegt, wird diese als undurchsichtige Farbe verwendet. Wenn kein Wert angegeben ist, wird eine transparente Farbe verwendet.

Farbe

Eine einfarbige Farbe.

JSON-Darstellung 
{
  "rgbColor": {
    object (RgbColor)
  }
}
Felder
rgbColor

object (RgbColor)

Der RGB-Farbwert.

RgbColor

Eine RGB-Farbe.

JSON-Darstellung 
{
  "red": number,
  "green": number,
  "blue": number
}
Felder
red

number

Die rote Komponente der Farbe, von 0,0 bis 1,0.
green

number

Die grüne Komponente der Farbe, von 0,0 bis 1,0.
blue

number

Die blaue Komponente der Farbe, von 0,0 bis 1,0.

Dimension

Eine Größe in einer einzelnen Richtung in den angegebenen Einheiten.

JSON-Darstellung 
{
  "magnitude": number,
  "unit": enum (Unit)
}
Felder
magnitude

number

Die Größenordnung.
unit

enum (Unit)

Die Einheiten für die Größe.

Einheit

Maßeinheiten.

Enums
UNIT_UNSPECIFIED Die Einheiten sind unbekannt.
PT Ein Punkt, 1/72 Zoll.

WeightedFontFamily

Stellt eine Schriftfamilie und die Schriftstärke von Text dar.

JSON-Darstellung 
{
  "fontFamily": string,
  "weight": integer
}
Felder
fontFamily

string

Die Schriftfamilie des Texts.

Die Schriftfamilie kann eine beliebige Schriftart aus dem Schriftartmenü in Google Docs oder aus Google Fonts sein. Wenn der Schriftartname nicht erkannt wird, wird der Text in Arial gerendert.
weight

integer

Die Schriftstärke. Dieses Feld kann einen beliebigen Wert haben, der ein Vielfaches von 100 zwischen 100 und 900 (einschließlich) ist. Dieser Bereich entspricht den numerischen Werten in der Spezifikation CSS 2.1, Abschnitt 15.6. Die dort genannten nicht numerischen Werte sind jedoch unzulässig.

Der Standardwert ist 400 („normal“).

Die Schriftstärke ist nur eine Komponente der gerenderten Schriftstärke. Eine Kombination aus dem weight-Wert und dem aufgelösten bold-Wert des Textformats bestimmt das gerenderte Gewicht nach Berücksichtigung der Vererbung:

  • Wenn der Text fett formatiert ist und die Gewichtung unter 400 liegt, wird die Gewichtung 400 gerendert.
  • Wenn der Text fett formatiert ist und die Schriftstärke größer oder gleich 400, aber kleiner als 700 ist, wird die Schriftstärke 700 gerendert.
  • Wenn das Gewicht größer oder gleich 700 ist, entspricht das gerenderte Gewicht dem Gewicht.
  • Wenn der Text nicht fett formatiert ist, entspricht die gerenderte Stärke der Stärke.

BaselineOffset

Die Möglichkeiten, wie Text vertikal von seiner Normalposition versetzt werden kann.

Enums
BASELINE_OFFSET_UNSPECIFIED Der Baseline-Offset des Texts wird vom übergeordneten Element übernommen.
NONE Der Text ist nicht vertikal versetzt.
SUPERSCRIPT Der Text ist vertikal nach oben versetzt (hochgestellt).
SUBSCRIPT Der Text ist vertikal nach unten versetzt (Tiefstellung).

SuggestedTextStyle

Ein Änderungsvorschlag für TextStyle.

JSON-Darstellung 
{
  "textStyle": {
    object (TextStyle)
  },
  "textStyleSuggestionState": {
    object (TextStyleSuggestionState)
  }
}
Felder
textStyle

object (TextStyle)

Eine TextStyle, die nur die Änderungen aus diesem Vorschlag enthält. Zusammen mit dem textStyleSuggestionState können Sie so sehen, welche Felder sich geändert haben und welche neuen Werte sie haben.
textStyleSuggestionState

object (TextStyleSuggestionState)

Eine Maske, die angibt, welche Felder im Basis-TextStyle in diesem Vorschlag geändert wurden.

TextStyleSuggestionState

Eine Maske, die angibt, welche Felder im Basis-TextStyle in diesem Vorschlag geändert wurden. Für jedes Feld, das auf „true“ gesetzt ist, gibt es einen neuen Vorschlag.

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

boolean

Gibt an, ob eine Änderung für bold vorgeschlagen wurde.
italicSuggested

boolean

Gibt an, ob eine Änderung für italic vorgeschlagen wurde.
underlineSuggested

boolean

Gibt an, ob eine Änderung für underline vorgeschlagen wurde.
strikethroughSuggested

boolean

Gibt an, ob eine Änderung für strikethrough vorgeschlagen wurde.
smallCapsSuggested

boolean

Gibt an, ob eine Änderung für smallCaps vorgeschlagen wurde.
backgroundColorSuggested

boolean

Gibt an, ob eine Änderung für backgroundColor vorgeschlagen wurde.
foregroundColorSuggested

boolean

Gibt an, ob eine Änderung für foregroundColor vorgeschlagen wurde.
fontSizeSuggested

boolean

Gibt an, ob eine Änderung für fontSize vorgeschlagen wurde.
weightedFontFamilySuggested

boolean

Gibt an, ob eine Änderung für weightedFontFamily vorgeschlagen wurde.
baselineOffsetSuggested

boolean

Gibt an, ob eine Änderung für baselineOffset vorgeschlagen wurde.

AutoText

Ein ParagraphElement, das eine Stelle im Text darstellt, die dynamisch durch Inhalte ersetzt wird, die sich im Laufe der Zeit ändern können, z. B. eine Seitenzahl.

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

enum (Type)

Der Typ dieses Auto-Texts.
suggestedInsertionIds[]

string

Die vorgeschlagenen Einfügungs-IDs. Ein AutoText kann mehrere Einfüge-IDs haben, wenn es sich um eine verschachtelte vorgeschlagene Änderung handelt. Wenn das Feld leer ist, handelt es sich nicht um eine vorgeschlagene Einfügung.
suggestedDeletionIds[]

string

Die IDs der vorgeschlagenen Löschungen. Wenn das Feld leer ist, gibt es keine vorgeschlagenen Löschungen für diese Inhalte.
textStyle

object (TextStyle)

Der Textstil dieses AutoTexts.
suggestedTextStyleChanges

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

Die vorgeschlagenen Änderungen am Textstil für diesen AutoText werden anhand der Vorschlags-ID angegeben.

Typ

Die Arten von AutoText.

Enums
TYPE_UNSPECIFIED Ein nicht angegebener automatischer Texttyp.
PAGE_NUMBER Geben Sie den Autotext für die aktuelle Seitenzahl ein.
PAGE_COUNT Geben Sie den Autotext für die Gesamtzahl der Seiten im Dokument ein.

PageBreak

Ein ParagraphElement, das einen Seitenumbruch darstellt. Durch einen Seitenumbruch beginnt der nachfolgende Text oben auf der nächsten Seite.

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

string

Die vorgeschlagenen Einfügungs-IDs. Ein PageBreak kann mehrere Einfüge-IDs haben, wenn es sich um eine verschachtelte vorgeschlagene Änderung handelt. Wenn leer, handelt es sich nicht um eine vorgeschlagene Einfügung.
suggestedDeletionIds[]

string

Die IDs der vorgeschlagenen Löschungen. Wenn das Feld leer ist, gibt es keine vorgeschlagenen Löschungen für diese Inhalte.
textStyle

object (TextStyle)

Der Textstil dieses Seitenumbruchs.

Ähnlich wie bei Textinhalten wie Textblöcken und Fußnotenverweisen kann sich der Textstil eines Seitenumbruchs auf das Layout von Inhalten sowie auf die Formatierung von Text auswirken, der daneben eingefügt wird.
suggestedTextStyleChanges

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

Die vorgeschlagenen Änderungen am Textstil für diesen Seitenumbruch, die durch die Vorschlags-ID identifiziert werden.

ColumnBreak

Ein ParagraphElement, das einen Spaltenumbruch darstellt. Durch einen Spaltenumbruch wird der nachfolgende Text oben in der nächsten Spalte begonnen.

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

string

Die vorgeschlagenen Einfügungs-IDs. Ein ColumnBreak kann mehrere Einfüge-IDs haben, wenn es sich um eine verschachtelte vorgeschlagene Änderung handelt. Wenn leer, handelt es sich nicht um eine vorgeschlagene Einfügung.
suggestedDeletionIds[]

string

Die IDs der vorgeschlagenen Löschungen. Wenn das Feld leer ist, gibt es keine vorgeschlagenen Löschungen für diese Inhalte.
textStyle

object (TextStyle)

Der Textstil dieses ColumnBreak-Elements.

Ähnlich wie bei Textinhalten wie Textblöcken und Fußnotenverweisen kann sich der Textstil eines Spaltenumbruchs auf das Layout von Inhalten sowie auf die Formatierung von Text auswirken, der daneben eingefügt wird.
suggestedTextStyleChanges

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

Der vorgeschlagene Textstil wird in diese ColumnBreak-Anweisung geändert. Die Zuordnung erfolgt über die Vorschlags-ID.

FootnoteReference

Ein ParagraphElement, das einen Fußnotenverweis darstellt. Ein Fußnotenverweis ist der Inline-Inhalt, der mit einer Nummer gerendert wird und zur Identifizierung der Fußnote dient.

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

string

Die ID des footnote, der den Inhalt dieses Fußnotenverweises enthält.
footnoteNumber

string

Die gerenderte Nummer dieser Fußnote.
suggestedInsertionIds[]

string

Die vorgeschlagenen Einfügungs-IDs. Ein FootnoteReference kann mehrere Einfüge-IDs haben, wenn es sich um eine verschachtelte vorgeschlagene Änderung handelt. Wenn leer, handelt es sich nicht um eine vorgeschlagene Einfügung.
suggestedDeletionIds[]

string

Die IDs der vorgeschlagenen Löschungen. Wenn das Feld leer ist, gibt es keine vorgeschlagenen Löschungen für diese Inhalte.
textStyle

object (TextStyle)

Der Textstil dieser FootnoteReference.
suggestedTextStyleChanges

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

Der vorgeschlagene Textstil wird für diese FootnoteReference geändert, wobei die Vorschlags-ID als Schlüssel verwendet wird.

HorizontalRule

Ein ParagraphElement, das eine horizontale Linie darstellt.

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

string

Die vorgeschlagenen Einfügungs-IDs. Ein HorizontalRule kann mehrere Einfüge-IDs haben, wenn es sich um eine verschachtelte vorgeschlagene Änderung handelt. Wenn leer, handelt es sich nicht um eine vorgeschlagene Einfügung.
suggestedDeletionIds[]

string

Die IDs der vorgeschlagenen Löschungen. Wenn das Feld leer ist, gibt es keine vorgeschlagenen Löschungen für diese Inhalte.
textStyle

object (TextStyle)

Der Textstil dieser HorizontalRule.

Ähnlich wie bei Textinhalten wie Textblöcken und Fußnotenverweisen kann sich der Textstil einer horizontalen Linie auf das Layout von Inhalten sowie auf die Formatierung von Text auswirken, der daneben eingefügt wird.
suggestedTextStyleChanges

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

Die vorgeschlagenen Änderungen am Textstil für diese HorizontalRule, die nach Vorschlags-ID indexiert werden.

Gleichung

Ein ParagraphElement, das eine Gleichung darstellt.

JSON-Darstellung 
{
  "suggestedInsertionIds": [
    string
  ],
  "suggestedDeletionIds": [
    string
  ]
}
Felder
suggestedInsertionIds[]

string

Die vorgeschlagenen Einfügungs-IDs. Ein Equation kann mehrere Einfüge-IDs haben, wenn es sich um eine verschachtelte vorgeschlagene Änderung handelt. Wenn leer, handelt es sich nicht um eine vorgeschlagene Einfügung.
suggestedDeletionIds[]

string

Die IDs der vorgeschlagenen Löschungen. Wenn das Feld leer ist, gibt es keine vorgeschlagenen Löschungen für diese Inhalte.

InlineObjectElement

Ein ParagraphElement, das ein InlineObject enthält.

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

string

Die ID des InlineObject, das dieses Element enthält.
suggestedInsertionIds[]

string

Die vorgeschlagenen Einfügungs-IDs. Ein InlineObjectElement kann mehrere Einfüge-IDs haben, wenn es sich um eine verschachtelte vorgeschlagene Änderung handelt. Wenn leer, handelt es sich nicht um eine vorgeschlagene Einfügung.
suggestedDeletionIds[]

string

Die IDs der vorgeschlagenen Löschungen. Wenn das Feld leer ist, gibt es keine vorgeschlagenen Löschungen für diese Inhalte.
textStyle

object (TextStyle)

Der Textstil dieses InlineObjectElement.

Ähnlich wie bei Textinhalten wie Textblöcken und Fußnotenverweisen kann sich der Textstil eines Inline-Objektelements auf das Inhaltslayout sowie auf die Formatierung des daneben eingefügten Texts auswirken.
suggestedTextStyleChanges

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

Der vorgeschlagene Textstil wird für dieses InlineObject anhand der Vorschlags-ID geändert.

Person

Eine Person oder E‑Mail-Adresse, die in einem Dokument erwähnt wird. Diese Erwähnungen verhalten sich wie ein einzelnes, unveränderliches Element, das den Namen oder die E-Mail-Adresse der Person enthält.

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

string

Nur Ausgabe. Die eindeutige ID dieses Links.
suggestedInsertionIds[]

string

IDs für Vorschläge, die diesen Personenlink in das Dokument einfügen. Ein Person kann mehrere Einfüge-IDs haben, wenn es sich um eine verschachtelte Änderungsvorschlag handelt, z. B. einen Vorschlag innerhalb eines Vorschlags, der von einem anderen Nutzer gemacht wurde. Wenn das Feld leer ist, ist dieser Personenlink kein Vorschlag.
suggestedDeletionIds[]

string

IDs für Vorschläge, mit denen die Verknüpfung dieser Person aus dem Dokument entfernt wird. Ein Person kann mehrere Lösch-IDs haben, wenn beispielsweise mehrere Nutzer das Löschen vorschlagen. Wenn das Feld leer ist, wird dieser Personenlink nicht zum Löschen vorgeschlagen.
textStyle

object (TextStyle)

Der Textstil dieses Person.
suggestedTextStyleChanges

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

Der vorgeschlagene Textstil wird in Person geändert, wobei die Vorschlags-ID als Schlüssel verwendet wird.
personProperties

object (PersonProperties)

Nur Ausgabe. Die Eigenschaften dieses Person. Dieses Feld ist immer vorhanden.

PersonProperties

Properties, die spezifisch für ein verknüpftes Person sind.

JSON-Darstellung 
{
  "name": string,
  "email": string
}
Felder
name

string

Der Name der Person, wenn er im Linktext anstelle der E-Mail-Adresse der Person angezeigt wird.
email

string

Die mit diesem Person verknüpfte E‑Mail-Adresse. Dieses Feld ist immer vorhanden.

RichLinkProperties

Eigenschaften, die für ein RichLink spezifisch sind.

JSON-Darstellung 
{
  "title": string,
  "uri": string,
  "mimeType": string
}
Felder
title

string

Der Titel des RichLink, wie er im Link angezeigt wird. Dieser Titel entspricht dem Titel der verknüpften Ressource zum Zeitpunkt des Einfügens oder der letzten Aktualisierung des Links. Dieses Feld ist immer vorhanden.
uri

string

Der URI zu RichLink. Diese ist immer vorhanden.
mimeType

string

Der MIME-Typ des RichLink, sofern vorhanden (z. B. bei einer Datei in Drive).

DateElement

Eine Datumsinstanz, die in einem Dokument erwähnt wird.

JSON-Darstellung 
{
  "dateId": string,
  "suggestedInsertionIds": [
    string
  ],
  "suggestedDeletionIds": [
    string
  ],
  "textStyle": {
    object (TextStyle)
  },
  "suggestedTextStyleChanges": {
    string: {
      object (SuggestedTextStyle)
    },
    ...
  },
  "dateElementProperties": {
    object (DateElementProperties)
  },
  "suggestedDateElementPropertiesChanges": {
    string: {
      object (SuggestedDateElementProperties)
    },
    ...
  }
}
Felder
dateId

string

Nur Ausgabe. Die eindeutige ID dieses Datums.
suggestedInsertionIds[]

string

IDs für Vorschläge, mit denen dieses Datum in das Dokument eingefügt wird. Ein DateElement kann mehrere Einfüge-IDs haben, wenn es sich um eine verschachtelte vorgeschlagene Änderung handelt (z. B. ein Vorschlag innerhalb eines Vorschlags eines anderen Nutzers). Wenn das Feld leer ist, ist dieses Datum kein vorgeschlagener Einfügungspunkt.
suggestedDeletionIds[]

string

IDs für Vorschläge, mit denen dieses Datum aus dem Dokument entfernt wird. Ein DateElement kann mehrere Lösch-IDs haben, wenn beispielsweise mehrere Nutzer das Löschen vorschlagen. Wenn das Feld leer ist, wird dieses Datum nicht zum Löschen vorgeschlagen.
textStyle

object (TextStyle)

Der Textstil dieses DateElement.
suggestedTextStyleChanges

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

Die vorgeschlagenen Änderungen am Textstil für dieses DateElement, die durch die Vorschlags-ID identifiziert werden.
dateElementProperties

object (DateElementProperties)

Die Eigenschaften dieses DateElement.
suggestedDateElementPropertiesChanges

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

Die vorgeschlagenen Änderungen an den Eigenschaften des Datenelements, nach Vorschlags-ID sortiert.

DateElementProperties

Attribute eines DateElement.

JSON-Darstellung 
{
  "timestamp": string,
  "timeZoneId": string,
  "locale": string,
  "dateFormat": enum (DateFormat),
  "timeFormat": enum (TimeFormat),
  "displayText": string
}
Felder
timestamp

string (Timestamp format)

Der darzustellende Zeitpunkt in Sekunden und Nanosekunden seit der Unix-Epoche: 1. Januar 1970 um Mitternacht UTC.

Der Zeitstempel muss in UTC angegeben werden. Wenn „timeZoneId“ festgelegt ist, wird der Zeitstempel entsprechend der Zeitzone angepasst. Ein Zeitstempel von 18000 mit dem Datumsformat DATE_FORMAT_ISO8601 und dem Zeitformat TIME_FORMAT_HOUR_MINUTE wird beispielsweise als 1970-01-01 5:00 AM angezeigt. Ein Zeitstempel von 18000 mit dem Datumsformat DATE_FORMAT_ISO8601, dem Zeitformat TIME_FORMAT_HOUR_MINUTE und der auf America/New_York eingestellten Zeitzone wird stattdessen als 1970-01-01 12:00 AM angezeigt.
timeZoneId

string

Die Zeitzone des DateElement, wie vom Unicode Common Locale Data Repository (CLDR)-Projekt definiert. Beispiel: America/New_York. Wenn nicht festgelegt, ist die Standardzeitzone etc/UTC.
locale

string

Der Sprachcode des DateElement. Beispiel: en. Wenn nicht festgelegt, ist die Standardsprache en.

Beschränkt auf die folgenden Sprachen: af, am, ar, as, az, be, bg, bn, ca, cs, da, de, el, en, en-CA, en-GB, es, es-419, et, eu, fa, fi, fil, fr, fr-CA, gl, gu, hi, hr, hu, hy, id, is, it, iw, ja, ka, kk, km, kn, ko, lo, lt, lv, mk, ml, mn, mr, ms, ne, nl, no, or, pa, pl, pt-BR, pt-PT, ro, ru, si, sk, sl, sq, sr, sv, sw, ta, te, th, tr, uk, ur, uz, vi, zh-CN, zh-HK, zh-TW, zu, cy, my.
dateFormat

enum (DateFormat)

Bestimmt, wie der Datumsabschnitt des DateElement im Dokument angezeigt wird.

Wenn nicht festgelegt, ist der Standardwert DATE_FORMAT_MONTH_DAY_YEAR_ABBREVIATED. Das DateElement wird dann als MMM d, y in en oder als lokales Äquivalent formatiert.
timeFormat

enum (TimeFormat)

Legt fest, wie der Zeitanteil des DateElement im Dokument angezeigt wird.

Wenn nicht festgelegt, ist der Standardwert TIME_FORMAT_DISABLED. Das bedeutet, dass keine Zeit angezeigt werden soll.
displayText

string

Nur Ausgabe. Gibt an, wie das DateElement im Dokument dargestellt wird.

DateFormat

Die möglichen Datumsformate von DateElement.

Enums
DATE_FORMAT_UNSPECIFIED Das Datumsformat ist nicht angegeben.
DATE_FORMAT_CUSTOM Nur Ausgabe. Das Datumsformat wird aus einer externen Quelle importiert.
DATE_FORMAT_MONTH_DAY_ABBREVIATED Das Datumsformat besteht aus dem abgekürzten Monat gefolgt vom Tag. Beispiel: „1. Januar“
DATE_FORMAT_MONTH_DAY_FULL Das Datumsformat besteht aus dem Monat, gefolgt vom Tag. Beispiel: „01. Januar“.
DATE_FORMAT_MONTH_DAY_YEAR_ABBREVIATED Das Datumsformat besteht aus einem abgekürzten Monat, gefolgt vom Tag und dem Jahr. Beispiel: „1. Januar 1970“.
DATE_FORMAT_ISO8601 Das Datumsformat entspricht ISO 8601. Beispiel: „1970-01-01“.

TimeFormat

Die möglichen Zeitformate von DateElement.

Enums
TIME_FORMAT_UNSPECIFIED Das Zeitformat ist nicht angegeben.
TIME_FORMAT_DISABLED Gibt an, dass das Datum keine Uhrzeit hat.
TIME_FORMAT_HOUR_MINUTE Das Zeitformat zeigt die Stunde und Minute an. Beispiel: „1. Januar 1970, 12:00 PM“.
TIME_FORMAT_HOUR_MINUTE_TIMEZONE Das Zeitformat zeigt Stunde, Minute und Zeitzone an. Beispiel: „1. Januar 1970, 12:00 Uhr UTC“.

SuggestedDateElementProperties

Ein Änderungsvorschlag für DateElementProperties.

JSON-Darstellung 
{
  "dateElementProperties": {
    object (DateElementProperties)
  },
  "dateElementPropertiesSuggestionState": {
    object (DateElementPropertiesSuggestionState)
  }
}
Felder
dateElementProperties

object (DateElementProperties)

DateElementProperties, die nur die in diesem Vorschlag vorgenommenen Änderungen enthält. Zusammen mit dem dateElementPropertiesSuggestionState können Sie so sehen, welche Felder sich geändert haben und welche neuen Werte sie haben.
dateElementPropertiesSuggestionState

object (DateElementPropertiesSuggestionState)

Eine Maske, die angibt, welche Felder im Basis-DateElementProperties in diesem Vorschlag geändert wurden.

DateElementPropertiesSuggestionState

Eine Maske, die angibt, welche Felder im Basis-DateElementProperties in diesem Vorschlag geändert wurden. Für jedes Feld, das auf „true“ gesetzt ist, gibt es einen neuen Vorschlag.

JSON-Darstellung 
{
  "timestampSuggested": boolean,
  "timeZoneIdSuggested": boolean,
  "localeSuggested": boolean,
  "dateFormatSuggested": boolean,
  "timeFormatSuggested": boolean
}
Felder
timestampSuggested

boolean

Gibt an, ob eine Änderung für timestamp vorgeschlagen wurde.
timeZoneIdSuggested

boolean

Gibt an, ob eine Änderung für timeZoneId vorgeschlagen wurde.
localeSuggested

boolean

Gibt an, ob eine Änderung für locale vorgeschlagen wurde.
dateFormatSuggested

boolean

Gibt an, ob eine Änderung für dateFormat vorgeschlagen wurde.
timeFormatSuggested

boolean

Gibt an, ob eine Änderung für timeFormat vorgeschlagen wurde.

ParagraphStyle

Stile, die auf einen ganzen Absatz angewendet werden.

Geerbte Absatzstile werden in dieser Nachricht als nicht festgelegte Felder dargestellt. Das übergeordnete Element eines Absatzformats hängt davon ab, wo das Absatzformat definiert ist:

  • Der ParagraphStyle für ein Paragraph wird vom entsprechenden named style type des Absatzes übernommen.
  • Der ParagraphStyle für ein named style wird vom benannten Stil normal text übernommen.
  • Der Absatzstil des Stils mit dem Namen normal text wird vom Standardabsatzstil im Docs-Editor übernommen.
  • Der ParagraphStyle für ein Paragraph-Element, das in einer Tabelle enthalten ist, kann seinen Absatzstil vom Tabellenstil erben.

Wenn der Absatzstil nicht von einem übergeordneten Element abgeleitet wird, werden durch das Aufheben der Festlegung von Feldern die Standardwerte des Stils im Docs-Editor wiederhergestellt.

JSON-Darstellung 
{
  "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
}
Felder
headingId

string

Die Überschriften-ID des Absatzes. Wenn leer, ist dieser Absatz keine Überschrift.

Dieses Attribut ist schreibgeschützt.
namedStyleType

enum (NamedStyleType)

Der benannte Formattyp des Absatzes.

Da sich die Aktualisierung des benannten Formattyps auf andere Eigenschaften in „ParagraphStyle“ auswirkt, wird der benannte Formattyp angewendet, bevor die anderen Eigenschaften aktualisiert werden.
alignment

enum (Alignment)

Die Textausrichtung für diesen Absatz.
lineSpacing

number

Der Abstand zwischen den Zeilen als Prozentsatz des normalen Abstands, wobei der normale Abstand als 100, 0 dargestellt wird. Wenn kein Wert festgelegt ist, wird der Wert vom übergeordneten Element übernommen.
direction

enum (ContentDirection)

Die Textrichtung dieses Absatzes. Wenn der Wert nicht festgelegt ist, wird standardmäßig LEFT_TO_RIGHT verwendet, da die Absatzrichtung nicht übernommen wird.
spacingMode

enum (SpacingMode)

Der Abstandmodus für den Absatz.
spaceAbove

object (Dimension)

Die Menge an zusätzlichem Leerraum über dem Absatz. Wenn kein Wert festgelegt ist, wird der Wert vom übergeordneten Element übernommen.
spaceBelow

object (Dimension)

Die Menge an zusätzlichem Leerraum unter dem Absatz. Wenn kein Wert festgelegt ist, wird der Wert vom übergeordneten Element übernommen.
borderBetween

object (ParagraphBorder)

Die Grenze zwischen diesem und dem vorherigen und nächsten Absatz. Wenn kein Wert festgelegt ist, wird der Wert vom übergeordneten Element übernommen.

Der Zwischenrahmen wird gerendert, wenn der angrenzende Absatz dieselben Rahmen- und Einzugseigenschaften hat.

Absatzränder können nicht teilweise aktualisiert werden. Wenn Sie einen Absatzrahmen ändern, muss der neue Rahmen vollständig angegeben werden.
borderTop

object (ParagraphBorder)

Der Rahmen oben in diesem Absatz. Wenn kein Wert festgelegt ist, wird der Wert vom übergeordneten Element übernommen.

Der obere Rahmen wird gerendert, wenn der Absatz darüber andere Rahmen- und Einzugseigenschaften hat.

Absatzränder können nicht teilweise aktualisiert werden. Wenn Sie einen Absatzrahmen ändern, muss der neue Rahmen vollständig angegeben werden.
borderBottom

object (ParagraphBorder)

Die Rahmenlinie unten in diesem Absatz. Wenn kein Wert festgelegt ist, wird der Wert vom übergeordneten Element übernommen.

Der untere Rahmen wird gerendert, wenn der Absatz darunter andere Rahmen- und Einzugseigenschaften hat.

Absatzränder können nicht teilweise aktualisiert werden. Wenn Sie einen Absatzrahmen ändern, muss der neue Rahmen vollständig angegeben werden.
borderLeft

object (ParagraphBorder)

Die Rahmenlinie links von diesem Absatz. Wenn kein Wert festgelegt ist, wird der Wert vom übergeordneten Element übernommen.

Absatzränder können nicht teilweise aktualisiert werden. Wenn Sie einen Absatzrahmen ändern, muss der neue Rahmen vollständig angegeben werden.
borderRight

object (ParagraphBorder)

Der rechte Rahmen dieses Absatzes. Wenn kein Wert festgelegt ist, wird der Wert vom übergeordneten Element übernommen.

Absatzränder können nicht teilweise aktualisiert werden. Wenn Sie einen Absatzrahmen ändern, muss der neue Rahmen vollständig angegeben werden.
indentFirstLine

object (Dimension)

Der Einzug für die erste Zeile des Absatzes. Wenn kein Wert festgelegt ist, wird der Wert vom übergeordneten Element übernommen.
indentStart

object (Dimension)

Der Einzug des Absatzes auf der Seite, die dem Textanfang entspricht, basierend auf der aktuellen Absatzrichtung. Wenn kein Wert festgelegt ist, wird der Wert vom übergeordneten Element übernommen.
indentEnd

object (Dimension)

Die Einrückung des Absatzes auf der Seite, die dem Ende des Textes entspricht, basierend auf der aktuellen Absatzrichtung. Wenn kein Wert festgelegt ist, wird der Wert vom übergeordneten Element übernommen.
tabStops[]

object (TabStop)

Eine Liste der Tabstopps für diesen Absatz. Die Liste der Tabstopps wird nicht übernommen.

Dieses Attribut ist schreibgeschützt.
keepLinesTogether

boolean

Gibt an, ob alle Zeilen des Absatzes nach Möglichkeit auf derselben Seite oder Spalte angeordnet werden sollen. Wenn kein Wert festgelegt ist, wird der Wert vom übergeordneten Element übernommen.
keepWithNext

boolean

Gibt an, ob mindestens ein Teil dieses Absatzes nach Möglichkeit auf derselben Seite oder Spalte wie der nächste Absatz angeordnet werden soll. Wenn kein Wert festgelegt ist, wird der Wert vom übergeordneten Element übernommen.
avoidWidowAndOrphan

boolean

Gibt an, ob für den Absatz Witwen und Waisen vermieden werden sollen. Wenn kein Wert festgelegt ist, wird der Wert vom übergeordneten Element übernommen.
shading

object (Shading)

Die Schattierung des Absatzes. Wenn kein Wert festgelegt ist, wird der Wert vom übergeordneten Element übernommen.
pageBreakBefore

boolean

Gibt an, ob der aktuelle Absatz immer am Anfang einer Seite beginnen soll. Wenn kein Wert festgelegt ist, wird der Wert vom übergeordneten Element übernommen.

Wenn Sie versuchen, pageBreakBefore für Absätze in nicht unterstützten Regionen zu aktualisieren, z. B. Table, Header, Footer und Footnote, kann dies zu einem ungültigen Dokumentstatus führen, der einen 400-Fehler („Bad Request“) zurückgibt.

NamedStyleType

Die Arten von benannten Stilen.

Enums
NAMED_STYLE_TYPE_UNSPECIFIED Der Typ der benannten Formatvorlage ist nicht angegeben.
NORMAL_TEXT Normaler Text.
TITLE Titel
SUBTITLE Untertitel.
HEADING_1 Überschrift 1
HEADING_2 Überschrift 2
HEADING_3 Überschrift 3.
HEADING_4 Überschrift 4.
HEADING_5 Überschrift 5.
HEADING_6 Überschrift 6.

Ausrichtung

Die Arten der Textausrichtung für einen Absatz.

Enums
ALIGNMENT_UNSPECIFIED Die Ausrichtung des Absatzes wird vom übergeordneten Element übernommen.
START Der Absatz ist am Zeilenanfang ausgerichtet. Bei LTR-Text linksbündig, ansonsten rechtsbündig.
CENTER Der Absatz ist zentriert.
END Der Absatz wird am Ende der Zeile ausgerichtet. Bei rechtsläufigem Text rechtsbündig, ansonsten linksbündig.
JUSTIFIED Der Absatz ist im Blocksatz formatiert.

ContentDirection

Die Inhalte für die Wegbeschreibung können einfließen.

Enums
CONTENT_DIRECTION_UNSPECIFIED Die Inhaltsrichtung ist nicht angegeben.
LEFT_TO_RIGHT Die Inhalte werden von links nach rechts angezeigt.
RIGHT_TO_LEFT Die Inhalte werden von rechts nach links angezeigt.

SpacingMode

Die verschiedenen Modi für den Absatzabstand.

Enums
SPACING_MODE_UNSPECIFIED Der Abstand wird vom übergeordneten Element übernommen.
NEVER_COLLAPSE Absatzabstände werden immer gerendert.
COLLAPSE_LISTS Der Absatzabstand wird zwischen Listenelementen übersprungen.

ParagraphBorder

Ein Rahmen um einen Absatz.

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

object (OptionalColor)

Die Farbe des Rahmens.
width

object (Dimension)

Die Breite des Rahmens.
padding

object (Dimension)

Der Innenabstand des Rahmens.
dashStyle

enum (DashStyle)

Der Strichstil des Rahmens.

DashStyle

Die Arten von Strichen, mit denen lineare Geometrie gerendert werden kann. Diese Werte basieren auf dem einfachen Typ „ST_PresetLineDashVal“, der in Abschnitt 20.1.10.49 von „Office Open XML File Formats – Fundamentals and Markup Language Reference“, Teil 1 der ECMA-376, 5. Auflage, beschrieben wird.

Enums
DASH_STYLE_UNSPECIFIED Nicht angegebener Strichstil.
SOLID Durchgezogene Linie. Entspricht dem ECMA-376-Wert „ST_PresetLineDashVal“ mit dem Wert „solid“. Dies ist der Standardstil für Striche.
DOT Gestrichelte Linie. Entspricht dem ECMA-376-Wert „dot“ für ST_PresetLineDashVal.
DASH Gestrichelte Linie. Entspricht dem ECMA-376-Wert „ST_PresetLineDashVal“ mit dem Wert „dash“.

TabStop

Ein Tabstopp innerhalb eines Absatzes.

JSON-Darstellung 
{
  "offset": {
    object (Dimension)
  },
  "alignment": enum (TabStopAlignment)
}
Felder
offset

object (Dimension)

Der Abstand zwischen diesem Tabstopp und dem Startrand.
alignment

enum (TabStopAlignment)

Die Ausrichtung dieses Tabstopps. Wenn nicht festgelegt, wird standardmäßig der Wert START verwendet.

TabStopAlignment

Die Ausrichtung des Tabstopps.

Enums
TAB_STOP_ALIGNMENT_UNSPECIFIED Die Ausrichtung des Tabstopps ist nicht angegeben.
START Der Tabstopp wird am Anfang der Zeile ausgerichtet. Das ist die Standardeinstellung.
CENTER Der Tabstopp wird an der Mitte der Zeile ausgerichtet.
END Der Tabstopp wird am Ende der Zeile ausgerichtet.

Schattierung

Die Schattierung eines Absatzes.

JSON-Darstellung 
{
  "backgroundColor": {
    object (OptionalColor)
  }
}
Felder
backgroundColor

object (OptionalColor)

Die Hintergrundfarbe dieser Absatzschattierung.

SuggestedParagraphStyle

Ein Änderungsvorschlag für ParagraphStyle.

JSON-Darstellung 
{
  "paragraphStyle": {
    object (ParagraphStyle)
  },
  "paragraphStyleSuggestionState": {
    object (ParagraphStyleSuggestionState)
  }
}
Felder
paragraphStyle

object (ParagraphStyle)

Eine ParagraphStyle, die nur die Änderungen aus diesem Vorschlag enthält. Zusammen mit dem paragraphStyleSuggestionState können Sie so sehen, welche Felder sich geändert haben und welche neuen Werte sie haben.
paragraphStyleSuggestionState

object (ParagraphStyleSuggestionState)

Eine Maske, die angibt, welche Felder im Basis-ParagraphStyle in diesem Vorschlag geändert wurden.

ParagraphStyleSuggestionState

Eine Maske, die angibt, welche Felder im Basis-ParagraphStyle in diesem Vorschlag geändert wurden. Für jedes Feld, das auf „true“ gesetzt ist, gibt es einen neuen Vorschlag.

JSON-Darstellung 
{
  "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
}
Felder
headingIdSuggested

boolean

Gibt an, ob eine Änderung für headingId vorgeschlagen wurde.
namedStyleTypeSuggested

boolean

Gibt an, ob eine Änderung für namedStyleType vorgeschlagen wurde.
alignmentSuggested

boolean

Gibt an, ob eine Änderung für alignment vorgeschlagen wurde.
lineSpacingSuggested

boolean

Gibt an, ob eine Änderung für lineSpacing vorgeschlagen wurde.
directionSuggested

boolean

Gibt an, ob eine Änderung für direction vorgeschlagen wurde.
spacingModeSuggested

boolean

Gibt an, ob eine Änderung für spacingMode vorgeschlagen wurde.
spaceAboveSuggested

boolean

Gibt an, ob eine Änderung für spaceAbove vorgeschlagen wurde.
spaceBelowSuggested

boolean

Gibt an, ob eine Änderung für spaceBelow vorgeschlagen wurde.
borderBetweenSuggested

boolean

Gibt an, ob eine Änderung für borderBetween vorgeschlagen wurde.
borderTopSuggested

boolean

Gibt an, ob eine Änderung für borderTop vorgeschlagen wurde.
borderBottomSuggested

boolean

Gibt an, ob eine Änderung für borderBottom vorgeschlagen wurde.
borderLeftSuggested

boolean

Gibt an, ob eine Änderung für borderLeft vorgeschlagen wurde.
borderRightSuggested

boolean

Gibt an, ob eine Änderung für borderRight vorgeschlagen wurde.
indentFirstLineSuggested

boolean

Gibt an, ob eine Änderung für indentFirstLine vorgeschlagen wurde.
indentStartSuggested

boolean

Gibt an, ob eine Änderung für indentStart vorgeschlagen wurde.
indentEndSuggested

boolean

Gibt an, ob eine Änderung für indentEnd vorgeschlagen wurde.
keepLinesTogetherSuggested

boolean

Gibt an, ob eine Änderung für keepLinesTogether vorgeschlagen wurde.
keepWithNextSuggested

boolean

Gibt an, ob eine Änderung für keepWithNext vorgeschlagen wurde.
avoidWidowAndOrphanSuggested

boolean

Gibt an, ob eine Änderung für avoidWidowAndOrphan vorgeschlagen wurde.
shadingSuggestionState

object (ShadingSuggestionState)

Eine Maske, die angibt, welche Felder in shading in diesem Vorschlag geändert wurden.
pageBreakBeforeSuggested

boolean

Gibt an, ob eine Änderung für pageBreakBefore vorgeschlagen wurde.

ShadingSuggestionState

Eine Maske, die angibt, welche Felder der Basis-Shading in dieser vorgeschlagenen Änderung geändert wurden. Für jedes Feld, das auf „true“ gesetzt ist, gibt es einen neuen Vorschlag.

JSON-Darstellung 
{
  "backgroundColorSuggested": boolean
}
Felder
backgroundColorSuggested

boolean

Gibt an, ob eine Änderung für Shading vorgeschlagen wurde.

Aufzählungszeichen

Beschreibt das Aufzählungszeichen eines Absatzes.

JSON-Darstellung 
{
  "listId": string,
  "nestingLevel": integer,
  "textStyle": {
    object (TextStyle)
  }
}
Felder
listId

string

Die ID der Liste, zu der dieser Absatz gehört.
nestingLevel

integer

Die Verschachtelungsebene dieses Absatzes in der Liste.
textStyle

object (TextStyle)

Der absatzspezifische Textstil, der auf diesen Aufzählungszeichen angewendet wird.

SuggestedBullet

Ein Änderungsvorschlag für Bullet.

JSON-Darstellung 
{
  "bullet": {
    object (Bullet)
  },
  "bulletSuggestionState": {
    object (BulletSuggestionState)
  }
}
Felder
bullet

object (Bullet)

Eine Bullet, die nur die Änderungen aus diesem Vorschlag enthält. Zusammen mit dem bulletSuggestionState können Sie so sehen, welche Felder sich geändert haben und welche neuen Werte sie haben.
bulletSuggestionState

object (BulletSuggestionState)

Eine Maske, die angibt, welche Felder im Basis-Bullet in diesem Vorschlag geändert wurden.

BulletSuggestionState

Eine Maske, die angibt, welche Felder im Basis-Bullet in diesem Vorschlag geändert wurden. Für jedes Feld, das auf „true“ gesetzt ist, gibt es einen neuen Vorschlag.

JSON-Darstellung 
{
  "listIdSuggested": boolean,
  "nestingLevelSuggested": boolean,
  "textStyleSuggestionState": {
    object (TextStyleSuggestionState)
  }
}
Felder
listIdSuggested

boolean

Gibt an, ob eine Änderung für listId vorgeschlagen wurde.
nestingLevelSuggested

boolean

Gibt an, ob eine Änderung für nestingLevel vorgeschlagen wurde.
textStyleSuggestionState

object (TextStyleSuggestionState)

Eine Maske, die angibt, welche Felder in text style in diesem Vorschlag geändert wurden.

ObjectReferences

Eine Sammlung von Objekt-IDs.

JSON-Darstellung 
{
  "objectIds": [
    string
  ]
}
Felder
objectIds[]

string

Die Objekt-IDs.

SectionBreak

Ein StructuralElement, das einen Abschnittswechsel darstellt. Ein Abschnitt ist ein Bereich mit Inhalten, die denselben SectionStyle haben. Ein Abschnittsumbruch kennzeichnet den Beginn eines neuen Abschnitts. Der Abschnittsstil wird auf den Abschnitt nach dem Abschnittsumbruch angewendet.

Der Dokumenttext beginnt immer mit einem Abschnittsumbruch.

JSON-Darstellung 
{
  "suggestedInsertionIds": [
    string
  ],
  "suggestedDeletionIds": [
    string
  ],
  "sectionStyle": {
    object (SectionStyle)
  }
}
Felder
suggestedInsertionIds[]

string

Die vorgeschlagenen Einfügungs-IDs. Ein SectionBreak kann mehrere Einfüge-IDs haben, wenn es sich um eine verschachtelte vorgeschlagene Änderung handelt. Wenn leer, handelt es sich nicht um eine vorgeschlagene Einfügung.
suggestedDeletionIds[]

string

Die IDs der vorgeschlagenen Löschungen. Wenn das Feld leer ist, gibt es keine vorgeschlagenen Löschungen für diese Inhalte.
sectionStyle

object (SectionStyle)

Der Stil des Abschnitts nach diesem Abschnittsumbruch.

SectionStyle

Das Design, das auf einen Abschnitt angewendet wird.

JSON-Darstellung 
{
  "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
}
Felder
columnProperties[]

object (SectionColumnProperties)

Die Spaltenattribute des Bereichs.

Wenn der Abschnitt leer ist, enthält er eine Spalte mit den Standardeigenschaften im Docs-Editor. Ein Bereich kann so aktualisiert werden, dass er maximal drei Spalten enthält.

Beim Aktualisieren dieser Property muss ein konkreter Wert festgelegt werden. Wenn Sie diese Property nicht festlegen, wird der Fehler „400 Falsche Anfrage“ zurückgegeben.
columnSeparatorStyle

enum (ColumnSeparatorStyle)

Der Stil der Spaltentrennzeichen.

Dieser Stil kann auch dann festgelegt werden, wenn der Bereich nur eine Spalte enthält.

Beim Aktualisieren dieser Property muss ein konkreter Wert festgelegt werden. Wenn Sie diese Property nicht festlegen, wird der Fehler „400 Falsche Anfrage“ zurückgegeben.
contentDirection

enum (ContentDirection)

Die inhaltliche Ausrichtung dieses Abschnitts. Wenn nicht festgelegt, wird standardmäßig der Wert LEFT_TO_RIGHT verwendet.

Beim Aktualisieren dieser Property muss ein konkreter Wert festgelegt werden. Wenn Sie diese Property nicht festlegen, wird der Fehler „400 Falsche Anfrage“ zurückgegeben.
marginTop

object (Dimension)

Der obere Seitenrand des Abschnitts. Wenn kein Wert festgelegt ist, wird standardmäßig der Wert marginTop aus DocumentStyle verwendet.

Wenn [DocumentMode][google.apps.docs.v1.DocumentStyle.document_format.document_mode] PAGELESS ist, wird diese Eigenschaft nicht gerendert.

Beim Aktualisieren dieser Property muss ein konkreter Wert festgelegt werden. Wenn Sie diese Property nicht festlegen, wird der Fehler „400 Falsche Anfrage“ zurückgegeben.
marginBottom

object (Dimension)

Der untere Seitenrand des Abschnitts. Wenn kein Wert festgelegt ist, wird standardmäßig der Wert marginBottom aus DocumentStyle verwendet.

Wenn [DocumentMode][google.apps.docs.v1.DocumentStyle.document_format.document_mode] PAGELESS ist, wird diese Eigenschaft nicht gerendert.

Beim Aktualisieren dieser Property muss ein konkreter Wert festgelegt werden. Wenn Sie diese Property nicht festlegen, wird der Fehler „400 Falsche Anfrage“ zurückgegeben.
marginRight

object (Dimension)

Der rechte Seitenrand des Abschnitts. Wenn kein Wert festgelegt ist, wird standardmäßig der Wert marginRight aus DocumentStyle verwendet. Wenn Sie den rechten Rand aktualisieren, ändert sich die Größe der Spalten in diesem Bereich. Da sich der Rand auf die Spaltenbreite auswirkt, wird er vor den Spalteneigenschaften angewendet.

Wenn [DocumentMode][google.apps.docs.v1.DocumentStyle.document_format.document_mode] PAGELESS ist, wird diese Eigenschaft nicht gerendert.

Beim Aktualisieren dieser Property muss ein konkreter Wert festgelegt werden. Wenn Sie diese Property nicht festlegen, wird der Fehler „400 Falsche Anfrage“ zurückgegeben.
marginLeft

object (Dimension)

Der linke Seitenrand des Abschnitts. Wenn kein Wert festgelegt ist, wird standardmäßig der Wert marginLeft aus DocumentStyle verwendet. Wenn Sie den linken Rand aktualisieren, wird die Größe der Spalten in diesem Bereich angepasst. Da sich der Rand auf die Spaltenbreite auswirkt, wird er vor den Spalteneigenschaften angewendet.

Wenn [DocumentMode][google.apps.docs.v1.DocumentStyle.document_format.document_mode] PAGELESS ist, wird diese Eigenschaft nicht gerendert.

Beim Aktualisieren dieser Property muss ein konkreter Wert festgelegt werden. Wenn Sie diese Property nicht festlegen, wird der Fehler „400 Falsche Anfrage“ zurückgegeben.
marginHeader

object (Dimension)

Der Header-Abstand des Abschnitts. Wenn kein Wert festgelegt ist, wird standardmäßig der Wert marginHeader aus DocumentStyle verwendet. Wenn das Dokument aktualisiert wird, wird useCustomHeaderFooterMargins in DocumentStyle auf „true“ gesetzt. Der Wert von useCustomHeaderFooterMargins für DocumentStyle gibt an, ob für diesen Abschnitt ein Kopfzeilenrand berücksichtigt wird.

Wenn [DocumentMode][google.apps.docs.v1.DocumentStyle.document_format.document_mode] PAGELESS ist, wird diese Eigenschaft nicht gerendert.

Beim Aktualisieren dieser Property muss ein konkreter Wert festgelegt werden. Wenn Sie diese Property nicht festlegen, wird der Fehler „400 Falsche Anfrage“ zurückgegeben.
sectionType

enum (SectionType)

Nur Ausgabe. Der Typ des Abschnitts.
defaultHeaderId

string

Die ID des Standardheaders. Wenn kein Wert festgelegt ist, wird der Wert vom vorherigen SectionBreak's-SectionStyle übernommen. Wenn der Wert im ersten SectionBreak nicht festgelegt ist, wird er von defaultHeaderId des DocumentStyle übernommen.

Wenn [DocumentMode][google.apps.docs.v1.DocumentStyle.document_format.document_mode] PAGELESS ist, wird diese Eigenschaft nicht gerendert.

Dieses Attribut ist schreibgeschützt.
firstPageHeaderId

string

Die ID der Kopfzeile, die nur für die erste Seite des Abschnitts verwendet wird. Wenn useFirstPageHeaderFooter „true“ ist, wird dieser Wert für die Kopfzeile auf der ersten Seite des Abschnitts verwendet. Wenn der Wert „false“ ist, wird für die Überschrift auf der ersten Seite des Abschnitts defaultHeaderId verwendet. Wenn kein Wert festgelegt ist, wird der Wert vom vorherigen SectionBreak's-SectionStyle übernommen. Wenn der Wert im ersten SectionBreak nicht festgelegt ist, wird er von firstPageHeaderId des DocumentStyle übernommen.

Wenn [DocumentMode][google.apps.docs.v1.DocumentStyle.document_format.document_mode] PAGELESS ist, wird diese Eigenschaft nicht gerendert.

Dieses Attribut ist schreibgeschützt.
firstPageFooterId

string

Die ID der Fußzeile, die nur für die erste Seite des Abschnitts verwendet wird. Wenn useFirstPageHeaderFooter „true“ ist, wird dieser Wert für die Fußzeile auf der ersten Seite des Abschnitts verwendet. Wenn der Wert „false“ ist, wird für die Fußzeile auf der ersten Seite des Abschnitts defaultFooterId verwendet. Wenn kein Wert festgelegt ist, wird der Wert vom vorherigen SectionBreak's-SectionStyle übernommen. Wenn der Wert im ersten SectionBreak nicht festgelegt ist, wird er von firstPageFooterId des DocumentStyle übernommen.

Wenn [DocumentMode][google.apps.docs.v1.DocumentStyle.document_format.document_mode] PAGELESS ist, wird diese Eigenschaft nicht gerendert.

Dieses Attribut ist schreibgeschützt.
evenPageHeaderId

string

Die ID des Headers, der nur für gerade Seiten verwendet wird. Wenn der Wert von useEvenPageHeaderFooter für DocumentStyle „true“ ist, wird dieser Wert für die Kopfzeilen auf geraden Seiten im Abschnitt verwendet. Ist der Wert „false“, wird für die Header auf geraden Seiten defaultHeaderId verwendet. Wenn kein Wert festgelegt ist, wird der Wert vom vorherigen SectionBreak's-SectionStyle übernommen. Wenn der Wert im ersten SectionBreak nicht festgelegt ist, wird er von evenPageHeaderId des DocumentStyle übernommen.

Wenn [DocumentMode][google.apps.docs.v1.DocumentStyle.document_format.document_mode] PAGELESS ist, wird diese Eigenschaft nicht gerendert.

Dieses Attribut ist schreibgeschützt.
evenPageFooterId

string

Die ID der Fußzeile, die nur für gerade Seiten verwendet wird. Wenn der Wert von useEvenPageHeaderFooter für DocumentStyle „true“ ist, wird dieser Wert für die Fußzeilen auf geraden Seiten im Abschnitt verwendet. Wenn der Wert „false“ ist, wird für die Fußzeilen auf geraden Seiten defaultFooterId verwendet. Wenn kein Wert festgelegt ist, wird der Wert vom vorherigen SectionBreak's-SectionStyle übernommen. Wenn der Wert im ersten SectionBreak nicht festgelegt ist, wird er von evenPageFooterId des DocumentStyle übernommen.

Wenn [DocumentMode][google.apps.docs.v1.DocumentStyle.document_format.document_mode] PAGELESS ist, wird diese Eigenschaft nicht gerendert.

Dieses Attribut ist schreibgeschützt.
useFirstPageHeaderFooter

boolean

Gibt an, ob die Kopf- und Fußzeilen-IDs der ersten Seite für die erste Seite des Abschnitts verwendet werden sollen. Wenn der Wert nicht festgelegt ist, wird er für den ersten Abschnitt von useFirstPageHeaderFooter aus DocumentStyle übernommen. Wenn der Wert für nachfolgende Sektoren nicht festgelegt ist, sollte er als „false“ interpretiert werden.

Wenn [DocumentMode][google.apps.docs.v1.DocumentStyle.document_format.document_mode] PAGELESS ist, wird diese Eigenschaft nicht gerendert.

Beim Aktualisieren dieser Property muss ein konkreter Wert festgelegt werden. Wenn Sie diese Property nicht festlegen, wird der Fehler „400 Falsche Anfrage“ zurückgegeben.
pageNumberStart

integer

Die Seitenzahl, ab der die Anzahl der Seiten für diesen Abschnitt gezählt werden soll. Wenn nicht festgelegt, wird die Seitennummerierung des vorherigen Abschnitts fortgesetzt. Wenn der Wert in der ersten SectionBreak nicht festgelegt ist, sehen Sie in pageNumberStart von DocumentStyle nach.

Wenn [DocumentMode][google.apps.docs.v1.DocumentStyle.document_format.document_mode] PAGELESS ist, wird diese Eigenschaft nicht gerendert.

Beim Aktualisieren dieser Property muss ein konkreter Wert festgelegt werden. Wenn Sie diese Property nicht festlegen, wird der Fehler „400 Falsche Anfrage“ zurückgegeben.
flipPageOrientation

boolean

Optional. Gibt an, ob die Dimensionen von pageSize des DocumentStyle für diesen Abschnitt gespiegelt werden sollen. So kann die Seitenausrichtung zwischen Hoch- und Querformat geändert werden. Wenn kein Wert festgelegt ist, wird der Wert von flipPageOrientation aus DocumentStyle übernommen.

Wenn [DocumentMode][google.apps.docs.v1.DocumentStyle.document_format.document_mode] PAGELESS ist, wird diese Eigenschaft nicht gerendert.

Beim Aktualisieren dieser Property muss ein konkreter Wert festgelegt werden. Wenn Sie diese Property nicht festlegen, wird der Fehler „400 Falsche Anfrage“ zurückgegeben.

SectionColumnProperties

Eigenschaften, die auf die Spalte eines Bereichs angewendet werden.

JSON-Darstellung 
{
  "width": {
    object (Dimension)
  },
  "paddingEnd": {
    object (Dimension)
  }
}
Felder
width

object (Dimension)

Nur Ausgabe. Die Breite der Spalte.
paddingEnd

object (Dimension)

Der Abstand am Ende der Spalte.

ColumnSeparatorStyle

Der Stil der Spaltentrennzeichen zwischen Spalten.

Enums
COLUMN_SEPARATOR_STYLE_UNSPECIFIED Ein nicht angegebener Spaltentrennzeichenstil.
NONE Keine Spaltentrennlinien zwischen Spalten.
BETWEEN_EACH_COLUMN Rendert eine Spaltentrennlinie zwischen den einzelnen Spalten.

SectionType

Gibt an, wie der Beginn des aktuellen Abschnitts im Verhältnis zum vorherigen Abschnitt positioniert ist.

Enums
SECTION_TYPE_UNSPECIFIED Der Abschnittstyp ist nicht angegeben.
CONTINUOUS Der Abschnitt beginnt unmittelbar nach dem letzten Absatz des vorherigen Abschnitts.
NEXT_PAGE Der Abschnitt beginnt auf der nächsten Seite.

Tabelle

Eine StructuralElement, die eine Tabelle darstellt.

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

integer

Anzahl der Zeilen in der Tabelle.
columns

integer

Anzahl der Spalten in der Tabelle.

Eine Tabelle muss nicht rechteckig sein. Einige Zeilen können also eine unterschiedliche Anzahl von Zellen haben.
tableRows[]

object (TableRow)

Inhalt und Stil jeder Zeile.
suggestedInsertionIds[]

string

Die vorgeschlagenen Einfügungs-IDs. Ein Table kann mehrere Einfüge-IDs haben, wenn es sich um eine verschachtelte vorgeschlagene Änderung handelt. Wenn leer, handelt es sich nicht um eine vorgeschlagene Einfügung.
suggestedDeletionIds[]

string

Die IDs der vorgeschlagenen Löschungen. Wenn das Feld leer ist, gibt es keine vorgeschlagenen Löschungen für diese Inhalte.
tableStyle

object (TableStyle)

Der Stil der Tabelle.

TableRow

Inhalte und Stil einer Zeile in einer Table.

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

integer

Der nullbasierte Startindex dieser Zeile in UTF-16-Codeeinheiten.
endIndex

integer

Der nullbasierte Endindex dieser Zeile (exklusiv) in UTF-16-Codeeinheiten.
tableCells[]

object (TableCell)

Inhalt und Stil jeder Zelle in dieser Zeile.

Eine Tabelle muss nicht rechteckig sein. Einige Zeilen können also eine andere Anzahl von Zellen als andere Zeilen in derselben Tabelle haben.
suggestedInsertionIds[]

string

Die vorgeschlagenen Einfügungs-IDs. Ein TableRow kann mehrere Einfüge-IDs haben, wenn es sich um eine verschachtelte vorgeschlagene Änderung handelt. Wenn leer, handelt es sich nicht um eine vorgeschlagene Einfügung.
suggestedDeletionIds[]

string

Die IDs der vorgeschlagenen Löschungen. Wenn das Feld leer ist, gibt es keine vorgeschlagenen Löschungen für diese Inhalte.
tableRowStyle

object (TableRowStyle)

Die Formatierung der Tabellenzeile.
suggestedTableRowStyleChanges

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

Die vorgeschlagenen Stiländerungen für diese Zeile, die nach Vorschlags-ID sortiert sind.

TableCell

Inhalte und Stil einer Zelle in einem Table.

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

integer

Der nullbasierte Startindex dieser Zelle in UTF-16-Codeeinheiten.
endIndex

integer

Der nullbasierte Endindex dieser Zelle (exklusiv) in UTF-16-Codeeinheiten.
content[]

object (StructuralElement)

Der Inhalt der Zelle.
tableCellStyle

object (TableCellStyle)

Der Stil der Zelle.
suggestedInsertionIds[]

string

Die vorgeschlagenen Einfügungs-IDs. Ein TableCell kann mehrere Einfüge-IDs haben, wenn es sich um eine verschachtelte vorgeschlagene Änderung handelt. Wenn leer, handelt es sich nicht um eine vorgeschlagene Einfügung.
suggestedDeletionIds[]

string

Die IDs der vorgeschlagenen Löschungen. Wenn das Feld leer ist, gibt es keine vorgeschlagenen Löschungen für diese Inhalte.
suggestedTableCellStyleChanges

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

Die vorgeschlagenen Änderungen am Stil der Tabellenzelle, die nach Vorschlags-ID sortiert sind.

TableCellStyle

Der Stil eines TableCell.

Geerbte Tabellenzellenstile werden in dieser Nachricht als nicht festgelegte Felder dargestellt. Der Stil einer Tabellenzelle kann vom Stil der Tabelle übernommen werden.

JSON-Darstellung 
{
  "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)
}
Felder
rowSpan

integer

Der Zeilenbereich der Zelle.

Dieses Attribut ist schreibgeschützt.
columnSpan

integer

Die Spaltenbreite der Zelle.

Dieses Attribut ist schreibgeschützt.
backgroundColor

object (OptionalColor)

Die Hintergrundfarbe der Zelle.
borderLeft

object (TableCellBorder)

Der linke Rand der Zelle.
borderRight

object (TableCellBorder)

Die rechte Rahmenlinie der Zelle.
borderTop

object (TableCellBorder)

Der obere Rahmen der Zelle.
borderBottom

object (TableCellBorder)

Die untere Rahmenlinie der Zelle.
paddingLeft

object (Dimension)

Das linke Padding der Zelle.
paddingRight

object (Dimension)

Der rechte Innenabstand der Zelle.
paddingTop

object (Dimension)

Der obere Innenabstand der Zelle.
paddingBottom

object (Dimension)

Der untere Innenabstand der Zelle.
contentAlignment

enum (ContentAlignment)

Die Ausrichtung des Inhalts in der Tabellenzelle. Die Standardausrichtung entspricht der Ausrichtung für neu erstellte Tabellenzellen im Docs-Editor.

TableCellBorder

Ein Rahmen um eine Tabellenzelle.

Tabellenzellrahmen können nicht transparent sein. Wenn Sie den Rahmen einer Tabellenzelle ausblenden möchten, legen Sie die Breite auf 0 fest.

JSON-Darstellung 
{
  "color": {
    object (OptionalColor)
  },
  "width": {
    object (Dimension)
  },
  "dashStyle": enum (DashStyle)
}
Felder
color

object (OptionalColor)

Die Farbe des Rahmens.

Diese Farbe kann nicht transparent sein.
width

object (Dimension)

Die Breite des Rahmens.
dashStyle

enum (DashStyle)

Der Strichstil des Rahmens.

ContentAlignment

Die Arten der Inhaltsausrichtung.

Abgeleitet von einer Teilmenge der Werte des einfachen Typs „ST_TextAnchoringType“ in Abschnitt 20.1.10.60 von „Office Open XML File Formats – Fundamentals and Markup Language Reference“, Teil 1 von ECMA-376, 5. Auflage.

Enums
CONTENT_ALIGNMENT_UNSPECIFIED Eine nicht angegebene Inhaltsausrichtung. Die Ausrichtung des Inhalts wird vom übergeordneten Element übernommen, sofern eines vorhanden ist.
CONTENT_ALIGNMENT_UNSUPPORTED Eine nicht unterstützte Inhaltsausrichtung.
TOP Eine Ausrichtung, bei der der Inhalt am oberen Rand des Content-Holders ausgerichtet wird. Entspricht ECMA-376 ST_TextAnchoringType „t“.
MIDDLE Eine Ausrichtung, mit der der Inhalt in der Mitte des Inhaltshalters ausgerichtet wird. Entspricht ECMA-376 ST_TextAnchoringType „ctr“.
BOTTOM Eine Ausrichtung, mit der der Inhalt am unteren Rand des Inhaltshalters ausgerichtet wird. Entspricht ECMA-376 ST_TextAnchoringType „b“.

SuggestedTableCellStyle

Ein Änderungsvorschlag für TableCellStyle.

JSON-Darstellung 
{
  "tableCellStyle": {
    object (TableCellStyle)
  },
  "tableCellStyleSuggestionState": {
    object (TableCellStyleSuggestionState)
  }
}
Felder
tableCellStyle

object (TableCellStyle)

Eine TableCellStyle, die nur die Änderungen aus diesem Vorschlag enthält. Zusammen mit dem tableCellStyleSuggestionState können Sie so sehen, welche Felder sich geändert haben und welche neuen Werte sie haben.
tableCellStyleSuggestionState

object (TableCellStyleSuggestionState)

Eine Maske, die angibt, welche Felder im Basis-TableCellStyle in diesem Vorschlag geändert wurden.

TableCellStyleSuggestionState

Eine Maske, die angibt, welche Felder im Basis-TableCellStyle in diesem Vorschlag geändert wurden. Für jedes Feld, das auf „true“ gesetzt ist, gibt es einen neuen Vorschlag.

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

boolean

Gibt an, ob eine Änderung für rowSpan vorgeschlagen wurde.
columnSpanSuggested

boolean

Gibt an, ob eine Änderung für columnSpan vorgeschlagen wurde.
backgroundColorSuggested

boolean

Gibt an, ob eine Änderung für backgroundColor vorgeschlagen wurde.
borderLeftSuggested

boolean

Gibt an, ob eine Änderung für borderLeft vorgeschlagen wurde.
borderRightSuggested

boolean

Gibt an, ob eine Änderung für borderRight vorgeschlagen wurde.
borderTopSuggested

boolean

Gibt an, ob eine Änderung für borderTop vorgeschlagen wurde.
borderBottomSuggested

boolean

Gibt an, ob eine Änderung für borderBottom vorgeschlagen wurde.
paddingLeftSuggested

boolean

Gibt an, ob eine Änderung für paddingLeft vorgeschlagen wurde.
paddingRightSuggested

boolean

Gibt an, ob eine Änderung für paddingRight vorgeschlagen wurde.
paddingTopSuggested

boolean

Gibt an, ob eine Änderung für paddingTop vorgeschlagen wurde.
paddingBottomSuggested

boolean

Gibt an, ob eine Änderung für paddingBottom vorgeschlagen wurde.
contentAlignmentSuggested

boolean

Gibt an, ob eine Änderung für contentAlignment vorgeschlagen wurde.

TableRowStyle

Stile, die auf eine Tabellenzeile angewendet werden.

JSON-Darstellung 
{
  "minRowHeight": {
    object (Dimension)
  },
  "tableHeader": boolean,
  "preventOverflow": boolean
}
Felder
minRowHeight

object (Dimension)

Die Mindesthöhe der Zeile. Die Zeile wird im Docs-Editor mit einer Höhe gerendert, die diesem Wert entspricht oder ihn überschreitet, damit der gesamte Inhalt der Zellen in der Zeile angezeigt wird.
tableHeader

boolean

Gibt an, ob es sich bei der Zeile um eine Tabellenüberschrift handelt.
preventOverflow

boolean

Gibt an, ob die Zeile Seiten- oder Spaltengrenzen überschreiten darf.

SuggestedTableRowStyle

Ein Änderungsvorschlag für TableRowStyle.

JSON-Darstellung 
{
  "tableRowStyle": {
    object (TableRowStyle)
  },
  "tableRowStyleSuggestionState": {
    object (TableRowStyleSuggestionState)
  }
}
Felder
tableRowStyle

object (TableRowStyle)

Eine TableRowStyle, die nur die Änderungen aus diesem Vorschlag enthält. Zusammen mit dem tableRowStyleSuggestionState können Sie so sehen, welche Felder sich geändert haben und welche neuen Werte sie haben.
tableRowStyleSuggestionState

object (TableRowStyleSuggestionState)

Eine Maske, die angibt, welche Felder im Basis-TableRowStyle in diesem Vorschlag geändert wurden.

TableRowStyleSuggestionState

Eine Maske, die angibt, welche Felder im Basis-TableRowStyle in diesem Vorschlag geändert wurden. Für jedes Feld, das auf „true“ gesetzt ist, gibt es einen neuen Vorschlag.

JSON-Darstellung 
{
  "minRowHeightSuggested": boolean
}
Felder
minRowHeightSuggested

boolean

Gibt an, ob eine Änderung für minRowHeight vorgeschlagen wurde.

TableStyle

Stile, die auf eine Tabelle angewendet werden.

JSON-Darstellung 
{
  "tableColumnProperties": [
    {
      object (TableColumnProperties)
    }
  ]
}
Felder
tableColumnProperties[]

object (TableColumnProperties)

Die Attribute der einzelnen Spalten.

In Google Docs enthalten Tabellen Zeilen und Zeilen Zellen, ähnlich wie in HTML. Die Eigenschaften für eine Zeile finden Sie also in der tableRowStyle der Zeile.

TableColumnProperties

Die Eigenschaften einer Spalte in einer Tabelle.

JSON-Darstellung 
{
  "widthType": enum (WidthType),
  "width": {
    object (Dimension)
  }
}
Felder
widthType

enum (WidthType)

Der Breite-Typ der Spalte.
width

object (Dimension)

Die Breite der Spalte. Wird festgelegt, wenn der widthType der Spalte FIXED_WIDTH ist.

WidthType

Der Typ der Spaltenbreite.

Enums
WIDTH_TYPE_UNSPECIFIED Der Spaltenbreitentyp ist nicht angegeben.
EVENLY_DISTRIBUTED

Die Spaltenbreite wird gleichmäßig auf die anderen gleichmäßig verteilten Spalten verteilt.

Die Breite der Spalte wird automatisch bestimmt und entspricht dem gleichen Anteil der für die Tabelle verbleibenden Breite nach Berücksichtigung aller Spalten mit angegebener Breite.
FIXED_WIDTH Eine feste Spaltenbreite. Die Breite der Spalte ist in der Eigenschaft [width][google.apps.docs.v1.TableColumnProperties.width] enthalten.

TableOfContents

Eine StructuralElement, die ein Inhaltsverzeichnis darstellt.

JSON-Darstellung 
{
  "content": [
    {
      object (StructuralElement)
    }
  ],
  "suggestedInsertionIds": [
    string
  ],
  "suggestedDeletionIds": [
    string
  ]
}
Felder
content[]

object (StructuralElement)

Der Inhalt des Inhaltsverzeichnisses.
suggestedInsertionIds[]

string

Die vorgeschlagenen Einfügungs-IDs. Ein TableOfContents kann mehrere Einfüge-IDs haben, wenn es sich um eine verschachtelte vorgeschlagene Änderung handelt. Wenn leer, handelt es sich nicht um eine vorgeschlagene Einfügung.
suggestedDeletionIds[]

string

Die IDs der vorgeschlagenen Löschungen. Wenn das Feld leer ist, gibt es keine vorgeschlagenen Löschungen für diese Inhalte.

Fußnote

Eine Dokumentfußnote.

JSON-Darstellung 
{
  "footnoteId": string,
  "content": [
    {
      object (StructuralElement)
    }
  ]
}
Felder
footnoteId

string

Die ID der Fußnote.
content[]

object (StructuralElement)

Der Inhalt der Fußnote.

Die Indexierung für den Inhalt einer Fußnote beginnt bei null.

DocumentStyle

Der Stil des Dokuments.

JSON-Darstellung 
{
  "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,
  "documentFormat": {
    object (DocumentFormat)
  }
}
Felder
background

object (Background)

Der Hintergrund des Dokuments. Dokumente dürfen keine transparente Hintergrundfarbe haben.
defaultHeaderId

string

Die ID des Standardheaders. Wenn nichts anderes festgelegt ist, gibt es keinen Standardheader.

Wenn [DocumentMode][google.apps.docs.v1.DocumentStyle.document_format.document_mode] PAGELESS ist, wird diese Eigenschaft nicht gerendert.

Dieses Attribut ist schreibgeschützt.
evenPageHeaderId

string

Die ID des Headers, der nur für gerade Seiten verwendet wird. Der Wert von useEvenPageHeaderFooter bestimmt, ob für die Kopfzeile auf geraden Seiten defaultHeaderId oder dieser Wert verwendet wird. Wenn nicht festgelegt, gibt es keinen geraden Seitenkopf.

Wenn [DocumentMode][google.apps.docs.v1.DocumentStyle.document_format.document_mode] PAGELESS ist, wird diese Eigenschaft nicht gerendert.

Dieses Attribut ist schreibgeschützt.
evenPageFooterId

string

Die ID der Fußzeile, die nur für gerade Seiten verwendet wird. Der Wert von useEvenPageHeaderFooter bestimmt, ob für die Fußzeile auf geraden Seiten defaultFooterId oder dieser Wert verwendet wird. Wenn nicht festgelegt, gibt es keine Fußzeile für gerade Seiten.

Wenn [DocumentMode][google.apps.docs.v1.DocumentStyle.document_format.document_mode] PAGELESS ist, wird diese Eigenschaft nicht gerendert.

Dieses Attribut ist schreibgeschützt.
firstPageHeaderId

string

Die ID des Headers, der nur für die erste Seite verwendet wird. Wenn nicht festgelegt, gibt es keine eindeutige Kopfzeile für die erste Seite. Der Wert von useFirstPageHeaderFooter bestimmt, ob für die Kopfzeile auf der ersten Seite defaultHeaderId oder dieser Wert verwendet wird. Wenn nicht festgelegt, gibt es keinen Header auf der ersten Seite.

Wenn [DocumentMode][google.apps.docs.v1.DocumentStyle.document_format.document_mode] PAGELESS ist, wird diese Eigenschaft nicht gerendert.

Dieses Attribut ist schreibgeschützt.
firstPageFooterId

string

Die ID der Fußzeile, die nur für die erste Seite verwendet wird. Wenn nicht festgelegt, ist keine eindeutige Fußzeile für die erste Seite vorhanden. Der Wert von useFirstPageHeaderFooter bestimmt, ob für die Fußzeile auf der ersten Seite defaultFooterId oder dieser Wert verwendet wird. Wenn die Richtlinie nicht festgelegt ist, gibt es keine Fußzeile auf der ersten Seite.

Wenn [DocumentMode][google.apps.docs.v1.DocumentStyle.document_format.document_mode] PAGELESS ist, wird diese Eigenschaft nicht gerendert.

Dieses Attribut ist schreibgeschützt.
useFirstPageHeaderFooter

boolean

Gibt an, ob die Kopf- und Fußzeilen-IDs der ersten Seite für die erste Seite verwendet werden sollen.

Wenn [DocumentMode][google.apps.docs.v1.DocumentStyle.document_format.document_mode] PAGELESS ist, wird diese Eigenschaft nicht gerendert.
useEvenPageHeaderFooter

boolean

Gibt an, ob die IDs für Kopf- und Fußzeilen auf geraden Seiten für die geraden Seiten verwendet werden sollen.

Wenn [DocumentMode][google.apps.docs.v1.DocumentStyle.document_format.document_mode] PAGELESS ist, wird diese Eigenschaft nicht gerendert.
pageNumberStart

integer

Die Seitenzahl, ab der die Anzahl der Seiten gezählt werden soll.

Wenn [DocumentMode][google.apps.docs.v1.DocumentStyle.document_format.document_mode] PAGELESS ist, wird diese Eigenschaft nicht gerendert.
marginTop

object (Dimension)

Der obere Seitenrand.

Wenn Sie den oberen Seitenrand im Dokumentstil aktualisieren, wird der obere Seitenrand in allen Abschnittsstilen gelöscht.

Wenn [DocumentMode][google.apps.docs.v1.DocumentStyle.document_format.document_mode] PAGELESS ist, wird diese Eigenschaft nicht gerendert.
marginBottom

object (Dimension)

Der untere Seitenrand.

Wenn Sie den unteren Seitenrand im Dokumentstil aktualisieren, wird der untere Seitenrand in allen Abschnittsstilen gelöscht.

Wenn [DocumentMode][google.apps.docs.v1.DocumentStyle.document_format.document_mode] PAGELESS ist, wird diese Eigenschaft nicht gerendert.
marginRight

object (Dimension)

Der rechte Seitenrand.

Wenn Sie den rechten Seitenrand im Dokumentstil aktualisieren, wird der rechte Seitenrand in allen Abschnittsstilen gelöscht. Außerdem kann es dazu führen, dass die Größe von Spalten in allen Abschnitten geändert wird.

Wenn [DocumentMode][google.apps.docs.v1.DocumentStyle.document_format.document_mode] PAGELESS ist, wird diese Eigenschaft nicht gerendert.
marginLeft

object (Dimension)

Der linke Seitenrand.

Wenn Sie den linken Seitenrand im Dokumentstil aktualisieren, wird der linke Seitenrand in allen Abschnittsstilen gelöscht. Außerdem kann es dazu führen, dass die Größe von Spalten in allen Abschnitten geändert wird.

Wenn [DocumentMode][google.apps.docs.v1.DocumentStyle.document_format.document_mode] PAGELESS ist, wird diese Eigenschaft nicht gerendert.
pageSize

object (Size)

Die Größe einer Seite im Dokument.

Wenn [DocumentMode][google.apps.docs.v1.DocumentStyle.document_format.document_mode] PAGELESS ist, wird diese Eigenschaft nicht gerendert.
marginHeader

object (Dimension)

Der Abstand zwischen dem oberen Seitenrand und dem Inhalt des Headers.

Wenn [DocumentMode][google.apps.docs.v1.DocumentStyle.document_format.document_mode] PAGELESS ist, wird diese Eigenschaft nicht gerendert.
flipPageOrientation

boolean

Optional. Gibt an, ob die Abmessungen des pageSize gespiegelt werden sollen. Dadurch kann die Seitenausrichtung zwischen Hoch- und Querformat geändert werden.

Wenn [DocumentMode][google.apps.docs.v1.DocumentStyle.document_format.document_mode] PAGELESS ist, wird diese Eigenschaft nicht gerendert.
documentFormat

object (DocumentFormat)

Gibt Formatierungseinstellungen auf Dokumentebene an, z. B. den Dokumentmodus (mit Seiten oder seitenlos).

Hintergrund

Stellt den Hintergrund eines Dokuments dar.

JSON-Darstellung 
{
  "color": {
    object (OptionalColor)
  }
}
Felder
color

object (OptionalColor)

Die Hintergrundfarbe.

Größe

Breite und Höhe.

JSON-Darstellung 
{
  "height": {
    object (Dimension)
  },
  "width": {
    object (Dimension)
  }
}
Felder
height

object (Dimension)

Die Höhe des Objekts.
width

object (Dimension)

Die Breite des Objekts.

DocumentFormat

Stellt Formatierungseinstellungen auf Dokumentebene dar.

JSON-Darstellung 
{
  "documentMode": enum (DocumentMode)
}
Felder
documentMode

enum (DocumentMode)

Gibt an, ob das Dokument Seiten hat oder seitenlos ist.

DocumentMode

Gibt an, ob das Dokument Seiten hat oder seitenlos ist.

Enums
DOCUMENT_MODE_UNSPECIFIED Der Dokumentmodus ist nicht angegeben.
PAGES Das Dokument hat Seiten.
PAGELESS Das Dokument ist seitenlos.

SuggestedDocumentStyle

Ein Änderungsvorschlag für DocumentStyle.

JSON-Darstellung 
{
  "documentStyle": {
    object (DocumentStyle)
  },
  "documentStyleSuggestionState": {
    object (DocumentStyleSuggestionState)
  }
}
Felder
documentStyle

object (DocumentStyle)

Eine DocumentStyle, die nur die Änderungen aus diesem Vorschlag enthält. Zusammen mit dem documentStyleSuggestionState können Sie so sehen, welche Felder sich geändert haben und welche neuen Werte sie haben.
documentStyleSuggestionState

object (DocumentStyleSuggestionState)

Eine Maske, die angibt, welche Felder im Basis-DocumentStyle in diesem Vorschlag geändert wurden.

DocumentStyleSuggestionState

Eine Maske, die angibt, welche Felder im Basis-DocumentStyle in diesem Vorschlag geändert wurden. Für jedes Feld, das auf „true“ gesetzt ist, gibt es einen neuen Vorschlag.

JSON-Darstellung 
{
  "backgroundSuggestionState": {
    object (BackgroundSuggestionState)
  },
  "defaultHeaderIdSuggested": boolean,
  "defaultFooterIdSuggested": boolean,
  "evenPageHeaderIdSuggested": boolean,
  "evenPageFooterIdSuggested": boolean,
  "firstPageHeaderIdSuggested": boolean,
  "firstPageFooterIdSuggested": boolean,
  "useFirstPageHeaderFooterSuggested": boolean,
  "useEvenPageHeaderFooterSuggested": boolean,
  "pageNumberStartSuggested": boolean,
  "marginTopSuggested": boolean,
  "marginBottomSuggested": boolean,
  "marginRightSuggested": boolean,
  "marginLeftSuggested": boolean,
  "pageSizeSuggestionState": {
    object (SizeSuggestionState)
  },
  "marginHeaderSuggested": boolean,
  "marginFooterSuggested": boolean,
  "useCustomHeaderFooterMarginsSuggested": boolean,
  "flipPageOrientationSuggested": boolean
}
Felder
backgroundSuggestionState

object (BackgroundSuggestionState)

Eine Maske, die angibt, welche Felder in background in diesem Vorschlag geändert wurden.
defaultHeaderIdSuggested

boolean

Gibt an, ob eine Änderung für defaultHeaderId vorgeschlagen wurde.
evenPageHeaderIdSuggested

boolean

Gibt an, ob eine Änderung für evenPageHeaderId vorgeschlagen wurde.
evenPageFooterIdSuggested

boolean

Gibt an, ob eine Änderung für evenPageFooterId vorgeschlagen wurde.
firstPageHeaderIdSuggested

boolean

Gibt an, ob eine Änderung für firstPageHeaderId vorgeschlagen wurde.
firstPageFooterIdSuggested

boolean

Gibt an, ob eine Änderung für firstPageFooterId vorgeschlagen wurde.
useFirstPageHeaderFooterSuggested

boolean

Gibt an, ob eine Änderung für useFirstPageHeaderFooter vorgeschlagen wurde.
useEvenPageHeaderFooterSuggested

boolean

Gibt an, ob eine Änderung für useEvenPageHeaderFooter vorgeschlagen wurde.
pageNumberStartSuggested

boolean

Gibt an, ob eine Änderung für pageNumberStart vorgeschlagen wurde.
marginTopSuggested

boolean

Gibt an, ob eine Änderung für marginTop vorgeschlagen wurde.
marginBottomSuggested

boolean

Gibt an, ob eine Änderung für marginBottom vorgeschlagen wurde.
marginRightSuggested

boolean

Gibt an, ob eine Änderung für marginRight vorgeschlagen wurde.
marginLeftSuggested

boolean

Gibt an, ob eine Änderung für marginLeft vorgeschlagen wurde.
pageSizeSuggestionState

object (SizeSuggestionState)

Eine Maske, die angibt, welche der Felder in [size] [google.apps.docs.v1.DocumentStyle.size] in diesem Vorschlag geändert wurden.
marginHeaderSuggested

boolean

Gibt an, ob eine Änderung für marginHeader vorgeschlagen wurde.
flipPageOrientationSuggested

boolean

Optional. Gibt an, ob eine Änderung für flipPageOrientation vorgeschlagen wurde.

BackgroundSuggestionState

Eine Maske, die angibt, welche Felder im Basis-Background in diesem Vorschlag geändert wurden. Für jedes Feld, das auf „true“ gesetzt ist, hat Backgound einen neuen vorgeschlagenen Wert.

JSON-Darstellung 
{
  "backgroundColorSuggested": boolean
}
Felder
backgroundColorSuggested

boolean

Gibt an, ob die aktuelle Hintergrundfarbe in diesem Vorschlag geändert wurde.

SizeSuggestionState

Eine Maske, die angibt, welche Felder im Basis-Size in diesem Vorschlag geändert wurden. Für jedes Feld, das auf „true“ gesetzt ist, hat Size einen neuen vorgeschlagenen Wert.

JSON-Darstellung 
{
  "heightSuggested": boolean,
  "widthSuggested": boolean
}
Felder
heightSuggested

boolean

Gibt an, ob eine Änderung für height vorgeschlagen wurde.
widthSuggested

boolean

Gibt an, ob eine Änderung für width vorgeschlagen wurde.

NamedStyles

Die benannten Formatierungen. Absätze im Dokument können ihre TextStyle und ParagraphStyle von diesen benannten Formatvorlagen übernehmen.

JSON-Darstellung 
{
  "styles": [
    {
      object (NamedStyle)
    }
  ]
}
Felder
styles[]

object (NamedStyle)

Die benannten Formatierungen.

Für jede der möglichen named style types gibt es einen Eintrag.

NamedStyle

Ein benannter Stil. Absätze im Dokument können ihre TextStyle und ParagraphStyle von diesem benannten Stil übernehmen, wenn sie denselben benannten Stiltyp haben.

JSON-Darstellung 
{
  "namedStyleType": enum (NamedStyleType),
  "textStyle": {
    object (TextStyle)
  },
  "paragraphStyle": {
    object (ParagraphStyle)
  }
}
Felder
namedStyleType

enum (NamedStyleType)

Der Typ dieser benannten Formatvorlage.
textStyle

object (TextStyle)

Der Textstil dieser benannten Formatvorlage.
paragraphStyle

object (ParagraphStyle)

Der Absatzstil dieses benannten Stils.

SuggestedNamedStyles

Ein Änderungsvorschlag für NamedStyles.

JSON-Darstellung 
{
  "namedStyles": {
    object (NamedStyles)
  },
  "namedStylesSuggestionState": {
    object (NamedStylesSuggestionState)
  }
}
Felder
namedStyles

object (NamedStyles)

Eine NamedStyles, die nur die Änderungen aus diesem Vorschlag enthält. Zusammen mit dem namedStylesSuggestionState können Sie so sehen, welche Felder sich geändert haben und welche neuen Werte sie haben.
namedStylesSuggestionState

object (NamedStylesSuggestionState)

Eine Maske, die angibt, welche Felder im Basis-NamedStyles in diesem Vorschlag geändert wurden.

NamedStylesSuggestionState

Der Vorschlagsstatus einer NamedStyles-Nachricht.

JSON-Darstellung 
{
  "stylesSuggestionStates": [
    {
      object (NamedStyleSuggestionState)
    }
  ]
}
Felder
stylesSuggestionStates[]

object (NamedStyleSuggestionState)

Eine Maske, die angibt, welche Felder des entsprechenden NamedStyle in styles in diesem Vorschlag geändert wurden.

Die Reihenfolge dieser benannten Stilvorschlagsstatus entspricht der Reihenfolge des entsprechenden benannten Stils im named styles-Vorschlag.

NamedStyleSuggestionState

Der Vorschlagsstatus einer NamedStyle-Nachricht.

JSON-Darstellung 
{
  "namedStyleType": enum (NamedStyleType),
  "textStyleSuggestionState": {
    object (TextStyleSuggestionState)
  },
  "paragraphStyleSuggestionState": {
    object (ParagraphStyleSuggestionState)
  }
}
Felder
namedStyleType

enum (NamedStyleType)

Der benannte Stiltyp, dem dieser Vorschlagsstatus entspricht.

Dieses Feld wird zur Vereinfachung bereitgestellt, um den NamedStyleSuggestionState mit dem entsprechenden NamedStyle abzugleichen.
textStyleSuggestionState

object (TextStyleSuggestionState)

Eine Maske, die angibt, welche Felder in text style in diesem Vorschlag geändert wurden.
paragraphStyleSuggestionState

object (ParagraphStyleSuggestionState)

Eine Maske, die angibt, welche Felder in paragraph style in diesem Vorschlag geändert wurden.

Liste

Ein List-Objekt stellt die Listenattribute für eine Gruppe von Absätzen dar, die alle zur selben Liste gehören. Ein Absatz, der Teil einer Liste ist, hat in seinem bullet einen Verweis auf die ID der Liste.

JSON-Darstellung 
{
  "listProperties": {
    object (ListProperties)
  },
  "suggestedListPropertiesChanges": {
    string: {
      object (SuggestedListProperties)
    },
    ...
  },
  "suggestedInsertionId": string,
  "suggestedDeletionIds": [
    string
  ]
}
Felder
listProperties

object (ListProperties)

Die Eigenschaften der Liste.
suggestedListPropertiesChanges

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

Die vorgeschlagenen Änderungen an den Listeneigenschaften, die nach Vorschlags-ID sortiert sind.
suggestedInsertionId

string

Die ID des vorgeschlagenen Einfügens. Wenn leer, handelt es sich nicht um eine vorgeschlagene Einfügung.
suggestedDeletionIds[]

string

Die IDs der vorgeschlagenen Löschungen. Wenn die Liste leer ist, gibt es keine vorgeschlagenen Löschungen für diese Liste.

ListProperties

Die Attribute eines list, die das Erscheinungsbild von Aufzählungszeichen beschreiben, die zu Absätzen gehören, die mit einer Liste verknüpft sind.

JSON-Darstellung 
{
  "nestingLevels": [
    {
      object (NestingLevel)
    }
  ]
}
Felder
nestingLevels[]

object (NestingLevel)

Beschreibt die Eigenschaften der Aufzählungszeichen auf der zugehörigen Ebene.

Eine Liste kann maximal 9 Verschachtelungsebenen haben. Die oberste Ebene entspricht der Verschachtelungsebene 0 und die am stärksten verschachtelte Ebene der Verschachtelungsebene 8. Die Verschachtelungsebenen werden in aufsteigender Reihenfolge zurückgegeben, wobei die am wenigsten verschachtelte Ebene zuerst zurückgegeben wird.

NestingLevel

Enthält Eigenschaften, die das Erscheinungsbild eines Listenzeichens auf einer bestimmten Verschachtelungsebene beschreiben.

JSON-Darstellung 
{
  "bulletAlignment": enum (BulletAlignment),
  "glyphFormat": string,
  "indentFirstLine": {
    object (Dimension)
  },
  "indentStart": {
    object (Dimension)
  },
  "textStyle": {
    object (TextStyle)
  },
  "startNumber": integer,

  "glyphType": enum (GlyphType),
  "glyphSymbol": string
}
Felder
bulletAlignment

enum (BulletAlignment)

Die Ausrichtung des Aufzählungszeichens im für das Rendern des Aufzählungszeichens zugewiesenen Bereich.
glyphFormat

string

Die Formatierungszeichenfolge, die für Aufzählungszeichen auf dieser Verschachtelungsebene verwendet wird.

Das Glyphenformat enthält einen oder mehrere Platzhalter, die je nach glyphType oder glyphSymbol durch die entsprechenden Werte ersetzt werden. Die Platzhalter folgen dem Muster %[nestingLevel]. Außerdem können Platzhalter Präfixe und Suffixe haben. Das Glyphenformat folgt also dem Muster <prefix>%[nestingLevel]<suffix>. Präfix und Suffix sind optional und können beliebige Strings sein.

Das Glyphenformat %0. gibt beispielsweise an, dass der gerenderte Glyph den Platzhalter durch den entsprechenden Glyph für die Verschachtelungsebene 0 ersetzt und ein Punkt als Suffix angehängt wird. Eine Liste mit dem Glyphentyp UPPER_ALPHA und dem Glyphenformat %0. auf der Verschachtelungsebene 0 führt also zu einer Liste mit gerenderten Glyphen.

A.

B.

C.

Das Glyphenformat kann Platzhalter für die aktuelle Verschachtelungsebene sowie Platzhalter für übergeordnete Verschachtelungsebenen enthalten. Eine Liste kann beispielsweise das Glyphenformat %0. auf Verschachtelungsebene 0 und das Glyphenformat %0.%1. auf Verschachtelungsebene 1 haben. Wenn beide Verschachtelungsebenen DECIMAL-Glyphentypen haben, wird eine Liste mit gerenderten Glyphen erstellt.

1.

2.

2.1.

2.2.

3.

Bei geordneten Verschachtelungsebenen hängt der String, der einen Platzhalter im Glyphenformat für einen bestimmten Absatz ersetzt, von der Reihenfolge des Absatzes in der Liste ab.
indentFirstLine

object (Dimension)

Die Einrückung für die erste Zeile von Absätzen auf dieser Verschachtelungsebene.
indentStart

object (Dimension)

Die Einrückung für Absätze auf dieser Verschachtelungsebene. Wird auf die Seite angewendet, die dem Beginn des Texts entspricht, basierend auf der Inhaltsrichtung des Absatzes.
textStyle

object (TextStyle)

Der Textstil der Aufzählungszeichen auf dieser Verschachtelungsebene.
startNumber

integer

Die Nummer des ersten Listeneintrags auf dieser Verschachtelungsebene.

Ein Wert von 0 wird für Listen mit Buchstaben und römischen Ziffern als Wert von 1 behandelt. Bei Werten von 0 und 1 beginnen Listen mit Buchstaben und römischen Ziffern mit a bzw. i.

Dieser Wert wird für Schachtelungsebenen mit ungeordneten Glyphen ignoriert.
Die Art des Symbols, das für Aufzählungszeichen verwendet wird. Hier wird das Aufzählungszeichen definiert, das die Platzhalter in der glyph_format ersetzt. Im Folgenden finden Sie eine Liste von sich gegenseitig ausschließenden Feldern. In einer Antwort wird höchstens eines der Felder festgelegt:
glyphType

enum (GlyphType)

Der Typ des Glyphen, der für Aufzählungszeichen verwendet wird, wenn Absätze auf dieser Verschachtelungsebene sortiert werden.

Der Glyphentyp bestimmt den Typ des Glyphen, der zum Ersetzen von Platzhaltern in glyphFormat verwendet wird, wenn Absätze auf dieser Verschachtelungsebene sortiert werden. Wenn die Schachtelungsebene beispielsweise 0, der glyphFormat-Wert %0. und der Glyphentyp DECIMAL ist, wird der Platzhalter %0 im Glyphenformat durch eine Zahl ersetzt, die der Reihenfolge des Listenelements in der Liste entspricht.
glyphSymbol

string

Ein benutzerdefiniertes Glyphensymbol, das für Aufzählungszeichen verwendet wird, wenn Absätze auf dieser Verschachtelungsebene ungeordnet sind.

Das Glyphensymbol ersetzt Platzhalter innerhalb von glyphFormat. Wenn das „glyphSymbol“ beispielsweise der ausgefüllte Kreis ist, der dem Unicode-Codepunkt U+25cf entspricht, und glyphFormat %0 ist, wäre das gerenderte Glyphen-Symbol der ausgefüllte Kreis.
Ende der sich gegenseitig ausschließenden Felder.

BulletAlignment

Die Ausrichtungstypen für ein Aufzählungszeichen.

Enums
BULLET_ALIGNMENT_UNSPECIFIED Die Ausrichtung der Aufzählungszeichen ist nicht angegeben.
START Das Aufzählungszeichen wird am Anfang des für das Rendern des Aufzählungszeichens zugewiesenen Bereichs ausgerichtet. Bei LTR-Text linksbündig, ansonsten rechtsbündig.
CENTER Das Aufzählungszeichen wird an der Mitte des für das Rendern des Aufzählungszeichens zugewiesenen Bereichs ausgerichtet.
END Das Aufzählungszeichen wird am Ende des für das Rendern des Aufzählungszeichens zugewiesenen Bereichs ausgerichtet. Bei rechtsläufigem Text rechtsbündig, ansonsten linksbündig.

GlyphType

Die Arten von Glyphen, die für Aufzählungszeichen verwendet werden, wenn Absätze auf dieser Verschachtelungsebene sortiert werden.

Enums
GLYPH_TYPE_UNSPECIFIED Der Glyphentyp ist nicht angegeben oder wird nicht unterstützt.
NONE Leerer String.
DECIMAL Eine Zahl wie 1, 2 oder 3.
ZERO_DECIMAL Eine Zahl, bei der einstellige Zahlen mit einer Null beginnen, z. B. 01, 02 oder 03. Zahlen mit mehr als einer Ziffer werden nicht mit einer Null versehen.
UPPER_ALPHA Ein Großbuchstabe, z. B. A, B oder C.
ALPHA Ein Kleinbuchstabe wie a, b oder c.
UPPER_ROMAN Eine römische Ziffer in Großbuchstaben, z. B. I, II oder III.
ROMAN Eine römische Zahl in Kleinbuchstaben, z. B. i, ii oder iii.

SuggestedListProperties

Ein Änderungsvorschlag für ListProperties.

JSON-Darstellung 
{
  "listProperties": {
    object (ListProperties)
  },
  "listPropertiesSuggestionState": {
    object (ListPropertiesSuggestionState)
  }
}
Felder
listProperties

object (ListProperties)

Eine ListProperties, die nur die Änderungen aus diesem Vorschlag enthält. Zusammen mit dem listPropertiesSuggestionState können Sie so sehen, welche Felder sich geändert haben und welche neuen Werte sie haben.
listPropertiesSuggestionState

object (ListPropertiesSuggestionState)

Eine Maske, die angibt, welche Felder im Basis-ListProperties in diesem Vorschlag geändert wurden.

ListPropertiesSuggestionState

Eine Maske, die angibt, welche Felder im Basis-ListProperties in diesem Vorschlag geändert wurden. Für jedes Feld, das auf „true“ gesetzt ist, gibt es einen neuen Vorschlag.

JSON-Darstellung 
{
  "nestingLevelsSuggestionStates": [
    {
      object (NestingLevelSuggestionState)
    }
  ]
}
Felder
nestingLevelsSuggestionStates[]

object (NestingLevelSuggestionState)

Eine Maske, die angibt, welche Felder des entsprechenden NestingLevel in nestingLevels in diesem Vorschlag geändert wurden.

Die Vorschläge für die Verschachtelungsebene werden in aufsteigender Reihenfolge der Verschachtelungsebene zurückgegeben, wobei die am wenigsten verschachtelte Ebene zuerst zurückgegeben wird.

NestingLevelSuggestionState

Eine Maske, die angibt, welche Felder im Basis-NestingLevel in diesem Vorschlag geändert wurden. Für jedes Feld, das auf „true“ gesetzt ist, gibt es einen neuen Vorschlag.

JSON-Darstellung 
{
  "bulletAlignmentSuggested": boolean,
  "glyphTypeSuggested": boolean,
  "glyphFormatSuggested": boolean,
  "glyphSymbolSuggested": boolean,
  "indentFirstLineSuggested": boolean,
  "indentStartSuggested": boolean,
  "textStyleSuggestionState": {
    object (TextStyleSuggestionState)
  },
  "startNumberSuggested": boolean
}
Felder
bulletAlignmentSuggested

boolean

Gibt an, ob eine Änderung für bulletAlignment vorgeschlagen wurde.
glyphTypeSuggested

boolean

Gibt an, ob eine Änderung für glyphType vorgeschlagen wurde.
glyphFormatSuggested

boolean

Gibt an, ob eine Änderung für glyphFormat vorgeschlagen wurde.
glyphSymbolSuggested

boolean

Gibt an, ob eine Änderung für glyphSymbol vorgeschlagen wurde.
indentFirstLineSuggested

boolean

Gibt an, ob eine Änderung für indentFirstLine vorgeschlagen wurde.
indentStartSuggested

boolean

Gibt an, ob eine Änderung für indentStart vorgeschlagen wurde.
textStyleSuggestionState

object (TextStyleSuggestionState)

Eine Maske, die angibt, welche Felder in text style in diesem Vorschlag geändert wurden.
startNumberSuggested

boolean

Gibt an, ob eine Änderung für startNumber vorgeschlagen wurde.

NamedRanges

Eine Sammlung aller NamedRange im Dokument, die einen bestimmten Namen haben.

JSON-Darstellung 
{
  "name": string,
  "namedRanges": [
    {
      object (NamedRange)
    }
  ]
}
Felder
name

string

Der Name, den alle named ranges gemeinsam haben.
namedRanges[]

object (NamedRange)

Die NamedRanges mit demselben Namen.

NamedRange

Eine Sammlung von Ranges mit derselben ID für den benannten Bereich.

Mit benannten Bereichen können Entwickler Teile eines Dokuments mit einem beliebigen benutzerdefinierten Label verknüpfen, sodass die Inhalte später programmatisch gelesen oder bearbeitet werden können. Ein Dokument kann mehrere benannte Bereiche mit demselben Namen enthalten, aber jeder benannte Bereich hat eine eindeutige ID.

Ein benannter Bereich wird mit einem einzelnen Range erstellt. Wenn Inhalte in einen benannten Bereich eingefügt werden, wird dieser Bereich in der Regel erweitert. Bestimmte Änderungen am Dokument können jedoch dazu führen, dass der Bereich in mehrere Bereiche aufgeteilt wird.

Benannte Bereiche sind nicht privat. Alle Anwendungen und Mitbearbeiter, die Zugriff auf das Dokument haben, können die benannten Bereiche sehen.

JSON-Darstellung 
{
  "namedRangeId": string,
  "name": string,
  "ranges": [
    {
      object (Range)
    }
  ]
}
Felder
namedRangeId

string

Die ID des benannten Bereichs.
name

string

Der Name des benannten Bereichs.
ranges[]

object (Range)

Die Bereiche, die zu diesem benannten Bereich gehören.

Bereich

Gibt einen zusammenhängenden Textbereich an.

JSON-Darstellung 
{
  "segmentId": string,
  "startIndex": integer,
  "endIndex": integer,
  "tabId": string
}
Felder
segmentId

string

Die ID der Kopfzeile, Fußzeile oder Fußnote, in der sich dieser Bereich befindet. Eine leere Segment-ID kennzeichnet den Hauptteil des Dokuments.
startIndex

integer

Der nullbasierte Startindex dieses Bereichs in UTF-16-Codeeinheiten.

Bei allen aktuellen Verwendungszwecken muss ein Startindex angegeben werden. Dieses Feld ist ein Int32Value, um zukünftige Anwendungsfälle mit offenen Bereichen zu berücksichtigen.
endIndex

integer

Der nullbasierte Endindex dieses Bereichs (exklusiv) in UTF-16-Codeeinheiten.

Bei allen aktuellen Verwendungszwecken muss ein Endindex angegeben werden. Dieses Feld ist ein Int32Value, um zukünftige Anwendungsfälle mit offenen Bereichen zu berücksichtigen.
tabId

string

Der Tab, der diesen Bereich enthält. Wenn dieser Parameter nicht angegeben wird, bezieht sich die Anfrage auf den ersten Tab.

In einem Dokument mit nur einem Tab:

  • Muss, sofern angegeben, mit der ID des einzelnen Tabs übereinstimmen.

  • Wenn nichts angegeben ist, bezieht sich die Anfrage auf den einzelnen Tab.

So fügen Sie in einem Dokument mit mehreren Tabs einen Link ein:

  • Falls angegeben, bezieht sich die Anfrage auf den angegebenen Tab.

  • Wird nichts angegeben, bezieht sich die Anfrage auf den ersten Tab im Dokument.

InlineObject

Ein Objekt, das in einer Textzeile angezeigt wird. Ein InlineObject enthält ein EmbeddedObject, z. B. ein Bild.

JSON-Darstellung 
{
  "objectId": string,
  "inlineObjectProperties": {
    object (InlineObjectProperties)
  },
  "suggestedInlineObjectPropertiesChanges": {
    string: {
      object (SuggestedInlineObjectProperties)
    },
    ...
  },
  "suggestedInsertionId": string,
  "suggestedDeletionIds": [
    string
  ]
}
Felder
objectId

string

Die ID dieses Inline-Objekts. Kann verwendet werden, um die Eigenschaften eines Objekts zu aktualisieren.
inlineObjectProperties

object (InlineObjectProperties)

Die Eigenschaften dieses Inline-Objekts.
suggestedInlineObjectPropertiesChanges

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

Die vorgeschlagenen Änderungen an den Inline-Objekteigenschaften, die nach Vorschlags-ID sortiert sind.
suggestedInsertionId

string

Die ID des vorgeschlagenen Einfügens. Wenn leer, handelt es sich nicht um eine vorgeschlagene Einfügung.
suggestedDeletionIds[]

string

Die IDs der vorgeschlagenen Löschungen. Wenn das Feld leer ist, gibt es keine vorgeschlagenen Löschungen für diese Inhalte.

InlineObjectProperties

Eigenschaften eines InlineObject.

JSON-Darstellung 
{
  "embeddedObject": {
    object (EmbeddedObject)
  }
}
Felder
embeddedObject

object (EmbeddedObject)

Das eingebettete Objekt dieses Inline-Objekts.

EmbeddedObject

Ein eingebettetes Objekt im Dokument.

JSON-Darstellung 
{
  "title": string,
  "description": string,
  "embeddedObjectBorder": {
    object (EmbeddedObjectBorder)
  },
  "size": {
    object (Size)
  },
  "marginTop": {
    object (Dimension)
  },
  "marginBottom": {
    object (Dimension)
  },
  "marginRight": {
    object (Dimension)
  },
  "marginLeft": {
    object (Dimension)
  },
  "linkedContentReference": {
    object (LinkedContentReference)
  },

  "embeddedDrawingProperties": {
    object (EmbeddedDrawingProperties)
  },
  "imageProperties": {
    object (ImageProperties)
  }
}
Felder
title

string

Der Titel des eingebetteten Objekts. Die Attribute title und description werden kombiniert, um Alt-Text anzuzeigen.
description

string

Die Beschreibung des eingebetteten Objekts. Die Attribute title und description werden kombiniert, um Alt-Text anzuzeigen.
embeddedObjectBorder

object (EmbeddedObjectBorder)

Der Rahmen des eingebetteten Objekts.
size

object (Size)

Die sichtbare Größe des Bildes nach dem Zuschneiden.
marginTop

object (Dimension)

Der obere Rand des eingebetteten Objekts.
marginBottom

object (Dimension)

Der untere Rand des eingebetteten Objekts.
marginRight

object (Dimension)

Der rechte Rand des eingebetteten Objekts.
marginLeft

object (Dimension)

Der linke Rand des eingebetteten Objekts.
linkedContentReference

object (LinkedContentReference)

Ein Verweis auf die extern verlinkten Quellinhalte. Wenn das eingebettete Objekt beispielsweise ein verknüpftes Diagramm ist, enthält es einen Verweis auf das Quelldiagramm in Google Tabellen.

Wenn nicht festgelegt, wird das eingebettete Objekt nicht verknüpft.
Die Attribute, die für jeden eingebetteten Objekttyp spezifisch sind. Im Folgenden finden Sie eine Liste von sich gegenseitig ausschließenden Feldern. In einer Antwort wird höchstens eines der Felder festgelegt:
embeddedDrawingProperties

object (EmbeddedDrawingProperties)

Die Eigenschaften einer eingebetteten Zeichnung.
imageProperties

object (ImageProperties)

Die Eigenschaften eines Bildes.
Ende der sich gegenseitig ausschließenden Felder.

EmbeddedDrawingProperties

Dieser Typ hat keine Felder.

Die Eigenschaften einer eingebetteten Zeichnung werden verwendet, um den Objekttyp zu unterscheiden. Eine eingebettete Zeichnung wird in einem Dokument erstellt und bearbeitet. Beachten Sie, dass keine ausführlichen Details unterstützt werden.

ImageProperties

Die Eigenschaften eines Bildes.

JSON-Darstellung 
{
  "contentUri": string,
  "sourceUri": string,
  "brightness": number,
  "contrast": number,
  "transparency": number,
  "cropProperties": {
    object (CropProperties)
  },
  "angle": number
}
Felder
contentUri

string

Ein URI zum Bild mit einer Standardlebensdauer von 30 Minuten. Dieser URI ist mit dem Konto des Antragstellers getaggt. Jeder, der den URI hat, greift auf das Bild zu, als wäre er der ursprüngliche Anfragesteller. Der Zugriff auf das Bild kann verloren gehen, wenn sich die Freigabeeinstellungen des Dokuments ändern.
sourceUri

string

Der Quell-URI ist der URI, der zum Einfügen des Bildes verwendet wurde. Der Quell-URI kann leer sein.
brightness

number

Der Helligkeitseffekt des Bildes. Der Wert sollte im Intervall [-1,0, 1,0] liegen. 0 bedeutet, dass es keine Auswirkungen gibt.
contrast

number

Der Kontrasteffekt des Bildes. Der Wert sollte im Intervall [-1,0, 1,0] liegen. 0 bedeutet, dass es keine Auswirkungen gibt.
transparency

number

Der Transparenzeffekt des Bildes. Der Wert sollte im Intervall [0,0, 1,0] liegen, wobei 0 keine Wirkung und 1 transparent bedeutet.
cropProperties

object (CropProperties)

Die Zuschneideeigenschaften des Bildes.
angle

number

Der Drehwinkel des Bildes im Uhrzeigersinn in Radiant.

CropProperties

Die Zuschneideeigenschaften eines Bildes.

Das Zuschneiderechteck wird durch fraktionale Offsets von den vier Rändern des Originalinhalts dargestellt.

  • Wenn der Offset im Intervall (0, 1) liegt, wird die entsprechende Kante des Zuschneiderechtecks innerhalb des ursprünglichen Begrenzungsrechtecks des Bildes positioniert.
  • Wenn der Offset negativ oder größer als 1 ist, wird die entsprechende Kante des Zuschneiderechtecks außerhalb des ursprünglichen Begrenzungsrechtecks des Bildes positioniert.
  • Wenn alle Offsets und Drehwinkel 0 sind, wird das Bild nicht zugeschnitten.
JSON-Darstellung 
{
  "offsetLeft": number,
  "offsetRight": number,
  "offsetTop": number,
  "offsetBottom": number,
  "angle": number
}
Felder
offsetLeft

number

Der Offset gibt an, wie weit der linke Rand des Zuschneiderechtecks vom linken Rand des Originalinhalts entfernt ist. Er wird als Bruchteil der Breite des Originalinhalts angegeben.
offsetRight

number

Der Offset gibt an, wie weit die rechte Kante des Zuschneiderechtecks als Bruchteil der Breite des Originalinhalts von der rechten Kante des Originalinhalts entfernt ist.
offsetTop

number

Der Offset gibt an, wie weit der obere Rand des Zuschneiderechtecks vom oberen Rand des Originalinhalts entfernt ist, ausgedrückt als Bruchteil der Höhe des Originalinhalts.
offsetBottom

number

Der Offset gibt an, wie weit die Unterkante des Zuschneiderechtecks von der Unterkante des Originalinhalts entfernt ist, ausgedrückt als Bruchteil der Höhe des Originalinhalts.
angle

number

Der Winkel der Drehung des Zuschneiderechtecks um seinen Mittelpunkt im Uhrzeigersinn in Radiant. Die Drehung wird nach den Offsets angewendet.

EmbeddedObjectBorder

Ein Rahmen um ein EmbeddedObject.

JSON-Darstellung 
{
  "color": {
    object (OptionalColor)
  },
  "width": {
    object (Dimension)
  },
  "dashStyle": enum (DashStyle),
  "propertyState": enum (PropertyState)
}
Felder
color

object (OptionalColor)

Die Farbe des Rahmens.
width

object (Dimension)

Die Breite des Rahmens.
dashStyle

enum (DashStyle)

Der Strichstil des Rahmens.
propertyState

enum (PropertyState)

Der Status der Grenzlinie.

PropertyState

Mögliche Status einer Property.

Enums
RENDERED Wenn der Status eines Attributs RENDERED ist, hat das Element das entsprechende Attribut, wenn es im Dokument gerendert wird. „Immer“ ist der Standardwert.
NOT_RENDERED Wenn der Status einer Eigenschaft NOT_RENDERED ist, hat das Element beim Rendern im Dokument nicht die entsprechende Eigenschaft.

LinkedContentReference

Ein Verweis auf die extern verlinkten Quellinhalte.

JSON-Darstellung 
{

  "sheetsChartReference": {
    object (SheetsChartReference)
  }
}
Felder
Die Referenz für den Typ der verknüpften Inhalte. Im Folgenden finden Sie eine Liste von sich gegenseitig ausschließenden Feldern. In einer Antwort wird höchstens eines der Felder festgelegt:
sheetsChartReference

object (SheetsChartReference)

Ein Verweis auf das verknüpfte Diagramm.
Ende der sich gegenseitig ausschließenden Felder.

SheetsChartReference

Ein Verweis auf ein verknüpftes Diagramm, das aus Google Sheets eingebettet wurde.

JSON-Darstellung 
{
  "spreadsheetId": string,
  "chartId": integer
}
Felder
spreadsheetId

string

Die ID der Google-Tabelle, die das Quelldiagramm enthält.
chartId

integer

Die ID des spezifischen Diagramms in der eingebetteten Google-Tabelle.

SuggestedInlineObjectProperties

Ein Änderungsvorschlag für InlineObjectProperties.

JSON-Darstellung 
{
  "inlineObjectProperties": {
    object (InlineObjectProperties)
  },
  "inlineObjectPropertiesSuggestionState": {
    object (InlineObjectPropertiesSuggestionState)
  }
}
Felder
inlineObjectProperties

object (InlineObjectProperties)

Eine InlineObjectProperties, die nur die Änderungen aus diesem Vorschlag enthält. Zusammen mit dem inlineObjectPropertiesSuggestionState können Sie so sehen, welche Felder sich geändert haben und welche neuen Werte sie haben.
inlineObjectPropertiesSuggestionState

object (InlineObjectPropertiesSuggestionState)

Eine Maske, die angibt, welche Felder im Basis-InlineObjectProperties in diesem Vorschlag geändert wurden.

InlineObjectPropertiesSuggestionState

Eine Maske, die angibt, welche Felder im Basis-InlineObjectProperties in diesem Vorschlag geändert wurden. Für jedes Feld, das auf „true“ gesetzt ist, gibt es einen neuen Vorschlag.

JSON-Darstellung 
{
  "embeddedObjectSuggestionState": {
    object (EmbeddedObjectSuggestionState)
  }
}
Felder
embeddedObjectSuggestionState

object (EmbeddedObjectSuggestionState)

Eine Maske, die angibt, welche Felder in embeddedObject in diesem Vorschlag geändert wurden.

EmbeddedObjectSuggestionState

Eine Maske, die angibt, welche Felder im Basis-EmbeddedObject in diesem Vorschlag geändert wurden. Für jedes Feld, das auf „true“ gesetzt ist, gibt es einen neuen Vorschlag.

JSON-Darstellung 
{
  "embeddedDrawingPropertiesSuggestionState": {
    object (EmbeddedDrawingPropertiesSuggestionState)
  },
  "imagePropertiesSuggestionState": {
    object (ImagePropertiesSuggestionState)
  },
  "titleSuggested": boolean,
  "descriptionSuggested": boolean,
  "embeddedObjectBorderSuggestionState": {
    object (EmbeddedObjectBorderSuggestionState)
  },
  "sizeSuggestionState": {
    object (SizeSuggestionState)
  },
  "marginLeftSuggested": boolean,
  "marginRightSuggested": boolean,
  "marginTopSuggested": boolean,
  "marginBottomSuggested": boolean,
  "linkedContentReferenceSuggestionState": {
    object (LinkedContentReferenceSuggestionState)
  }
}
Felder
embeddedDrawingPropertiesSuggestionState

object (EmbeddedDrawingPropertiesSuggestionState)

Eine Maske, die angibt, welche Felder in embeddedDrawingProperties in diesem Vorschlag geändert wurden.
imagePropertiesSuggestionState

object (ImagePropertiesSuggestionState)

Eine Maske, die angibt, welche Felder in imageProperties in diesem Vorschlag geändert wurden.
titleSuggested

boolean

Gibt an, ob eine Änderung für title vorgeschlagen wurde.
descriptionSuggested

boolean

Gibt an, ob eine Änderung für description vorgeschlagen wurde.
embeddedObjectBorderSuggestionState

object (EmbeddedObjectBorderSuggestionState)

Eine Maske, die angibt, welche Felder in embeddedObjectBorder in diesem Vorschlag geändert wurden.
sizeSuggestionState

object (SizeSuggestionState)

Eine Maske, die angibt, welche Felder in size in diesem Vorschlag geändert wurden.
marginLeftSuggested

boolean

Gibt an, ob eine Änderung für marginLeft vorgeschlagen wurde.
marginRightSuggested

boolean

Gibt an, ob eine Änderung für marginRight vorgeschlagen wurde.
marginTopSuggested

boolean

Gibt an, ob eine Änderung für marginTop vorgeschlagen wurde.
marginBottomSuggested

boolean

Gibt an, ob eine Änderung für marginBottom vorgeschlagen wurde.
linkedContentReferenceSuggestionState

object (LinkedContentReferenceSuggestionState)

Eine Maske, die angibt, welche Felder in linkedContentReference in diesem Vorschlag geändert wurden.

EmbeddedDrawingPropertiesSuggestionState

Dieser Typ hat keine Felder.

Eine Maske, die angibt, welche Felder im Basis-EmbeddedDrawingProperties in diesem Vorschlag geändert wurden. Für jedes Feld, das auf „true“ gesetzt ist, gibt es einen neuen Vorschlag.

ImagePropertiesSuggestionState

Eine Maske, die angibt, welche Felder im Basis-ImageProperties in diesem Vorschlag geändert wurden. Für jedes Feld, das auf „true“ gesetzt ist, gibt es einen neuen Vorschlag.

JSON-Darstellung 
{
  "contentUriSuggested": boolean,
  "sourceUriSuggested": boolean,
  "brightnessSuggested": boolean,
  "contrastSuggested": boolean,
  "transparencySuggested": boolean,
  "cropPropertiesSuggestionState": {
    object (CropPropertiesSuggestionState)
  },
  "angleSuggested": boolean
}
Felder
contentUriSuggested

boolean

Gibt an, ob eine Änderung für contentUri vorgeschlagen wurde.
sourceUriSuggested

boolean

Gibt an, ob eine Änderung für [sourceUri] ([google.apps.docs.v1.EmbeddedObject.source_uri]) vorgeschlagen wurde.
brightnessSuggested

boolean

Gibt an, ob eine Änderung der [Helligkeit] [google.apps.docs.v1.EmbeddedObject.brightness] vorgeschlagen wurde.
contrastSuggested

boolean

Gibt an, ob eine Änderung des Kontrasts [contrast] [google.apps.docs.v1.EmbeddedObject.contrast] vorgeschlagen wurde.
transparencySuggested

boolean

Gibt an, ob eine Änderung für [transparency] ([google.apps.docs.v1.EmbeddedObject.transparency]) vorgeschlagen wurde.
cropPropertiesSuggestionState

object (CropPropertiesSuggestionState)

Eine Maske, die angibt, welche Felder in cropProperties in diesem Vorschlag geändert wurden.
angleSuggested

boolean

Gibt an, ob eine Änderung für [angle] [google.apps.docs.v1.EmbeddedObject.angle] vorgeschlagen wurde.

CropPropertiesSuggestionState

Eine Maske, die angibt, welche Felder im Basis-CropProperties in diesem Vorschlag geändert wurden. Für jedes Feld, das auf „true“ gesetzt ist, gibt es einen neuen Vorschlag.

JSON-Darstellung 
{
  "offsetLeftSuggested": boolean,
  "offsetRightSuggested": boolean,
  "offsetTopSuggested": boolean,
  "offsetBottomSuggested": boolean,
  "angleSuggested": boolean
}
Felder
offsetLeftSuggested

boolean

Gibt an, ob eine Änderung für offsetLeft vorgeschlagen wurde.
offsetRightSuggested

boolean

Gibt an, ob eine Änderung für offsetRight vorgeschlagen wurde.
offsetTopSuggested

boolean

Gibt an, ob eine Änderung für offsetTop vorgeschlagen wurde.
offsetBottomSuggested

boolean

Gibt an, ob eine Änderung für offsetBottom vorgeschlagen wurde.
angleSuggested

boolean

Gibt an, ob eine Änderung für angle vorgeschlagen wurde.

EmbeddedObjectBorderSuggestionState

Eine Maske, die angibt, welche Felder im Basis-EmbeddedObjectBorder in diesem Vorschlag geändert wurden. Für jedes Feld, das auf „true“ gesetzt ist, gibt es einen neuen Vorschlag.

JSON-Darstellung 
{
  "colorSuggested": boolean,
  "widthSuggested": boolean,
  "dashStyleSuggested": boolean,
  "propertyStateSuggested": boolean
}
Felder
colorSuggested

boolean

Gibt an, ob eine Änderung für [color] [google.apps.docs.v1.EmbeddedBorderObject.color] vorgeschlagen wurde.
widthSuggested

boolean

Gibt an, ob eine Änderung für [width] [google.apps.docs.v1.EmbeddedBorderObject.width] vorgeschlagen wurde.
dashStyleSuggested

boolean

Gibt an, ob eine Änderung für [dashStyle] ([google.apps.docs.v1.EmbeddedBorderObject.dash_style]) vorgeschlagen wurde.
propertyStateSuggested

boolean

Gibt an, ob eine Änderung an [propertyState] ([google.apps.docs.v1.EmbeddedBorderObject.property_state]) vorgeschlagen wurde.

LinkedContentReferenceSuggestionState

Eine Maske, die angibt, welche Felder im Basis-LinkedContentReference in diesem Vorschlag geändert wurden. Für jedes Feld, das auf „true“ gesetzt ist, gibt es einen neuen Vorschlag.

JSON-Darstellung 
{
  "sheetsChartReferenceSuggestionState": {
    object (SheetsChartReferenceSuggestionState)
  }
}
Felder
sheetsChartReferenceSuggestionState

object (SheetsChartReferenceSuggestionState)

Eine Maske, die angibt, welche Felder in sheetsChartReference in diesem Vorschlag geändert wurden.

SheetsChartReferenceSuggestionState

Eine Maske, die angibt, welche Felder im Basis-SheetsChartReference in diesem Vorschlag geändert wurden. Für jedes Feld, das auf „true“ gesetzt ist, gibt es einen neuen Vorschlag.

JSON-Darstellung 
{
  "spreadsheetIdSuggested": boolean,
  "chartIdSuggested": boolean
}
Felder
spreadsheetIdSuggested

boolean

Gibt an, ob eine Änderung für spreadsheetId vorgeschlagen wurde.
chartIdSuggested

boolean

Gibt an, ob eine Änderung für chartId vorgeschlagen wurde.

PositionedObject

Ein Objekt, das an ein Paragraph gebunden und relativ zum Anfang des Absatzes positioniert ist. Ein PositionedObject enthält ein EmbeddedObject, z. B. ein Bild.

JSON-Darstellung 
{
  "objectId": string,
  "positionedObjectProperties": {
    object (PositionedObjectProperties)
  },
  "suggestedPositionedObjectPropertiesChanges": {
    string: {
      object (SuggestedPositionedObjectProperties)
    },
    ...
  },
  "suggestedInsertionId": string,
  "suggestedDeletionIds": [
    string
  ]
}
Felder
objectId

string

Die ID dieses positionierten Objekts.
positionedObjectProperties

object (PositionedObjectProperties)

Die Eigenschaften dieses positionierten Objekts.
suggestedPositionedObjectPropertiesChanges

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

Die vorgeschlagenen Änderungen an den Eigenschaften des positionierten Objekts, die nach Vorschlags-ID sortiert sind.
suggestedInsertionId

string

Die ID des vorgeschlagenen Einfügens. Wenn leer, handelt es sich nicht um eine vorgeschlagene Einfügung.
suggestedDeletionIds[]

string

Die IDs der vorgeschlagenen Löschungen. Wenn das Feld leer ist, gibt es keine vorgeschlagenen Löschungen für diese Inhalte.

PositionedObjectProperties

Attribute eines PositionedObject.

JSON-Darstellung 
{
  "positioning": {
    object (PositionedObjectPositioning)
  },
  "embeddedObject": {
    object (EmbeddedObject)
  }
}
Felder
positioning

object (PositionedObjectPositioning)

Die Positionierung dieses positionierten Objekts relativ zur neuen Zeile des Paragraph, das auf dieses positionierte Objekt verweist.
embeddedObject

object (EmbeddedObject)

Das eingebettete Objekt dieses positionierten Objekts.

PositionedObjectPositioning

Die Positionierung eines PositionedObject. Das positionierte Objekt wird relativ zum Anfang des Paragraph positioniert, an das es angehängt ist.

JSON-Darstellung 
{
  "layout": enum (PositionedObjectLayout),
  "leftOffset": {
    object (Dimension)
  },
  "topOffset": {
    object (Dimension)
  }
}
Felder
layout

enum (PositionedObjectLayout)

Das Layout dieses positionierten Objekts.
leftOffset

object (Dimension)

Der Offset des linken Rands des positionierten Objekts relativ zum Beginn des Paragraph, an das es gebunden ist. Die genaue Positionierung des Objekts kann von anderen Inhalten im Dokument und dem Stil des Dokuments abhängen.
topOffset

object (Dimension)

Der Versatz des oberen Rands des positionierten Objekts relativ zum Anfang des Paragraph, an das es gebunden ist. Die genaue Positionierung des Objekts kann von anderen Inhalten im Dokument und dem Stil des Dokuments abhängen.

PositionedObjectLayout

Die möglichen Layouts eines [PositionedObject][google.aps.docs.v1.PositionedObject].

Enums
POSITIONED_OBJECT_LAYOUT_UNSPECIFIED Das Layout ist nicht angegeben.
WRAP_TEXT Der Text wird um das positionierte Objekt herum umbrochen.
BREAK_LEFT Bricht den Text so um, dass sich das positionierte Objekt links und der Text rechts befindet.
BREAK_RIGHT Bricht den Text so um, dass sich das positionierte Objekt rechts und der Text links befindet.
BREAK_LEFT_RIGHT Bricht den Text so um, dass sich links oder rechts vom positionierten Objekt kein Text befindet.
IN_FRONT_OF_TEXT Das positionierte Objekt befindet sich vor dem Text.
BEHIND_TEXT Das positionierte Objekt befindet sich hinter dem Text.

SuggestedPositionedObjectProperties

Ein Änderungsvorschlag für PositionedObjectProperties.

JSON-Darstellung 
{
  "positionedObjectProperties": {
    object (PositionedObjectProperties)
  },
  "positionedObjectPropertiesSuggestionState": {
    object (PositionedObjectPropertiesSuggestionState)
  }
}
Felder
positionedObjectProperties

object (PositionedObjectProperties)

Eine PositionedObjectProperties, die nur die Änderungen aus diesem Vorschlag enthält. Zusammen mit dem positionedObjectPropertiesSuggestionState können Sie so sehen, welche Felder sich geändert haben und welche neuen Werte sie haben.
positionedObjectPropertiesSuggestionState

object (PositionedObjectPropertiesSuggestionState)

Eine Maske, die angibt, welche Felder im Basis-PositionedObjectProperties in diesem Vorschlag geändert wurden.

PositionedObjectPropertiesSuggestionState

Eine Maske, die angibt, welche Felder im Basis-PositionedObjectProperties in diesem Vorschlag geändert wurden. Für jedes Feld, das auf „true“ gesetzt ist, gibt es einen neuen Vorschlag.

JSON-Darstellung 
{
  "positioningSuggestionState": {
    object (PositionedObjectPositioningSuggestionState)
  },
  "embeddedObjectSuggestionState": {
    object (EmbeddedObjectSuggestionState)
  }
}
Felder
positioningSuggestionState

object (PositionedObjectPositioningSuggestionState)

Eine Maske, die angibt, welche Felder in positioning in diesem Vorschlag geändert wurden.
embeddedObjectSuggestionState

object (EmbeddedObjectSuggestionState)

Eine Maske, die angibt, welche Felder in embeddedObject in diesem Vorschlag geändert wurden.

PositionedObjectPositioningSuggestionState

Eine Maske, die angibt, welche Felder im Basis-PositionedObjectPositioning in diesem Vorschlag geändert wurden. Für jedes Feld, das auf „true“ gesetzt ist, gibt es einen neuen Vorschlag.

JSON-Darstellung 
{
  "layoutSuggested": boolean,
  "leftOffsetSuggested": boolean,
  "topOffsetSuggested": boolean
}
Felder
layoutSuggested

boolean

Gibt an, ob eine Änderung für layout vorgeschlagen wurde.
leftOffsetSuggested

boolean

Gibt an, ob eine Änderung für leftOffset vorgeschlagen wurde.
topOffsetSuggested

boolean

Gibt an, ob eine Änderung für topOffset vorgeschlagen wurde.

CommentAnchor

Mindestens ein Standort im Dokument, der mit CommentThreads mit derselben anchorId verknüpft ist. Hinweis: Mehrere Anker können auf denselben Ort verweisen.

JSON-Darstellung 
{
  "anchorId": string,
  "ranges": [
    {
      object (Range)
    }
  ]
}
Felder
anchorId

string

Die ID des Kommentarankers.
ranges[]

object (Range)

Eine Sammlung von Range im Dokument, die mit diesem Anker verknüpft sind.

SuggestionsViewMode

Der auf das Dokument angewendete Vorschlagsansichtsmodus, der angibt, wie vorgeschlagene Änderungen dargestellt werden. Sie haben die Möglichkeit, das Dokument mit allen Inline-Vorschlägen, mit allen akzeptierten Vorschlägen oder mit allen abgelehnten Vorschlägen zu lesen.

Enums
DEFAULT_FOR_CURRENT_ACCESS Der auf das zurückgegebene Dokument angewendete SuggestionsViewMode hängt von der aktuellen Zugriffsebene des Nutzers ab. Wenn der Nutzer nur Lesezugriff hat, wird PREVIEW_WITHOUT_SUGGESTIONS angewendet. Andernfalls wird SUGGESTIONS_INLINE angewendet. Dies ist der Standardansichtsmodus für Vorschläge.
SUGGESTIONS_INLINE

Das zurückgegebene Dokument enthält Inline-Vorschläge. Vorgeschlagene Änderungen werden im Dokument vom ursprünglichen Inhalt unterschieden.

Anfragen zum Abrufen eines Dokuments in diesem Modus geben einen 403-Fehler zurück, wenn der Nutzer keine Berechtigung zum Ansehen vorgeschlagener Änderungen hat.
PREVIEW_SUGGESTIONS_ACCEPTED

Das zurückgegebene Dokument ist eine Vorschau, in der alle Änderungsvorschläge übernommen wurden.

Anfragen zum Abrufen eines Dokuments in diesem Modus geben einen 403-Fehler zurück, wenn der Nutzer keine Berechtigung zum Ansehen vorgeschlagener Änderungen hat.
PREVIEW_WITHOUT_SUGGESTIONS Das zurückgegebene Dokument ist eine Vorschau, in der alle Änderungsvorschläge abgelehnt wurden, sofern das Dokument Vorschläge enthält.

CommentsViewMode

Der auf das Dokument angewendete Kommentaransichtsmodus, der angibt, ob Kommentare enthalten sind. Sie bietet Optionen zum Lesen des Dokuments mit oder ohne Kommentare und Kommentaranker.

Wenn Sie commentsViewMode auf einen beliebigen Wert festlegen, müssen Sie auch includeTabsContent auf true setzen oder eine Feldmaske verwenden, die auf das Feld Document.tabs (oder ein beliebiges Unterfeld) verweist.

Kommentare können nur zurückgegeben werden, wenn Vorschläge inline zurückgegeben werden. Wenn Sie commentsViewMode auf COMMENTS_VIEW_MODE_INCLUDED oder COMMENTS_VIEW_MODE_DEFAULT_FOR_CURRENT_ACCESS festlegen, können Sie suggestionsViewMode nur auf PREVIEW_WITHOUT_SUGGESTIONS oder PREVIEW_SUGGESTIONS_ACCEPTED festlegen.

Enums
COMMENTS_VIEW_MODE_UNSPECIFIED Der CommentsViewMode ist nicht angegeben. COMMENTS_VIEW_MODE_OMITTED wird angewendet.
COMMENTS_VIEW_MODE_DEFAULT_FOR_CURRENT_ACCESS Der auf das zurückgegebene Dokument angewendete „CommentsViewMode“ hängt von der aktuellen Zugriffsebene des Nutzers ab. Wenn der Nutzer nur Lesezugriff hat, wird COMMENTS_VIEW_MODE_OMITTED angewendet. Andernfalls wird COMMENTS_VIEW_MODE_INCLUDED angewendet.
COMMENTS_VIEW_MODE_OMITTED Im zurückgegebenen Dokument fehlen Kommentare.
COMMENTS_VIEW_MODE_INCLUDED

Das zurückgegebene Dokument enthält Kommentare.

Bei Anfragen zum Abrufen eines Dokuments in diesem Modus wird der Fehler „403“ zurückgegeben, wenn der Nutzer keine Berechtigung zum Aufrufen von Kommentaren hat.

Wenn dieser Wert festgelegt ist, muss auch suggestionsViewMode auf SUGGESTIONS_INLINE festgelegt werden. Andernfalls wird der Fehler „400 Bad Request“ zurückgegeben.

CommentThread

Stellt einen einzelnen Kommentar-Thread dar.

JSON-Darstellung 
{
  "commentId": string,
  "anchorId": string,
  "headPost": {
    object (Post)
  },
  "replies": [
    {
      object (Post)
    }
  ],
  "status": enum (Status),

  "plainTextQuote": string
}
Felder
commentId

string

Die eindeutige ID des Kommentar-Threads.
anchorId

string

Die ID des CommentAnchor im Dokument, mit dem dieser Thread verknüpft ist. Mehrere Kommentar-Threads können an denselben CommentAnchor angehängt werden.
headPost

object (Post)

Der erste Beitrag im Thread.
replies[]

object (Post)

Antworten auf den Hauptbeitrag.
status

enum (Status)

Ob der Thread offen oder geschlossen ist.
Der zitierte Text aus dem Dokument, als der Kommentar erstellt wurde. Im Folgenden finden Sie eine Liste von sich gegenseitig ausschließenden Feldern. In einer Antwort wird höchstens eines der Felder festgelegt:
plainTextQuote

string

Der zitierte Text aus dem Dokument, als der Kommentar erstellt wurde, formatiert als Nur-Text.
Ende der sich gegenseitig ausschließenden Felder.

Posten

Steht für einen einzelnen Beitrag in einem Kommentar- oder Vorschlags-Thread.

JSON-Darstellung 
{
  "postId": string,
  "content": string,
  "contentHtml": string,
  "author": {
    object (PostAuthor)
  },
  "createTime": string,
  "updateTime": string,
  "deleted": boolean,
  "fromImportedDocument": boolean,
  "fromCopiedDocument": boolean,
  "fromDocumentComparison": boolean,
  "assigneeEmail": string,

  "commentAction": enum (CommentActionType),
  "suggestionAction": enum (SuggestionActionType)
}
Felder
postId

string

Nur Ausgabe. Die eindeutige ID des Beitrags.
content

string

Der Inhalt des Beitrags.

Darf nicht leer sein, wenn commentAction nicht RESOLVE oder REOPEN ist.

Diese Textinhalte werden ähnlich wie Kommentare behandelt, die im Docs-Editor erstellt wurden. Die Formatierung und Benachrichtigungen sind ähnlich.

Darf nicht mehr als 2.048 UTF‑8-Codeeinheiten enthalten.
contentHtml

string

Nur Ausgabe. Der Inhalt des Beitrags als HTML-Code.
author

object (PostAuthor)

Nur Ausgabe. Der Nutzer, der den Beitrag erstellt hat.
createTime

string (Timestamp format)

Nur Ausgabe. Der Zeitpunkt, zu dem der Beitrag erstellt wurde.
updateTime

string (Timestamp format)

Nur Ausgabe. Der Zeitpunkt, zu dem der Beitrag zuletzt aktualisiert wurde.
deleted

boolean

Nur Ausgabe. Gibt an, ob der Beitrag gelöscht wurde. Wenn true, content und author leer sind.
fromImportedDocument

boolean

Nur Ausgabe. Gibt an, ob der Beitrag aus einem importierten Dokument stammt. Dieses Feld kann nicht direkt von Anrufern festgelegt werden.
fromCopiedDocument

boolean

Nur Ausgabe. Gibt an, ob der Beitrag aus einem kopierten Dokument stammt. Dieses Feld kann nicht direkt von Anrufern festgelegt werden.
fromDocumentComparison

boolean

Nur Ausgabe. Gibt an, ob der Beitrag aus einem Dokumentvergleich stammt. Dieses Feld kann nicht direkt von Anrufern festgelegt werden.
assigneeEmail

string

Optional. Die E‑Mail-Adresse des Nutzers, der dem Thread im Rahmen dieses Beitrags neu zugewiesen wird.

Gibt einen 400-Fehler („Bad Request“) zurück, wenn:

  • Der übergeordnete Thread ist ein CommentThread, dessen headPost keinen zugewiesenen Bearbeiter hat.

  • Der übergeordnete Thread ist ein SuggestionThread.

  • commentAction ist als RESOLVE oder REOPEN angegeben.

  • assigneeEmail überschreitet 2.048 UTF-8-Codeeinheiten.
Im Rahmen der Beitragserstellung ergriffene Maßnahme. Im Folgenden finden Sie eine Liste von sich gegenseitig ausschließenden Feldern. In einer Antwort wird höchstens eines der Felder festgelegt:
commentAction

enum (CommentActionType)

Optional. Der Aktionstyp für Kommentarbeiträge.
suggestionAction

enum (SuggestionActionType)

Nur Ausgabe. Der Aktionstyp für Vorschlagsbeiträge.
Ende der sich gegenseitig ausschließenden Felder.

PostAuthor

Stellt einen Nutzer dar, der einen Kommentar oder einen Vorschlagsbeitrag verfasst hat.

JSON-Darstellung 
{
  "displayName": string,
  "me": boolean,
  "anonymous": boolean,
  "user": string
}
Felder
displayName

string

Der Anzeigename des Nutzers. Kann fehlen, wenn der Autor anonym ist.
me

boolean

Gibt an, ob der Nutzer der authentifizierte Nutzer ist, der die Anfrage stellt.
anonymous

boolean

Gibt an, ob der Nutzer anonym ist.
user

string

Der Ressourcenname des Nutzers, der den Beitrag verfasst hat. Er kann auch verwendet werden, um den Nutzer in der Google People API zu identifizieren. Format: users/{user}. Wird nicht ausgefüllt, wenn das Feld „anonymous“ true ist oder der Beitrag aus einem importierten Dokument stammt.

CommentActionType

Die Aktion, die mit dieser Antwort auf einen Kommentar-Thread ausgeführt wurde.

Enums
COMMENT_ACTION_TYPE_UNSPECIFIED Standardwert. Dieser Wert wird nicht verwendet.
NO_COMMENT_ACTION_CHANGE In diesem Beitrag gibt es keine Änderung der Maßnahmen.
RESOLVE Dieser Beitrag schließt den Thread.
REOPEN Mit diesem Beitrag wird der Thread wieder geöffnet.

SuggestionActionType

Die Maßnahme, die mit dieser Antwort auf einen Vorschlags-Thread ergriffen wurde.

Enums
SUGGESTION_ACTION_TYPE_UNSPECIFIED Standardwert. Dieser Wert wird nicht verwendet.
NO_SUGGESTION_ACTION_CHANGE In diesem Beitrag gibt es keine Änderung der Maßnahmen.
ACCEPT In diesem Beitrag wird der Vorschlag angenommen.
REJECT In diesem Beitrag wird der Vorschlag abgelehnt.

Status

Die Statusoptionen des Kommentar-Threads.

Enums
STATUS_UNSPECIFIED Standardwert. Dieser Wert wird nicht verwendet.
OPEN Der Kommentar-Thread ist geöffnet.
RESOLVED Der Kommentar-Thread wurde geklärt.

SuggestionThread

Stellt einen einzelnen Vorschlags-Thread dar. Vorschlags-Threads werden als Nebenprodukt des Speicherns von Änderungen am Dokument im Vorschlagsmodus erstellt und können nicht direkt erstellt werden.

JSON-Darstellung 
{
  "suggestionId": string,
  "headPost": {
    object (Post)
  },
  "replies": [
    {
      object (Post)
    }
  ],
  "status": enum (Status),
  "summaryText": string,
  "summaryHtml": string
}
Felder
suggestionId

string

Die eindeutige ID des Vorschlags.
headPost

object (Post)

Der erste Beitrag im Thread.
replies[]

object (Post)

Antworten auf den Hauptbeitrag.
status

enum (Status)

Gibt an, ob der Thread offen, akzeptiert oder abgelehnt ist.
summaryText

string

Zusammenfassung der vorgeschlagenen Änderungen im Dokument in Nur-Text. Kann leer sein.
summaryHtml

string

Zusammenfassung der vorgeschlagenen Unterschiede im Dokument in HTML. Kann leer sein.

Status

Die Statusoptionen des Vorschlags-Threads.

Enums
STATUS_UNSPECIFIED Standardwert. Dieser Wert wird nicht verwendet.
OPEN Der Vorschlags-Thread ist geöffnet.
ACCEPTED Der Vorschlags-Thread wurde angenommen.
REJECTED Der Vorschlags-Thread wird abgelehnt.

Methoden

batchUpdate

 Wendet eine oder mehrere Aktualisierungen auf das Dokument an.

create

 Erstellt ein leeres Dokument mit dem im Antrag angegebenen Titel.

get

 Ruft die aktuelle Version des angegebenen Dokuments ab.