REST Resource: documents

Ressource: Document

Ein Google Docs-Dokument.

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

string

Nur Ausgabe. Die ID des Dokuments.

title

string

Der Titel des Dokuments.

tabs[]

object (Tab)

Tabs, die Teil eines Dokuments sind.

Tabs können untergeordnete Tabs enthalten, also einen Tab, der in einem anderen Tab verschachtelt ist. Untergeordnete Tabs werden durch das Feld Tab.childTabs dargestellt.

revisionId

string

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

Die Überarbeitungs-ID ist keine fortlaufende Nummer, sondern ein intransparenter String. Das Format der Überarbeitungs-ID kann sich im Laufe der Zeit ändern. Eine zurückgegebene Überarbeitungs-ID ist nach der Rückgabe nur 24 Stunden lang gültig und kann nicht mit anderen Nutzern geteilt werden. Wenn die Überarbeitungs-ID zwischen den Aufrufen unverändert bleibt, hat sich das Dokument nicht geändert. Umgekehrt bedeutet eine geänderte ID (für dasselbe Dokument und denselben Nutzer) normalerweise, 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 Ansichtsmodus für Vorschläge wurde auf das Dokument angewendet.

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

body

object (Body)

Nur Ausgabe. Der Hauptteil des Dokuments.

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

headers

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

Nur Ausgabe. Die Header im Dokument, mit Header-ID versehen.

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

footers

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

Nur Ausgabe. Die Fußzeilen im Dokument, mit einer Fußzeilen-ID versehen.

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

footnotes

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

Nur Ausgabe. Die Fußnoten im Dokument, mit Fußnoten-ID versehen.

Altes Feld: Verwenden Sie stattdessen Document.tabs.documentTab.footnotes. Damit wird der tatsächliche Dokumentinhalt aus allen Tabs angezeigt, wenn der Parameter includeTabsContent auf true gesetzt ist. Wenn false festgelegt oder nicht konfiguriert ist, 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 aus allen Tabs angezeigt, wenn der Parameter includeTabsContent auf true gesetzt ist. Wenn false festgelegt oder nicht konfiguriert ist, 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, unterstützt durch die Vorschlags-ID.

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

namedStyles

object (NamedStyles)

Nur Ausgabe. Die benannten Stile des Dokuments.

Altes Feld: Verwenden Sie stattdessen Document.tabs.documentTab.namedStyles. Damit wird der tatsächliche Dokumentinhalt aus allen Tabs angezeigt, wenn der Parameter includeTabsContent auf true gesetzt ist. Wenn false festgelegt oder nicht konfiguriert ist, 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, codiert durch Vorschlags-ID.

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

lists

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

Nur Ausgabe. Die Listen im Dokument, aufgeschlüsselt nach Listen-ID.

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

namedRanges

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

Nur Ausgabe. Die benannten Bereiche im Dokument, aufgeschlüsselt nach Name.

Altes Feld: Verwenden Sie stattdessen Document.tabs.documentTab.namedRanges. Damit wird der tatsächliche Dokumentinhalt aus allen Tabs angezeigt, wenn der Parameter includeTabsContent auf true gesetzt ist. Wenn false festgelegt oder nicht konfiguriert ist, 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 mit der Objekt-ID versehen sind.

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

positionedObjects

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

Nur Ausgabe. Die positionierten Objekte im Dokument, angegeben durch die Objekt-ID.

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

Tabulatortaste

Ein Tab in einem Dokument.

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

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

object (TabProperties)

Die Eigenschaften des Tabs, z. B. ID und Titel.

childTabs[]

object (Tab)

Die untergeordneten Tabs, die in diesem Tab verschachtelt sind.

Union-Feld content. Der Inhalt des Tabs. Für content ist nur einer der folgenden Werte zulässig:
documentTab

object (DocumentTab)

Ein Tab mit Dokumentinhalten wie Text und Bildern.

TabProperties

Eigenschaften eines Tabs.

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

string

Nur Ausgabe. Die ID des Tabs. Dieses Feld kann nicht geändert werden.

title

string

Der für den Nutzer sichtbare Name des Tabs.

parentTabId

string

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

index

integer

Der nullbasierte Index des Tabs innerhalb des übergeordneten Elements.

nestingLevel

integer

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

DocumentTab

Ein Tab mit Dokumentinhalt.

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)
    },
    ...
  }
}
Felder
body

object (Body)

Der Hauptteil des Dokument-Tabs.

headers

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

Die Überschriften auf dem Dokument-Tab, mit Header-ID versehen.

footers

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

Die Fußzeilen auf dem Dokument-Tab, zusammen mit einer Fußzeilen-ID.

footnotes

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

Die Fußnoten auf dem Dokument-Tab, aufgeschlüsselt nach Fußnoten-ID.

documentStyle

object (DocumentStyle)

Der Stil des Dokument-Tabs.

suggestedDocumentStyleChanges

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

Die vorgeschlagenen Änderungen am Stil des Dokument-Tabs, zusammen mit der Vorschlags-ID.

namedStyles

object (NamedStyles)

Die benannten Stile des Dokument-Tabs.

suggestedNamedStylesChanges

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

Die vorgeschlagenen Änderungen an den benannten Stilen des Dokument-Tabs, zusammen mit der Vorschlags-ID.

lists

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

Die Listen auf dem Tab „Dokumente“, aufgeschlüsselt nach Listen-ID.

namedRanges

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

Die benannten Bereiche auf dem Dokument-Tab, aufgeschlüsselt nach Name.

inlineObjects

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

Die Inline-Objekte auf dem Dokument-Tab, mit Objekt-ID.

positionedObjects

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

Die positionierten Objekte auf dem Dokument-Tab, angegeben nach Objekt-ID.

Text

Der Dokumenttext.

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

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

object (StructuralElement)

Der Inhalt des Hauptteils.

Die Indexe für den Inhalt des Textkörpers beginnen bei null.

StructuralElement

Ein StructuralElement beschreibt Inhalte, die dem Dokument eine Struktur verleihen.

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

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

integer

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

endIndex

integer

Der nullbasierte Endindex dieses Strukturelements, exklusiv, in UTF-16-Codeeinheiten.

Union-Feld content. Der Inhalt des Strukturelements. Für content ist nur einer der folgenden Werte zulässig:
paragraph

object (Paragraph)

Ein Absatztyp eines Strukturelements.

sectionBreak

object (SectionBreak)

Abschnittswechseltyp eines Strukturelements.

table

object (Table)

Ein Tabellentyp eines Strukturelements.

tableOfContents

object (TableOfContents)

Ein Inhaltstyp für ein Strukturelement.

Absatz

Ein StructuralElement, das einen Absatz darstellt. Ein Absatz ist ein Inhaltsbereich, der mit einem Zeilenumbruch 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, aufgeteilt in seine Bestandteile.

paragraphStyle

object (ParagraphStyle)

Der Stil dieses Absatzes.

suggestedParagraphStyleChanges

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

Durch die vorgeschlagene Absatzstiländerung für diesen Absatz, aufgeschlüsselt nach Vorschlags-ID.

bullet

object (Bullet)

Der Aufzählungspunkt für diesen Absatz. Wenn nicht vorhanden, gehört der Absatz zu keiner Liste.

suggestedBulletChanges

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

Die vorgeschlagenen Änderungen für den Aufzählungspunkt in diesem Absatz.

positionedObjectIds[]

string

Die IDs der positionierten Objekte, die mit diesem Absatz verbunden sind.

suggestedPositionedObjectIds

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

Die IDs der positionierten Objekte, die diesem Absatz hinzugefügt werden sollten, zusammen mit der Vorschlags-ID.

ParagraphElement

Ein ParagraphElement beschreibt Inhalte innerhalb einer Paragraph.

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

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

integer

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

endIndex

integer

Der Null-Basis-Endindex dieses Absatzelements, exklusiv, in UTF-16-Codeeinheiten.

Union-Feld content. Der Inhalt des Absatzelements. Für content ist nur einer der folgenden Werte zulässig:
textRun

object (TextRun)

Ein Absatzelement für Textausführungen.

autoText

object (AutoText)

Ein automatisches Absatzelement.

pageBreak

object (PageBreak)

Ein Absatzelement für einen Seitenumbruch.

columnBreak

object (ColumnBreak)

Ein Absatzelement für einen Spaltenumbruch.

footnoteReference

object (FootnoteReference)

Ein Fußnoten-Referenzabsatzelement.

horizontalRule

object (HorizontalRule)

Ein horizontales Regelabsatzelement.

equation

object (Equation)

Ein Gleichungsabsatzelement.

inlineObjectElement

object (InlineObjectElement)

Ein Absatzelement für ein Inline-Objekt.

person

object (Person)

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

TextRun

Ein ParagraphElement, das einen Run of Text darstellt, der alle den gleichen Stil hat.

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

string

Der Text dieser Ausführung.

Alle Nicht-Text-Elemente in der Ausführung werden durch das Unicode-Zeichen U+E907 ersetzt.

suggestedInsertionIds[]

string

Die vorgeschlagenen Einfügungs-IDs. Eine TextRun kann mehrere Einfügungs-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 vorgeschlagenen Lösch-IDs. Wenn das Feld leer ist, werden keine Vorschläge zum Löschen dieses Inhalts vorgeschlagen.

textStyle

object (TextStyle)

Der Textstil dieser Ausführung.

suggestedTextStyleChanges

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

Der vorgeschlagene Textstil für diese Ausführung, angegeben durch die Vorschlags-ID.

TextStyle

Stellt den Stil dar, der auf Text angewendet werden kann.

Übernommene Textstile werden in dieser Nachricht als nicht konfigurierte Felder dargestellt. Das übergeordnete Element eines Textstils hängt davon ab, wo der Textstil definiert ist:

  • TextStyle für Text in einer Paragraph wird aus dem entsprechenden named style type des Absatzes übernommen.
  • TextStyle in einem named style-Element wird aus dem benannten normal text-Stil übernommen.
  • Für den TextStyle des benannten Stils normal text wird der Standardtextstil im Docs-Editor übernommen.
  • TextStyle für ein Paragraph-Element, das in einer Tabelle enthalten ist, kann seinen Textstil aus dem Tabellenstil übernehmen.

Wenn der Textstil nicht von einem übergeordneten Element übernommen wird, wird er beim Deaktivieren der Felder auf einen Wert zurückgesetzt, der mit den Standardeinstellungen im Docs-Editor übereinstimmt.

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 dargestellt wird.

italic

boolean

Gibt an, ob der Text kursiv dargestellt wird.

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 Kleinbuchstaben geschrieben ist.

backgroundColor

object (OptionalColor)

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

foregroundColor

object (OptionalColor)

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

fontSize

object (Dimension)

Die Schriftgröße des Textes.

weightedFontFamily

object (WeightedFontFamily)

Die Schriftfamilie und die gerenderte Stärke des Textes.

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 Bad Request“ zurückgegeben.

baselineOffset

enum (BaselineOffset)

Der vertikale Versatz des Textes gegenüber seiner normalen Position.

Text mit einem Basisversatz von SUPERSCRIPT oder SUBSCRIPT wird automatisch in einer kleineren Schriftgröße gerendert, die auf Grundlage des Felds fontSize berechnet wird. Änderungen in diesem Feld wirken sich nicht auf fontSize aus.

OptionalColor

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

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

object (Color)

Wenn dieser Wert festgelegt ist, wird er als deckende Farbe verwendet. Wenn kein Wert festgelegt ist, stellt dies eine transparente Farbe dar.

Farbe

Volltonfarbe

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. Sie liegt zwischen 0,0 und 1,0.

blue

number

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

Dimension

Eine Größe in einer 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

Eine Schriftfamilie und -stärke von Text.

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

string

Die Schriftfamilie des Textes.

Als Schriftfamilie können Sie eine beliebige Schriftart aus dem Menü „Schriftart“ in Google Docs oder aus Google Fonts auswählen. Wenn der Name der Schriftart nicht erkannt wird, wird der Text in Arial gerendert.

weight

integer

Die Stärke der Schrift. Dieses Feld kann einen beliebigen Wert enthalten, der ein Vielfaches von 100 zwischen 100 und 900 ist. Dieser Bereich entspricht den in der CSS 2.1-Spezifikation Abschnitt 15.6 beschriebenen numerischen Werten. Nicht numerische Werte sind nicht zulässig.

Der Standardwert ist 400 ("normal").

Die Schriftstärke macht nur eine Komponente der gerenderten Schriftstärke aus. Eine Kombination aus weight und dem aufgelösten bold-Wert des Textstils bestimmt die gerenderte Stärke nach Berücksichtigung der Übernahme:

  • Wenn der Text fett dargestellt und die Schriftstärke unter 400 liegt, beträgt die gerenderte Stärke 400.
  • Wenn der Text fett dargestellt und die Stärke größer oder gleich 400, aber kleiner als 700 ist, beträgt die gerenderte Stärke 700.
  • Wenn die Gewichtung größer oder gleich 700 ist, entspricht die gerenderte Gewichtung der Gewichtung.
  • Wenn der Text nicht fett ist, entspricht die gerenderte Stärke der Gewichtung.

BaselineOffset

Die Art und Weise, wie Text vertikal von seiner normalen Position verschoben werden kann.

Enums
BASELINE_OFFSET_UNSPECIFIED Der Basisversatz des Texts wird vom übergeordneten Element übernommen.
NONE Der Text ist nicht vertikal verschoben.
SUPERSCRIPT Der Text ist vertikal nach oben verschoben (hochgestellt).
SUBSCRIPT Der Text ist vertikal nach unten verschoben (tiefgestellt).

SuggestedTextStyle

Ein Änderungsvorschlag für TextStyle.

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

object (TextStyle)

Ein TextStyle, der nur die in diesem Vorschlag vorgenommenen Änderungen enthält. Dies kann zusammen mit dem textStyleSuggestionState verwendet werden, um zu sehen, welche Felder sich geändert haben und welche neuen Werte sie enthalten.

textStyleSuggestionState

object (TextStyleSuggestionState)

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

TextStyleSuggestionState

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

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 ein Änderungsvorschlag für „bold“ vorliegt.

italicSuggested

boolean

Gibt an, ob ein Änderungsvorschlag für „italic“ vorliegt.

underlineSuggested

boolean

Gibt an, ob ein Änderungsvorschlag für „underline“ vorliegt.

strikethroughSuggested

boolean

Gibt an, ob ein Änderungsvorschlag für „strikethrough“ vorliegt.

smallCapsSuggested

boolean

Gibt an, ob ein Änderungsvorschlag für „smallCaps“ vorliegt.

backgroundColorSuggested

boolean

Gibt an, ob ein Änderungsvorschlag für „backgroundColor“ vorliegt.

foregroundColorSuggested

boolean

Gibt an, ob ein Änderungsvorschlag für „foregroundColor“ vorliegt.

fontSizeSuggested

boolean

Gibt an, ob ein Änderungsvorschlag für „fontSize“ vorliegt.

weightedFontFamilySuggested

boolean

Gibt an, ob ein Änderungsvorschlag für „weightedFontFamily“ vorliegt.

baselineOffsetSuggested

boolean

Gibt an, ob ein Änderungsvorschlag für „baselineOffset“ vorliegt.

AutoText

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

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

enum (Type)

Der Typ dieses automatischen Textes.

suggestedInsertionIds[]

string

Die vorgeschlagenen Einfügungs-IDs. Ein AutoText kann mehrere Einfügungs-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 vorgeschlagenen Lösch-IDs. Wenn das Feld leer ist, werden keine Vorschläge zum Löschen dieses Inhalts vorgeschlagen.

textStyle

object (TextStyle)

Der Textstil dieses AutoTextes.

suggestedTextStyleChanges

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

Der vorgeschlagene Textstil ändert sich an diesem AutoText, angegeben anhand der Vorschlags-ID.

Typ

Die Arten von automatischem Text.

Enums
TYPE_UNSPECIFIED Ein nicht spezifizierter automatischer Texttyp.
PAGE_NUMBER Geben Sie einen automatischen Text ein, der die aktuelle Seitenzahl repräsentiert.
PAGE_COUNT Typ für automatischen Text, der die Gesamtzahl der Seiten im Dokument darstellt.

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. Eine PageBreak kann mehrere Einfügungs-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 vorgeschlagenen Lösch-IDs. Wenn das Feld leer ist, werden keine Vorschläge zum Löschen dieses Inhalts vorgeschlagen.

textStyle

object (TextStyle)

Der Textstil dieses PageBreaks.

Ähnlich wie bei Textinhalten wie Textläufen und Fußnotenverweisen kann sich der Textstil eines Seitenumbruchs auf das Inhaltslayout sowie auf den Stil des daneben eingefügten Textes auswirken.

suggestedTextStyleChanges

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

Der vorgeschlagene Textstil ändert sich an diesem PageBreak, eingegeben durch Vorschlags-ID.

ColumnBreak

Ein ParagraphElement, der einen Spaltenumbruch darstellt. Durch einen Spaltenumbruch beginnt der nachfolgende Text am Anfang der nächsten Spalte.

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

string

Die vorgeschlagenen Einfügungs-IDs. Eine ColumnBreak kann mehrere Einfügungs-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 vorgeschlagenen Lösch-IDs. Wenn das Feld leer ist, werden keine Vorschläge zum Löschen dieses Inhalts vorgeschlagen.

textStyle

object (TextStyle)

Der Textstil dieses ColumnBreak.

Ähnlich wie bei Textinhalten wie Textläufen und Fußnotenverweisen kann sich der Textstil eines Spaltenumbruchs auf das Inhaltslayout sowie auf den Stil des daneben eingefügten Textes auswirken.

suggestedTextStyleChanges

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

Der vorgeschlagene Textstil ändert sich an diesem ColumnBreak, codiert durch Vorschlags-ID.

FootnoteReference

Ein ParagraphElement, das einen Fußnotenverweis darstellt. Ein Fußnotenverweis ist der Inline-Inhalt, der mit einer Zahl gerendert wird. Er wird zur Kennzeichnung der Fußnote verwendet.

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

string

Die ID von footnote, die den Inhalt dieses Fußnotenverweises enthält.

footnoteNumber

string

Die gerenderte Nummer dieser Fußnote.

suggestedInsertionIds[]

string

Die vorgeschlagenen Einfügungs-IDs. Eine FootnoteReference kann mehrere Einfügungs-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 vorgeschlagenen Lösch-IDs. Wenn das Feld leer ist, werden keine Vorschläge zum Löschen dieses Inhalts vorgeschlagen.

textStyle

object (TextStyle)

Der Textstil dieser FootnoteReference.

suggestedTextStyleChanges

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

Der vorgeschlagene Textstil ändert sich an dieser FootnoteReference, angegeben durch die Vorschlags-ID.

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ügungs-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 vorgeschlagenen Lösch-IDs. Wenn das Feld leer ist, werden keine Vorschläge zum Löschen dieses Inhalts vorgeschlagen.

textStyle

object (TextStyle)

Der Textstil dieser HorizontalRule.

Ähnlich wie bei Textinhalten wie Textläufen und Fußnotenreferenzen kann sich der Textstil einer horizontalen Regel auf das Inhaltslayout sowie den Stil des daneben eingefügten Textes auswirken.

suggestedTextStyleChanges

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

Der vorgeschlagene Textstil ändert sich in diese HorizontalRule, die durch die Vorschlags-ID angegeben wird.

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ügungs-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 vorgeschlagenen Lösch-IDs. Wenn das Feld leer ist, werden keine Vorschläge zum Löschen dieses Inhalts vorgeschlagen.

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 von InlineObject, die dieses Element enthält.

suggestedInsertionIds[]

string

Die vorgeschlagenen Einfügungs-IDs. Ein InlineObjectElement kann mehrere Einfügungs-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 vorgeschlagenen Lösch-IDs. Wenn das Feld leer ist, werden keine Vorschläge zum Löschen dieses Inhalts vorgeschlagen.

textStyle

object (TextStyle)

Der Textstil dieses InlineObjectElements.

Ähnlich wie bei Textinhalten wie Textläufen und Fußnotenreferenzen kann sich der Textstil eines Inline-Objektelements auf das Inhaltslayout sowie auf den Stil des daneben eingefügten Textes auswirken.

suggestedTextStyleChanges

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

Der vorgeschlagene Textstil ändert sich an diesem InlineObject, codiert durch Vorschlags-ID.

Person

Eine in einem Dokument erwähnte Person oder E-Mail-Adresse. 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 dieser Verknüpfung.

suggestedInsertionIds[]

string

IDs der Vorschläge zum Einfügen des Links zu dieser Person in das Dokument. Ein Person kann mehrere Einfügungs-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, wird dieser Personenlink nicht als Platzhalter verwendet.

suggestedDeletionIds[]

string

IDs der Vorschläge zum Entfernen des Links zu dieser Person aus dem Dokument. Eine Person kann mehrere Lösch-IDs haben, wenn beispielsweise mehrere Nutzer vorschlagen, sie zu löschen. Wenn das Feld leer ist, wird dieser Personenlink nicht zum Löschen vorgeschlagen.

textStyle

object (TextStyle)

Der Textstil von Person.

suggestedTextStyleChanges

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

Der vorgeschlagene Textstil ändert sich an dieser Person, angegeben durch die Vorschlags-ID.

personProperties

object (PersonProperties)

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

PersonProperties

Spezifische Attribute für ein verknüpftes Person

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

string

Nur Ausgabe. Der Name der Person, wenn er im Linktext statt der E-Mail-Adresse der Person zu sehen ist.

email

string

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

RichLinkProperties

Spezifische Attribute für RichLink.

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

string

Nur Ausgabe. Der im Link angezeigte Titel von RichLink. Dieser Titel stimmt mit dem Titel der verknüpften Ressource zum Zeitpunkt der Einfügen oder letzten Aktualisierung des Links überein. Dieses Feld ist immer vorhanden.

uri

string

Nur Ausgabe. URI zu RichLink. Diese ist immer vorhanden.

mimeType

string

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

Absatzstil

Stile, die für einen ganzen Absatz gelten.

Übernommene Absatzstile werden in dieser Nachricht als nicht konfigurierte Felder dargestellt. Das übergeordnete Element eines Absatzstils hängt davon ab, wo der Absatzstil definiert ist:

  • Absatzstil für Paragraph-Elemente wird vom zugehörigen named style type-Element des Absatzes übernommen.
  • Absatzstil für named style-Elemente wird aus dem benannten normal text-Stil übernommen.
  • Der „Absatzstil“ des benannten Stils normal text wird aus dem Standardabsatzstil im Docs-Editor übernommen.
  • Absatzstil für ein Paragraph-Element, das in einer Tabelle enthalten ist, kann seinen Absatzstil aus dem Tabellenstil übernehmen.

Wenn der Absatzstil nicht von einem übergeordneten Element übernommen wird, wird er beim Deaktivieren der Felder auf einen Wert zurückgesetzt, der mit den Standardeinstellungen im Docs-Editor übereinstimmt.

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 ID der Überschrift des Absatzes. Wenn dieser Absatz leer ist, ist er keine Überschrift.

Diese Eigenschaft ist schreibgeschützt.

namedStyleType

enum (NamedStyleType)

Der benannte Stiltyp des Absatzes.

Da sich die Aktualisierung des benannten Stiltyps auf andere Eigenschaften in ParagraphStyle auswirkt, wird der benannte Stiltyp 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 Normalwerts, wobei normal als 100, 0 angegeben wird. Wenn kein Wert festgelegt ist, wird der Wert vom übergeordneten Element übernommen.

direction

enum (ContentDirection)

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

spacingMode

enum (SpacingMode)

Der Abstandsmodus für den Absatz.

spaceAbove

object (Dimension)

Der zusätzliche Abstand über dem Absatz Wenn kein Wert festgelegt ist, wird der Wert vom übergeordneten Element übernommen.

spaceBelow

object (Dimension)

Der zusätzliche Abstand unter dem Absatz. Wenn kein Wert festgelegt ist, wird der Wert vom übergeordneten Element übernommen.

borderBetween

object (ParagraphBorder)

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

Der Bereich zwischen Rahmen wird gerendert, wenn der angrenzende Absatz dieselben Rahmen- und Einzugseigenschaften aufweist.

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

borderTop

object (ParagraphBorder)

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

Der obere Rahmen wird gerendert, wenn der Absatz darüber unterschiedliche Rahmen- und Einrückungseigenschaften aufweist.

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

borderBottom

object (ParagraphBorder)

Der Rahmen am Ende des Absatzes. Wenn kein Wert festgelegt ist, wird der Wert vom übergeordneten Element übernommen.

Der untere Rahmen wird gerendert, wenn der Absatz unten unterschiedliche Rahmen- und Einrückungseigenschaften hat.

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

borderLeft

object (ParagraphBorder)

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

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

borderRight

object (ParagraphBorder)

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

Absatzrahmen 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, der dem Textanfang entspricht, basierend auf der aktuellen Absatzrichtung. Wenn kein Wert festgelegt ist, wird der Wert vom übergeordneten Element übernommen.

indentEnd

object (Dimension)

Der Einzug des Absatzes auf der Seite, der dem Textende 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.

Diese Eigenschaft 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 zumindest 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 Witwen und Waisen für den Absatz gemieden 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

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

Der Versuch, pageBreakBefore für Absätze in nicht unterstützten Regionen wie Table, Header, Footer und Footnote zu aktualisieren, kann zu einem ungültigen Dokumentstatus führen, der einen Fehler 400 für ungültige Anfragen zurückgibt.

NamedStyleType

Die Typen benannter Stile.

Enums
NAMED_STYLE_TYPE_UNSPECIFIED Der Typ des benannten Stils 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 Absatzausrichtung wird vom übergeordneten Element übernommen.
START Der Absatz ist am Zeilenanfang ausgerichtet. Linksbündig für LTR-Text, ansonsten rechtsbündig.
CENTER Der Absatz wird zentriert.
END Der Absatz ist am Zeilenende ausgerichtet. Rechtsbündig für LTR-Text, ansonsten linksbündig.
JUSTIFIED Der Absatz ist im Blocksatz ausgerichtet.

ContentDirection

Die Wegbeschreibung kann einfließen.

Enums
CONTENT_DIRECTION_UNSPECIFIED Die Richtung des Inhalts ist nicht angegeben.
LEFT_TO_RIGHT Der Inhalt geht von links nach rechts.
RIGHT_TO_LEFT Der Inhalt geht von rechts nach links.

SpacingMode

Die verschiedenen Modi für den Absatzabstand.

Enums
SPACING_MODE_UNSPECIFIED Der Abstandsmodus wird vom übergeordneten Element übernommen.
NEVER_COLLAPSE Der Absatzabstand wird immer gerendert.
COLLAPSE_LISTS Der Absatzabstand wird zwischen den 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 Abstand des Rahmens.

dashStyle

enum (DashStyle)

Der Bindestrich-Stil des Rahmens.

DashStyle

Die Arten von Bindestrichen, mit denen lineare Geometrie gerendert werden kann. Diese Werte basieren auf dem Wert "ST_PresetLineDashVal" einfacher Typ, der in Abschnitt 20.1.10.48 von „Office Open XML File Formats – Fundamentals and Markup Language Reference“, Teil 1 der 4. Ausgabe ECMA-376 beschrieben wird.

Enums
DASH_STYLE_UNSPECIFIED Bindestrichstil nicht angegeben.
SOLID Durchgezogene Linie Entspricht dem ECMA-376 ST_PresetLineDashVal-Wert "solid". Dies ist der Standardstil für Bindestriche.
DOT Gestrichelte Linie. Entspricht ECMA-376 ST_PresetLineDashVal-Wert 'Punkt'.
DASH Gestrichelte Linie Entspricht ECMA-376 ST_PresetLineDashVal-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 kein Wert festgelegt ist, wird standardmäßig START verwendet.

TabStopAlignment

Ausrichtung des Tabstopps.

Enums
TAB_STOP_ALIGNMENT_UNSPECIFIED Die Ausrichtung des Tabstopps wurde nicht angegeben.
START Der Tabstopp ist am Anfang der Linie ausgerichtet. Das ist die Standardeinstellung.
CENTER Der Tabstopp ist zentriert auf der Linie ausgerichtet.
END Der Tabstopp ist am Ende der Linie ausgerichtet.

Schattierung

Die Schattierung eines Absatzes.

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

object (OptionalColor)

Die Hintergrundfarbe der Absatzschattierung.

SuggestedParagraphStyle

Ein Änderungsvorschlag für ParagraphStyle.

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

object (ParagraphStyle)

Ein ParagraphStyle, der nur die in diesem Vorschlag vorgenommenen Änderungen enthält. Dies kann zusammen mit dem paragraphStyleSuggestionState verwendet werden, um zu sehen, welche Felder sich geändert haben und welche neuen Werte sie enthalten.

paragraphStyleSuggestionState

object (ParagraphStyleSuggestionState)

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

ParagraphStyleSuggestionState

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

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 ein Änderungsvorschlag für „headingId“ vorliegt.

namedStyleTypeSuggested

boolean

Gibt an, ob ein Änderungsvorschlag für „namedStyleType“ vorliegt.

alignmentSuggested

boolean

Gibt an, ob ein Änderungsvorschlag für „alignment“ vorliegt.

lineSpacingSuggested

boolean

Gibt an, ob ein Änderungsvorschlag für „lineSpacing“ vorliegt.

directionSuggested

boolean

Gibt an, ob ein Änderungsvorschlag für „direction“ vorliegt.

spacingModeSuggested

boolean

Gibt an, ob ein Änderungsvorschlag für „spacingMode“ vorliegt.

spaceAboveSuggested

boolean

Gibt an, ob ein Änderungsvorschlag für „spaceAbove“ vorliegt.

spaceBelowSuggested

boolean

Gibt an, ob ein Änderungsvorschlag für „spaceBelow“ vorliegt.

borderBetweenSuggested

boolean

Gibt an, ob ein Änderungsvorschlag für „borderBetween“ vorliegt.

borderTopSuggested

boolean

Gibt an, ob ein Änderungsvorschlag für „borderTop“ vorliegt.

borderBottomSuggested

boolean

Gibt an, ob ein Änderungsvorschlag für „borderBottom“ vorliegt.

borderLeftSuggested

boolean

Gibt an, ob ein Änderungsvorschlag für „borderLeft“ vorliegt.

borderRightSuggested

boolean

Gibt an, ob ein Änderungsvorschlag für „borderRight“ vorliegt.

indentFirstLineSuggested

boolean

Gibt an, ob ein Änderungsvorschlag für „indentFirstLine“ vorliegt.

indentStartSuggested

boolean

Gibt an, ob ein Änderungsvorschlag für „indentStart“ vorliegt.

indentEndSuggested

boolean

Gibt an, ob ein Änderungsvorschlag für „indentEnd“ vorliegt.

keepLinesTogetherSuggested

boolean

Gibt an, ob ein Änderungsvorschlag für „keepLinesTogether“ vorliegt.

keepWithNextSuggested

boolean

Gibt an, ob ein Änderungsvorschlag für „keepWithNext“ vorliegt.

avoidWidowAndOrphanSuggested

boolean

Gibt an, ob ein Änderungsvorschlag für „avoidWidowAndOrphan“ vorliegt.

shadingSuggestionState

object (ShadingSuggestionState)

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

pageBreakBeforeSuggested

boolean

Gibt an, ob ein Änderungsvorschlag für „pageBreakBefore“ vorliegt.

ShadingSuggestionState

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

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

boolean

Gibt an, ob ein Änderungsvorschlag für Shading vorliegt.

Aufzählungszeichen

Beschreibt den Aufzählungspunkt in einem Absatz.

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ählungspunkt angewendet wird.

SuggestedBullet

Ein Änderungsvorschlag für Bullet.

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

object (Bullet)

Ein Bullet, der nur die in diesem Vorschlag vorgenommenen Änderungen enthält. Dies kann zusammen mit dem bulletSuggestionState verwendet werden, um zu sehen, welche Felder sich geändert haben und welche neuen Werte sie enthalten.

bulletSuggestionState

object (BulletSuggestionState)

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

BulletSuggestionState

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

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

boolean

Gibt an, ob ein Änderungsvorschlag für listId vorliegt.

nestingLevelSuggested

boolean

Gibt an, ob ein Änderungsvorschlag für nestingLevel vorliegt.

textStyleSuggestionState

object (TextStyleSuggestionState)

Eine Maske, die angibt, welche der Felder in text style gemäß 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 Bereich ist ein Bereich von Inhalten mit derselben SectionStyle. Ein Abschnittswechsel stellt den Anfang eines neuen Abschnitts dar. Der Stil des Abschnitts gilt für den Abschnitt nach dem Abschnittswechsel.

Der Dokumenttext beginnt immer mit einem Abschnittswechsel.

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

string

Die vorgeschlagenen Einfügungs-IDs. Eine SectionBreak kann mehrere Einfügungs-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 vorgeschlagenen Lösch-IDs. Wenn das Feld leer ist, werden keine Vorschläge zum Löschen dieses Inhalts vorgeschlagen.

sectionStyle

object (SectionStyle)

Der Stil des Abschnitts nach diesem Abschnittswechsel

SectionStyle

Der Stil, der 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 Spalteneigenschaften des Abschnitts.

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

Beim Aktualisieren dieser Eigenschaft ist die Festlegung eines konkreten Werts erforderlich. Wenn Sie dieses Attribut deaktivieren, wird der Fehler „400 Bad Request“ angezeigt.

columnSeparatorStyle

enum (ColumnSeparatorStyle)

Der Stil der Spaltentrennzeichen.

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

Beim Aktualisieren dieser Eigenschaft ist die Festlegung eines konkreten Werts erforderlich. Wenn Sie dieses Attribut zurücksetzen, wird ein Fehler vom Typ „400 Bad Request“ angezeigt.

contentDirection

enum (ContentDirection)

Die Richtung des Inhalts dieses Bereichs. Wenn kein Wert festgelegt ist, wird standardmäßig LEFT_TO_RIGHT verwendet.

Beim Aktualisieren dieser Eigenschaft ist die Festlegung eines konkreten Werts erforderlich. Wenn Sie dieses Attribut zurücksetzen, wird ein Fehler vom Typ „400 Bad Request“ angezeigt.

marginTop

object (Dimension)

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

Beim Aktualisieren dieser Eigenschaft ist die Festlegung eines konkreten Werts erforderlich. Wenn Sie dieses Attribut zurücksetzen, wird ein Fehler vom Typ „400 Bad Request“ angezeigt.

marginBottom

object (Dimension)

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

Beim Aktualisieren dieser Eigenschaft ist die Festlegung eines konkreten Werts erforderlich. Wenn Sie dieses Attribut zurücksetzen, wird ein Fehler vom Typ „400 Bad Request“ angezeigt.

marginRight

object (Dimension)

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

Beim Aktualisieren dieser Eigenschaft ist die Festlegung eines konkreten Werts erforderlich. Wenn Sie dieses Attribut zurücksetzen, wird ein Fehler vom Typ „400 Bad Request“ angezeigt.

marginLeft

object (Dimension)

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

Beim Aktualisieren dieser Eigenschaft ist die Festlegung eines konkreten Werts erforderlich. Wenn Sie dieses Attribut zurücksetzen, wird ein Fehler vom Typ „400 Bad Request“ angezeigt.

marginHeader

object (Dimension)

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

Beim Aktualisieren dieser Eigenschaft ist die Festlegung eines konkreten Werts erforderlich. Wenn Sie dieses Attribut zurücksetzen, wird ein Fehler vom Typ „400 Bad Request“ angezeigt.

sectionType

enum (SectionType)

Nur Ausgabe. Der Bereichstyp.

defaultHeaderId

string

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

Diese Eigenschaft ist schreibgeschützt.

firstPageHeaderId

string

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

Diese Eigenschaft ist schreibgeschützt.

evenPageHeaderId

string

Die ID des Headers, die nur bei geraden Seiten verwendet wird. Wenn der Wert des useEvenPageHeaderFooter von DocumentStyle auf "true" gesetzt ist, wird dieser Wert für die Überschriften auf geraden Seiten im Abschnitt verwendet. Bei „false“ wird in den Headern auf geraden Seiten defaultHeaderId verwendet. Wenn kein Wert festgelegt ist, wird der Wert aus dem vorherigen SectionStyle (SectionBreak's) übernommen. Wenn der Wert im ersten SectionBreak nicht festgelegt ist, wird er aus dem evenPageHeaderId von DocumentStyle übernommen.

Diese Eigenschaft ist schreibgeschützt.

pageNumberStart

integer

Die Seitenzahl, ab der die Seitenanzahl für diesen Abschnitt gezählt werden soll. Wenn die Richtlinie nicht konfiguriert ist, wird die Seitennummerierung aus dem vorherigen Abschnitt fortgesetzt. Wenn der Wert im ersten SectionBreak nicht festgelegt ist, verweisen Sie auf pageNumberStart von DocumentStyle.

Beim Aktualisieren dieser Eigenschaft ist die Festlegung eines konkreten Werts erforderlich. Wenn Sie dieses Attribut zurücksetzen, wird ein Fehler vom Typ „400 Bad Request“ angezeigt.

flipPageOrientation

boolean

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

Beim Aktualisieren dieser Eigenschaft ist die Festlegung eines konkreten Werts erforderlich. Wenn Sie dieses Attribut zurücksetzen, wird ein Fehler vom Typ „400 Bad Request“ angezeigt.

SectionColumnProperties

Eigenschaften, die für die Spalte eines Abschnitts gelten.

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 den Spalten.

Enums
COLUMN_SEPARATOR_STYLE_UNSPECIFIED Ein nicht spezifizierter Spaltentrennzeichenstil.
NONE Keine Spaltentrennzeichen zwischen den Spalten.
BETWEEN_EACH_COLUMN Gibt eine Spaltentrennlinie zwischen den einzelnen Spalten wieder.

SectionType

Stellt dar, wie der Anfang des aktuellen Abschnitts im Verhältnis zum vorherigen Abschnitt positioniert wird.

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

Tabelle

Ein StructuralElement, das 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.

Es ist möglich, dass eine Tabelle nicht rechteckig ist, sodass einige Zeilen eine unterschiedliche Anzahl von Zellen haben.

tableRows[]

object (TableRow)

Inhalt und Stil der einzelnen Zeilen

suggestedInsertionIds[]

string

Die vorgeschlagenen Einfügungs-IDs. Eine Table kann mehrere Einfügungs-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 vorgeschlagenen Lösch-IDs. Wenn das Feld leer ist, werden keine Vorschläge zum Löschen dieses Inhalts vorgeschlagen.

tableStyle

object (TableStyle)

Der Stil der Tabelle.

TableRow

Der Inhalt und der Stil einer Zeile in einem 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.

Es ist möglich, dass eine Tabelle nicht rechteckig ist, sodass einige Zeilen eine andere Anzahl von Zellen haben als andere Zeilen in derselben Tabelle.

suggestedInsertionIds[]

string

Die vorgeschlagenen Einfügungs-IDs. Eine TableRow kann mehrere Einfügungs-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 vorgeschlagenen Lösch-IDs. Wenn das Feld leer ist, werden keine Vorschläge zum Löschen dieses Inhalts vorgeschlagen.

tableRowStyle

object (TableRowStyle)

Der Stil der Tabellenzeile.

suggestedTableRowStyleChanges

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

Die vorgeschlagenen Stiländerungen an dieser Zeile, angegeben durch die Vorschlags-ID.

TableCell

Der Inhalt und der 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. Eine TableCell kann mehrere Einfügungs-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 vorgeschlagenen Lösch-IDs. Wenn das Feld leer ist, werden keine Vorschläge zum Löschen dieses Inhalts vorgeschlagen.

suggestedTableCellStyleChanges

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

Die vorgeschlagenen Änderungen am Stil der Tabellenzellen, angegeben durch die Vorschlags-ID.

TableCellStyle

Der Stil eines TableCell.

Übernommene Stile für Tabellenzellen 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.

Diese Eigenschaft ist schreibgeschützt.

columnSpan

integer

Die Spaltenspanne der Zelle.

Diese Eigenschaft ist schreibgeschützt.

backgroundColor

object (OptionalColor)

Die Hintergrundfarbe der Zelle.

borderLeft

object (TableCellBorder)

Der linke Rand der Zelle.

borderRight

object (TableCellBorder)

Den rechten Rand der Zelle.

borderTop

object (TableCellBorder)

Oberer Rahmen der Zelle

borderBottom

object (TableCellBorder)

Der untere Rahmen der Zelle.

paddingLeft

object (Dimension)

Der linke Abstand der Zelle.

paddingRight

object (Dimension)

Den rechten Rand der Zelle.

paddingTop

object (Dimension)

Oberer Abstand der Zelle.

paddingBottom

object (Dimension)

Der untere Abstand der Zelle.

contentAlignment

enum (ContentAlignment)

Ausrichtung des Inhalts in der Tabellenzelle. Die Standardausrichtung entspricht der Ausrichtung neu erstellter Tabellenzellen im Docs-Editor.

TableCellBorder

Ein Rahmen um eine Tabellenzelle.

Die Rahmen von Tabellenzellen dürfen nicht transparent sein. Wenn der Rahmen einer Tabellenzelle ausgeblendet werden soll, legen Sie für die Breite „0“ fest.

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

object (OptionalColor)

Die Farbe des Rahmens.

Diese Farbe darf nicht transparent sein.

width

object (Dimension)

Die Breite des Rahmens.

dashStyle

enum (DashStyle)

Der Bindestrich-Stil des Rahmens.

ContentAlignment

Die Arten der inhaltlichen Ausrichtung.

Abgeleitet von einer Teilmenge der Werte des „ST_TextAnchoringType“ Geben Sie in Abschnitt 20.1.10.59 von „Office Open XML File Formats – Fundamentals and Markup Language Reference“, Teil 1 der 4. Ausgabe ECMA-376 ein.

Enums
CONTENT_ALIGNMENT_UNSPECIFIED Eine nicht spezifizierte Inhaltsausrichtung. Die Inhaltsausrichtung wird vom übergeordneten Element übernommen, sofern vorhanden.
CONTENT_ALIGNMENT_UNSUPPORTED Eine nicht unterstützte Inhaltsausrichtung.
TOP Eine Ausrichtung, die den Inhalt am oberen Rand des Inhaltsinhabers ausrichtet. Entspricht ECMA-376 ST_TextAnchoringType 't'.
MIDDLE Eine Ausrichtung, durch die der Inhalt an der Mitte des Inhaltsinhabers ausgerichtet wird. Entspricht ECMA-376 ST_TextAnchoringType "ctr".
BOTTOM Eine Ausrichtung, durch die 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)

Ein TableCellStyle, der nur die in diesem Vorschlag vorgenommenen Änderungen enthält. Dies kann zusammen mit dem tableCellStyleSuggestionState verwendet werden, um zu sehen, welche Felder sich geändert haben und welche neuen Werte sie enthalten.

tableCellStyleSuggestionState

object (TableCellStyleSuggestionState)

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

TableCellStyleSuggestionState

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

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 ein Änderungsvorschlag für „rowSpan“ vorliegt.

columnSpanSuggested

boolean

Gibt an, ob ein Änderungsvorschlag für „columnSpan“ vorliegt.

backgroundColorSuggested

boolean

Gibt an, ob ein Änderungsvorschlag für „backgroundColor“ vorliegt.

borderLeftSuggested

boolean

Gibt an, ob ein Änderungsvorschlag für „borderLeft“ vorliegt.

borderRightSuggested

boolean

Gibt an, ob ein Änderungsvorschlag für „borderRight“ vorliegt.

borderTopSuggested

boolean

Gibt an, ob ein Änderungsvorschlag für „borderTop“ vorliegt.

borderBottomSuggested

boolean

Gibt an, ob ein Änderungsvorschlag für „borderBottom“ vorliegt.

paddingLeftSuggested

boolean

Gibt an, ob ein Änderungsvorschlag für „paddingLeft“ vorliegt.

paddingRightSuggested

boolean

Gibt an, ob ein Änderungsvorschlag für „paddingRight“ vorliegt.

paddingTopSuggested

boolean

Gibt an, ob ein Änderungsvorschlag für „paddingTop“ vorliegt.

paddingBottomSuggested

boolean

Gibt an, ob ein Änderungsvorschlag für „paddingBottom“ vorliegt.

contentAlignmentSuggested

boolean

Gibt an, ob ein Änderungsvorschlag für „contentAlignment“ vorliegt.

TableRowStyle

Stile, die auf eine Tabellenzeile angewendet werden.

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

object (Dimension)

Die minimale Höhe der Zeile. Die Zeile wird im Docs-Editor in einer Höhe von mindestens diesem Wert gerendert, damit der gesamte Inhalt der Zellen der Zeile zu sehen ist.

tableHeader

boolean

Gibt an, ob die Zeile eine Tabellenüberschrift ist.

preventOverflow

boolean

Gibt an, ob die Zeile nicht über die Seiten- oder Spaltengrenzen hinweg überläuft.

SuggestedTableRowStyle

Ein Änderungsvorschlag für TableRowStyle.

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

object (TableRowStyle)

Ein TableRowStyle, der nur die in diesem Vorschlag vorgenommenen Änderungen enthält. Dies kann zusammen mit dem tableRowStyleSuggestionState verwendet werden, um zu sehen, welche Felder sich geändert haben und welche neuen Werte sie enthalten.

tableRowStyleSuggestionState

object (TableRowStyleSuggestionState)

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

TableRowStyleSuggestionState

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

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

boolean

Gibt an, ob ein Änderungsvorschlag für „minRowHeight“ vorliegt.

TableStyle

Stile, die auf eine Tabelle angewendet werden.

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

object (TableColumnProperties)

Die Eigenschaften der einzelnen Spalten.

Beachten Sie, dass in Google Docs Zeilen und Zeilen Zellen enthalten, ähnlich wie bei HTML. Daher sind die Eigenschaften für eine Zeile im tableRowStyle der Zeile zu finden.

TableColumnProperties

Die Eigenschaften einer Spalte in einer Tabelle.

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

enum (WidthType)

Der Breitentyp 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 ist gleichmäßig auf die anderen gleichmäßig verteilten Spalten verteilt.

Die Breite der Spalte wird automatisch bestimmt und entspricht einem Teil der Breite der Tabelle, nachdem alle Spalten mit einer bestimmten Breite berücksichtigt wurden.

FIXED_WIDTH Eine feste Spaltenbreite. Die Eigenschaft [width][google.apps.docs.v1.TableColumnProperties.width] enthält die Breite der Spalte.

TableOfContents

Ein StructuralElement, das 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ügungs-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 vorgeschlagenen Lösch-IDs. Wenn das Feld leer ist, werden keine Vorschläge zum Löschen dieses Inhalts vorgeschlagen.

Fußnote

Eine Dokumentfußnote.

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

string

ID der Fußnote.

content[]

object (StructuralElement)

Der Inhalt der Fußnote.

Die Indizes für den Inhalt einer Fußnote beginnen 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
}
Felder
background

object (Background)

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

defaultHeaderId

string

Die ID des Standardheaders. Wenn die Richtlinie nicht konfiguriert ist, gibt es keinen Standardheader.

Diese Eigenschaft ist schreibgeschützt.

evenPageHeaderId

string

Die ID des Headers, die nur bei geraden Seiten verwendet wird. Der Wert von useEvenPageHeaderFooter bestimmt, ob defaultHeaderId oder dieser Wert für den Header auf geraden Seiten verwendet wird. Wenn die Richtlinie nicht konfiguriert ist, gibt es keine gerade Kopfzeile.

Diese Eigenschaft ist schreibgeschützt.

firstPageHeaderId

string

Die ID der Kopfzeile, die nur für die erste Seite verwendet wird. Wenn nicht festgelegt, existiert keine eindeutige Kopfzeile für die erste Seite. Der Wert von useFirstPageHeaderFooter bestimmt, ob defaultHeaderId oder dieser Wert für die Kopfzeile auf der ersten Seite verwendet wird. Wenn die Richtlinie nicht konfiguriert ist, wird keine Kopfzeile für die erste Seite angezeigt.

Diese Eigenschaft ist schreibgeschützt.

pageNumberStart

integer

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

marginTop

object (Dimension)

Der obere Seitenrand.

Wenn Sie den oberen Seitenrand des Dokumentstils aktualisieren, wird der obere Seitenrand aus allen Abschnittsstilen gelöscht.

marginBottom

object (Dimension)

Der untere Seitenrand.

Wenn Sie den unteren Seitenrand des Dokumentstils aktualisieren, wird er aus allen Abschnittsstilen gelöscht.

marginRight

object (Dimension)

Der rechte Seitenrand.

Wenn Sie den rechten Seitenrand des Dokumentstils aktualisieren, wird der rechte Seitenrand aus allen Abschnittsstilen gelöscht. Es kann auch dazu führen, dass die Größe der Spalten in allen Bereichen angepasst wird.

marginLeft

object (Dimension)

Der linke Seitenrand.

Wenn Sie den linken Seitenrand des Dokumentstils aktualisieren, wird der linke Seitenrand aus allen Abschnittsstilen gelöscht. Es kann auch dazu führen, dass die Größe der Spalten in allen Bereichen angepasst wird.

pageSize

object (Size)

Die Größe einer Seite im Dokument.

marginHeader

object (Dimension)

Der Abstand zwischen dem Seitenanfang und dem Inhalt der Kopfzeile.

flipPageOrientation

boolean

Optional. Gibt an, ob die Abmessungen von pageSize gedreht werden sollen, um die Seitenausrichtung zwischen Hoch- und Querformat zu ändern.

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.

SuggestedDocumentStyle

Ein Änderungsvorschlag für DocumentStyle.

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

object (DocumentStyle)

Ein DocumentStyle, der nur die in diesem Vorschlag vorgenommenen Änderungen enthält. Dies kann zusammen mit dem documentStyleSuggestionState verwendet werden, um zu sehen, welche Felder sich geändert haben und welche neuen Werte sie enthalten.

documentStyleSuggestionState

object (DocumentStyleSuggestionState)

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

DocumentStyleSuggestionState

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

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 der Felder in background gemäß diesem Vorschlag geändert wurden.

defaultHeaderIdSuggested

boolean

Gibt an, ob ein Änderungsvorschlag für „defaultHeaderId“ vorliegt.

evenPageHeaderIdSuggested

boolean

Gibt an, ob ein Änderungsvorschlag für „evenPageHeaderId“ vorliegt.

firstPageHeaderIdSuggested

boolean

Gibt an, ob ein Änderungsvorschlag für „firstPageHeaderId“ vorliegt.

pageNumberStartSuggested

boolean

Gibt an, ob ein Änderungsvorschlag für „pageNumberStart“ vorliegt.

marginTopSuggested

boolean

Gibt an, ob ein Änderungsvorschlag für „marginTop“ vorliegt.

marginBottomSuggested

boolean

Gibt an, ob ein Änderungsvorschlag für „marginBottom“ vorliegt.

marginRightSuggested

boolean

Gibt an, ob ein Änderungsvorschlag für „marginRight“ vorliegt.

marginLeftSuggested

boolean

Gibt an, ob ein Änderungsvorschlag für „marginLeft“ vorliegt.

pageSizeSuggestionState

object (SizeSuggestionState)

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

marginHeaderSuggested

boolean

Gibt an, ob ein Änderungsvorschlag für „marginHeader“ vorliegt.

flipPageOrientationSuggested

boolean

Optional. Gibt an, ob ein Änderungsvorschlag für „flipPageOrientation“ vorliegt.

BackgroundSuggestionState

Eine Maske, die angibt, welche der Felder auf der 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 der Felder auf der 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 ein Änderungsvorschlag für „height“ vorliegt.

widthSuggested

boolean

Gibt an, ob ein Änderungsvorschlag für „width“ vorliegt.

NamedStyles

Die benannten Stile. Absätze im Dokument können ihre TextStyle und ParagraphStyle aus diesen benannten Stilen übernehmen.

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

object (NamedStyle)

Die benannten Stile.

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 aus 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 dieses benannten Stils.

textStyle

object (TextStyle)

Der Textstil des benannten Stils.

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)

Ein NamedStyles, der nur die in diesem Vorschlag vorgenommenen Änderungen enthält. Dies kann zusammen mit dem namedStylesSuggestionState verwendet werden, um zu sehen, welche Felder sich geändert haben und welche neuen Werte sie enthalten.

namedStylesSuggestionState

object (NamedStylesSuggestionState)

Eine Maske, die angibt, welche der Felder auf der 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 der Felder auf dem entsprechenden NamedStyle in styles gemäß diesem Vorschlag geändert wurden.

Die Reihenfolge dieser benannten Stilvorschläge entspricht der Reihenfolge des entsprechenden benannten Stils im Vorschlag named styles.

NamedStyleSuggestionState

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 dient zur Vereinfachung des Abgleichs von NamedStyleSuggestionState mit dem entsprechenden NamedStyle-Wert.

textStyleSuggestionState

object (TextStyleSuggestionState)

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

paragraphStyleSuggestionState

object (ParagraphStyleSuggestionState)

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

Liste

Eine Liste 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, verweist in der bullet 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, angegeben durch die Vorschlags-ID.

suggestedInsertionId

string

Die vorgeschlagene Platzhalter-ID. Wenn das Feld leer ist, handelt es sich nicht um eine vorgeschlagene Einfügung.

suggestedDeletionIds[]

string

Die vorgeschlagenen Lösch-IDs. Ist das Feld leer, werden keine Löschvorschläge für diese Liste vorgeschlagen.

ListProperties

Die Eigenschaften einer list, die das Aussehen und Verhalten von Aufzählungspunkten 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 hat höchstens 9 Verschachtelungsebenen, wobei die Verschachtelungsebene 0 der obersten Ebene und die Verschachtelungsebene 8 der am stärksten verschachtelten Ebene entspricht. Die Verschachtelungsebenen werden in aufsteigender Reihenfolge zurückgegeben, wobei die am wenigsten verschachtelte Ebene zuerst zurückgegeben wird.

NestingLevel

Enthält Eigenschaften, die das Aussehen und Verhalten eines Listenpunkts auf einer bestimmten Verschachtelungsebene beschreiben.

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

  // Union field glyph_kind can be only one of the following:
  "glyphType": enum (GlyphType),
  "glyphSymbol": string
  // End of list of possible types for union field glyph_kind.
}
Felder
bulletAlignment

enum (BulletAlignment)

Die Ausrichtung des Aufzählungszeichens innerhalb des Bereichs, der für das Rendering des Aufzählungszeichens vorgesehen ist.

glyphFormat

string

Der Formatstring, der von Aufzählungspunkten 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 das gerenderte Symbol den Platzhalter durch das entsprechende Symbol für Verschachtelungsebene 0 ersetzt, gefolgt von einem Punkt als Suffix. Eine Liste mit dem Glyphentyp UPPER_ALPHA und dem Glyphenformat %0. bei 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. Beispielsweise kann eine Liste das Glyphenformat %0. auf Verschachtelungsebene 0 und das Glyphenformat %0.%1. auf Verschachtelungsebene 1 haben. Wenn beide Verschachtelungsebenen DECIMAL Glyphentypen haben, würde dies zu einer Liste mit gerenderten Glyphen führen.

1.

2.

2.1.

2.2.

3.

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

indentFirstLine

object (Dimension)

Der Einzug der ersten Zeile von Absätzen bei dieser Verschachtelungsebene.

indentStart

object (Dimension)

Der Einzug für Absätze auf dieser Verschachtelungsebene. Wird basierend auf der Inhaltsrichtung des Absatzes auf die Seite angewendet, die dem Textanfang entspricht.

textStyle

object (TextStyle)

Der Textstil der Aufzählungszeichen auf dieser Verschachtelungsebene.

startNumber

integer

Die Nummer des ersten Listenelements auf dieser Verschachtelungsebene.

Ein Wert von 0 wird bei Listen mit Buchstaben und Listen mit römischen Zahlen als der Wert 1 behandelt. Bei den Werten 0 und 1 beginnen Listen mit Buchstaben und römischen Zahlen bei a bzw. i.

Bei Verschachtelungsebenen mit ungeordneten Glyphen wird dieser Wert ignoriert.

Union-Feld glyph_kind. Die Art von Glyphe, die für Aufzählungszeichen verwendet wird. Hiermit wird das Symbol für Aufzählungszeichen definiert, das die Platzhalter in glyph_format ersetzt. Für glyph_kind ist nur einer der folgenden Werte zulässig:
glyphType

enum (GlyphType)

Der Glyphentyp, der von Aufzählungspunkten verwendet wird, wenn Absätze auf dieser Verschachtelungsebene angeordnet sind.

Der Glyphentyp bestimmt den Glyphentyp, der verwendet wird, um Platzhalter in glyphFormat zu ersetzen, wenn Absätze auf dieser Verschachtelungsebene angeordnet sind. Wenn die Verschachtelungsebene beispielsweise 0 ist, glyphFormat den Wert %0. und der Glyphentyp DECIMAL hat, ersetzt die gerenderte Glyphe den Platzhalter %0 im Glyphenformat durch eine Zahl, die der Reihenfolge des Listenelements in der Liste entspricht.

glyphSymbol

string

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

Das Glyphensymbol ersetzt Platzhalter in glyphFormat. Wenn beispielsweise das glyphSymbol der Vollkreis ist, der dem Unicode-U+25cf-Codepunkt entspricht, und glyphFormat %0 ist, wäre das gerenderte Glyphe der ausgefüllte Kreis.

BulletAlignment

Die Ausrichtungsarten für einen Aufzählungspunkt.

Enums
BULLET_ALIGNMENT_UNSPECIFIED Die Ausrichtung der Aufzählungszeichen ist nicht angegeben.
START Der Aufzählungspunkt ist am Anfang des Bereichs ausgerichtet, der für das Rendern des Aufzählungszeichens vorgesehen ist. Linksbündig für LTR-Text, ansonsten rechtsbündig.
CENTER Das Aufzählungszeichen ist an der Mitte des Bereichs ausgerichtet, der für das Rendern des Aufzählungszeichens vorgesehen ist.
END Der Aufzählungspunkt ist am Ende des Bereichs ausgerichtet, der für das Rendern des Aufzählungszeichens vorgesehen ist. Rechtsbündig für LTR-Text, ansonsten linksbündig.

GlyphType

Die Glyphentypen, die von Aufzählungspunkten verwendet werden, wenn Absätze auf dieser Verschachtelungsebene angeordnet sind.

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 wird keine Null vorangestellt.
UPPER_ALPHA Einen Großbuchstaben wie A, B oder C.
ALPHA Ein Kleinbuchstabe wie a, b oder c.
UPPER_ROMAN Eine große römische Zahl wie I, II oder III.
ROMAN Eine kleingeschriebene römische Zahl wie i, ii oder iii.

SuggestedListProperties

Ein Änderungsvorschlag für ListProperties.

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

object (ListProperties)

Ein ListProperties, der nur die in diesem Vorschlag vorgenommenen Änderungen enthält. Dies kann zusammen mit dem listPropertiesSuggestionState verwendet werden, um zu sehen, welche Felder sich geändert haben und welche neuen Werte sie enthalten.

listPropertiesSuggestionState

object (ListPropertiesSuggestionState)

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

ListPropertiesSuggestionState

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

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

object (NestingLevelSuggestionState)

Eine Maske, die angibt, welche der Felder auf dem entsprechenden NestingLevel in nestingLevels gemäß 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 der Felder auf der Basis NestingLevel in diesem Vorschlag geändert wurden. Für jedes Feld, das auf „true“ gesetzt ist, gibt es einen neuen vorgeschlagenen Wert.

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 ein Änderungsvorschlag für „bulletAlignment“ vorliegt.

glyphTypeSuggested

boolean

Gibt an, ob ein Änderungsvorschlag für „glyphType“ vorliegt.

glyphFormatSuggested

boolean

Gibt an, ob ein Änderungsvorschlag für „glyphFormat“ vorliegt.

glyphSymbolSuggested

boolean

Gibt an, ob ein Änderungsvorschlag für „glyphSymbol“ vorliegt.

indentFirstLineSuggested

boolean

Gibt an, ob ein Änderungsvorschlag für „indentFirstLine“ vorliegt.

indentStartSuggested

boolean

Gibt an, ob ein Änderungsvorschlag für „indentStart“ vorliegt.

textStyleSuggestionState

object (TextStyleSuggestionState)

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

startNumberSuggested

boolean

Gibt an, ob ein Änderungsvorschlag für „startNumber“ vorliegt.

NamedRanges

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

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

string

Der Name, den alle named ranges gemeinsam verwenden.

namedRanges[]

object (NamedRange)

Die NamedRanges mit demselben Namen.

NamedRange

Eine Sammlung von Ranges mit derselben benannten Bereichs-ID.

Mit benannten Bereichen können Entwickler Teile eines Dokuments mit einem beliebigen benutzerdefinierten Label verknüpfen, sodass ihr Inhalt später programmatisch gelesen oder bearbeitet werden kann. 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 und Inhalte, die in einen benannten Bereich eingefügt werden, erweitern diesen Bereich in der Regel. Bestimmte Dokumentänderungen 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 Kopf-, Fußzeile oder Fußnote, die dieser Bereich enthält. Eine leere Segment-ID kennzeichnet den Textkörper des Dokuments.

startIndex

integer

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

Bei allen aktuellen Verwendungen 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, ausschließlich, in UTF-16-Codeeinheiten.

Bei allen aktuellen Verwendungen 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 keine Angabe gemacht wird, gilt die Anfrage für den ersten Tab.

In einem Dokument mit einem einzelnen Tab:

  • Falls angegeben, muss dies mit der ID des Tabs im Singular übereinstimmen.

  • Wenn keine Angabe gemacht wird, gilt die Anfrage für den Tab „Singular“.

In einem Dokument mit mehreren Tabs:

  • Sofern angegeben, gilt die Anfrage für den angegebenen Tab.

  • Wenn keine Angabe gemacht wird, gilt die Anfrage für den ersten Tab im Dokument.

InlineObject

Ein Objekt, das inline mit Text erscheint. Ein InlineObject enthält ein EmbeddedObject, wie 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 zum Aktualisieren der Eigenschaften eines Objekts verwendet werden.

inlineObjectProperties

object (InlineObjectProperties)

Die Eigenschaften dieses Inline-Objekts.

suggestedInlineObjectPropertiesChanges

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

Die vorgeschlagenen Änderungen an den Inline-Objekteigenschaften, angegeben mit der Vorschlags-ID.

suggestedInsertionId

string

Die vorgeschlagene Platzhalter-ID. Wenn das Feld leer ist, handelt es sich nicht um eine vorgeschlagene Einfügung.

suggestedDeletionIds[]

string

Die vorgeschlagenen Lösch-IDs. Wenn das Feld leer ist, werden keine Vorschläge zum Löschen dieses Inhalts vorgeschlagen.

InlineObjectProperties

Attribute eines InlineObject.

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

object (EmbeddedObject)

Das eingebettete Objekt dieses Inline-Objekts

EmbeddedObject

Ein im Dokument eingebettetes Objekt.

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)
  },

  // Union field properties can be only one of the following:
  "embeddedDrawingProperties": {
    object (EmbeddedDrawingProperties)
  },
  "imageProperties": {
    object (ImageProperties)
  }
  // End of list of possible types for union field properties.
}
Felder
title

string

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

description

string

Die Beschreibung des eingebetteten Objekts. title und description werden kombiniert, um den 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 den extern verknüpften Quellinhalt. Beispielsweise enthält es einen Verweis auf das Google Tabellen-Quelldiagramm, wenn das eingebettete Objekt ein verknüpftes Diagramm ist.

Wenn die Richtlinie nicht konfiguriert ist, ist das eingebettete Objekt nicht verknüpft.

Union-Feld properties. Die für jeden eingebetteten Objekttyp spezifischen Eigenschaften. Für properties ist nur einer der folgenden Werte zulässig:
embeddedDrawingProperties

object (EmbeddedDrawingProperties)

Die Eigenschaften einer eingebetteten Zeichnung.

imageProperties

object (ImageProperties)

Die Eigenschaften eines Bildes.

EmbeddedDrawingProperties

Dieser Typ hat keine Felder.

Die Eigenschaften einer eingebetteten Zeichnung, die zur Unterscheidung des Objekttyps verwendet werden. Eine eingebettete Zeichnung wird in einem Dokument erstellt und bearbeitet. Ausführliche Details werden nicht unterstützt.

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 für das Image mit einer Standardlebensdauer von 30 Minuten. Dieser URI ist mit dem Konto des Anforderers getaggt. Jeder, der über den URI verfügt, greift als ursprünglicher Anforderer auf das Bild zu. Der Zugriff auf das Bild kann verloren gehen, wenn sich die Freigabeeinstellungen des Dokuments ändern.

sourceUri

string

Der Quell-URI ist der URI, mit dem das Bild eingefügt wird. Der Quell-URI kann leer sein.

brightness

number

Der Helligkeitseffekt des Bildes. Der Wert sollte im Intervall [-1,0; 1,0] liegen, wobei 0 keine Auswirkung bedeutet.

contrast

number

Der Kontrasteffekt des Bildes. Der Wert sollte im Intervall [-1,0; 1,0] liegen, wobei 0 keine Auswirkung bedeutet.

transparency

number

Der Transparenzeffekt des Bildes. Der Wert sollte im Intervall [0,0; 1,0] liegen, wobei 0 keine Auswirkung und 1 transparent ist.

cropProperties

object (CropProperties)

Die Zuschneideeigenschaften des Bildes.

angle

number

Der Rotationswinkel des Bildes im Uhrzeigersinn in Radiant.

CropProperties

Die Zuschneideeigenschaften eines Bilds.

Das Zuschneide-Rechteck wird durch einen Abstand von den vier Rändern des ursprünglichen Inhalts dargestellt.

  • Liegt der Versatz im Intervall (0, 1), wird die entsprechende Kante des Zuschneidebereichs innerhalb des ursprünglichen Begrenzungsrechtecks des Bilds positioniert.
  • Ist der Versatz negativ oder größer als 1, befindet sich die entsprechende Kante des Zuschneidebereichs außerhalb des ursprünglichen Begrenzungsrechtecks des Bilds.
  • Wenn alle Offsets und alle Rotationswinkel 0 sind, wird das Bild nicht zugeschnitten.
JSON-Darstellung
{
  "offsetLeft": number,
  "offsetRight": number,
  "offsetTop": number,
  "offsetBottom": number,
  "angle": number
}
Felder
offsetLeft

number

Der Versatz gibt an, wie weit innen die linke Kante des Zuschneidebereichs von der linken Seite des Originalinhalts entfernt ist – ein Bruchteil der Breite des ursprünglichen Inhalts.

offsetRight

number

Der Versatz gibt an, wie weit innen rechts der Zuschneidebereich vom rechten Rand des Originalinhalts entfernt ist – ein Bruchteil der Breite des ursprünglichen Inhalts.

offsetTop

number

Der Versatz gibt an, wie weit innen die obere Kante des Zuschneidebereichs vom oberen Rand des ursprünglichen Inhalts entfernt ist – ein Bruchteil der Höhe des ursprünglichen Inhalts.

offsetBottom

number

Der Versatz gibt an, wie weit innen die Unterkante des Zuschneidebereichs vom unteren Rand des ursprünglichen Inhalts entfernt ist – ein Bruchteil der Höhe des ursprünglichen Inhalts.

angle

number

Der Drehwinkel des Zuschneidebereichs um seinen Mittelpunkt im Uhrzeigersinn im Bogenmaß. Die Drehung wird nach den Offsets angewendet.

EmbeddedObjectBorder

Rahmen um 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 Bindestrich-Stil des Rahmens.

propertyState

enum (PropertyState)

Der Status der Grenzeigenschaft.

PropertyState

Die möglichen Status einer Eigenschaft.

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

LinkedContentReference

Ein Verweis auf den extern verknüpften Quellinhalt.

JSON-Darstellung
{

  // Union field reference can be only one of the following:
  "sheetsChartReference": {
    object (SheetsChartReference)
  }
  // End of list of possible types for union field reference.
}
Felder
Union-Feld reference. Die Referenz, die für die Art der verknüpften Inhalte spezifisch ist. Für reference ist nur einer der folgenden Werte zulässig:
sheetsChartReference

object (SheetsChartReference)

Ein Verweis auf das verknüpfte Diagramm.

SheetsChartReference

Ein Verweis auf ein verknüpftes Diagramm, das aus Google Tabellen eingebettet ist

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

string

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

chartId

integer

Die ID des Diagramms in der Tabelle in Google Tabellen, die eingebettet ist.

SuggestedInlineObjectProperties

Ein Änderungsvorschlag für InlineObjectProperties.

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

object (InlineObjectProperties)

Ein InlineObjectProperties, das nur die in diesem Vorschlag vorgenommenen Änderungen enthält. Dies kann zusammen mit dem inlineObjectPropertiesSuggestionState verwendet werden, um zu sehen, welche Felder sich geändert haben und welche neuen Werte sie enthalten.

inlineObjectPropertiesSuggestionState

object (InlineObjectPropertiesSuggestionState)

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

InlineObjectPropertiesSuggestionState

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

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

object (EmbeddedObjectSuggestionState)

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

EmbeddedObjectSuggestionState

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

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 der Felder in embeddedDrawingProperties gemäß diesem Vorschlag geändert wurden.

imagePropertiesSuggestionState

object (ImagePropertiesSuggestionState)

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

titleSuggested

boolean

Gibt an, ob ein Änderungsvorschlag für „title“ vorliegt.

descriptionSuggested

boolean

Gibt an, ob ein Änderungsvorschlag für „description“ vorliegt.

embeddedObjectBorderSuggestionState

object (EmbeddedObjectBorderSuggestionState)

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

sizeSuggestionState

object (SizeSuggestionState)

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

marginLeftSuggested

boolean

Gibt an, ob ein Änderungsvorschlag für „marginLeft“ vorliegt.

marginRightSuggested

boolean

Gibt an, ob ein Änderungsvorschlag für „marginRight“ vorliegt.

marginTopSuggested

boolean

Gibt an, ob ein Änderungsvorschlag für „marginTop“ vorliegt.

marginBottomSuggested

boolean

Gibt an, ob ein Änderungsvorschlag für „marginBottom“ vorliegt.

linkedContentReferenceSuggestionState

object (LinkedContentReferenceSuggestionState)

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

EmbeddedDrawingPropertiesSuggestionState

Dieser Typ hat keine Felder.

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

ImagePropertiesSuggestionState

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

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

boolean

Gibt an, ob ein Änderungsvorschlag für „contentUri“ vorliegt.

sourceUriSuggested

boolean

Gibt an, ob ein Änderungsvorschlag für [sourceUri] vorliegt [google.apps.docs.v1.EmbeddedObject.source_uri] ein.

brightnessSuggested

boolean

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

contrastSuggested

boolean

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

transparencySuggested

boolean

Gibt an, ob ein Änderungsvorschlag für [Transparenz] vorliegt [google.apps.docs.v1.EmbeddedObject.transparency] an.

cropPropertiesSuggestionState

object (CropPropertiesSuggestionState)

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

angleSuggested

boolean

Gibt an, ob eine vorgeschlagene Änderung für [Winkel] vorliegt [google.apps.docs.v1.EmbeddedObject.angle] an.

CropPropertiesSuggestionState

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

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

boolean

Gibt an, ob ein Änderungsvorschlag für „offsetLeft“ vorliegt.

offsetRightSuggested

boolean

Gibt an, ob ein Änderungsvorschlag für „offsetRight“ vorliegt.

offsetTopSuggested

boolean

Gibt an, ob ein Änderungsvorschlag für „offsetTop“ vorliegt.

offsetBottomSuggested

boolean

Gibt an, ob ein Änderungsvorschlag für „offsetBottom“ vorliegt.

angleSuggested

boolean

Gibt an, ob ein Änderungsvorschlag für „angle“ vorliegt.

EmbeddedObjectBorderSuggestionState

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

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

boolean

Gibt an, ob ein Änderungsvorschlag für [color] vorliegt [google.apps.docs.v1.EmbeddedBorderObject.color] aus.

widthSuggested

boolean

Gibt an, ob eine vorgeschlagene Änderung für [width] vorliegt [google.apps.docs.v1.EmbeddedBorderObject.width] aus.

dashStyleSuggested

boolean

Gibt an, ob ein Änderungsvorschlag für [dashStyle] vorliegt [google.apps.docs.v1.EmbeddedBorderObject.dash_style] aus.

propertyStateSuggested

boolean

Gibt an, ob eine vorgeschlagene Änderung für [propertyState] vorliegt [google.apps.docs.v1.EmbeddedBorderObject.property_state] an.

LinkedContentReferenceSuggestionState

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

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

object (SheetsChartReferenceSuggestionState)

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

SheetsChartReferenceSuggestionState

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

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

boolean

Gibt an, ob ein Änderungsvorschlag für „spreadsheetId“ vorliegt.

chartIdSuggested

boolean

Gibt an, ob ein Änderungsvorschlag für „chartId“ vorliegt.

PositionedObject

Ein Objekt, das per Tethering an ein Paragraph-Objekt 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 positionierten Objekteigenschaften, angegeben durch die Vorschlags-ID.

suggestedInsertionId

string

Die vorgeschlagene Platzhalter-ID. Wenn das Feld leer ist, handelt es sich nicht um eine vorgeschlagene Einfügung.

suggestedDeletionIds[]

string

Die vorgeschlagenen Lösch-IDs. Wenn das Feld leer ist, werden keine Vorschläge zum Löschen dieses Inhalts vorgeschlagen.

PositionedObjectProperties

Attribute eines PositionedObject.

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

object (PositionedObjectPositioning)

Die Position dieses positionierten Objekts relativ zum Zeilenumbruch von Paragraph, das auf dieses positionierte Objekt verweist.

embeddedObject

object (EmbeddedObject)

Das eingebettete Objekt dieses positionierten Objekts

PositionedObjectPositioning

Die Positionierung einer PositionedObject. Das positionierte Objekt wird relativ zum Anfang des Paragraph positioniert, an den es per Tethering angeschlossen 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 Versatz der linken Kante des positionierten Objekts relativ zum Anfang des Paragraph, an den es per Tethering angeschlossen ist. Die genaue Positionierung des Objekts kann von anderen Inhalten im Dokument und dem Stil des Dokuments abhängen.

topOffset

object (Dimension)

Der Versatz der oberen Kante des positionierten Objekts relativ zum Anfang des Paragraph, an den es per Tethering angeschlossen 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 umschließt das positionierte Objekt.
BREAK_LEFT Teilt den Text so auf, dass sich das positionierte Objekt auf der linken Seite und der Text auf der rechten Seite befindet.
BREAK_RIGHT Teilt den Text so auf, dass sich das positionierte Objekt auf der rechten Seite und der Text auf der linken Seite befindet.
BREAK_LEFT_RIGHT Teilt den Text so auf, dass sich links oder rechts neben dem 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)

Ein PositionedObjectProperties, der nur die in diesem Vorschlag vorgenommenen Änderungen enthält. Dies kann zusammen mit dem positionedObjectPropertiesSuggestionState verwendet werden, um zu sehen, welche Felder sich geändert haben und welche neuen Werte sie enthalten.

positionedObjectPropertiesSuggestionState

object (PositionedObjectPropertiesSuggestionState)

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

PositionedObjectPropertiesSuggestionState

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

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

object (PositionedObjectPositioningSuggestionState)

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

embeddedObjectSuggestionState

object (EmbeddedObjectSuggestionState)

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

PositionedObjectPositioningSuggestionState

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

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

boolean

Gibt an, ob ein Änderungsvorschlag für „layout“ vorliegt.

leftOffsetSuggested

boolean

Gibt an, ob ein Änderungsvorschlag für „leftOffset“ vorliegt.

topOffsetSuggested

boolean

Gibt an, ob ein Änderungsvorschlag für „topOffset“ vorliegt.

SuggestionsViewMode

Der auf das Dokument angewendete Ansichtsmodus für Vorschläge, der angibt, wie vorgeschlagene Änderungen dargestellt werden. Es bietet Optionen zum Lesen des Dokuments mit allen Vorschlägen direkt inline, mit angenommenen oder abgelehnten Vorschlägen.

Enums
DEFAULT_FOR_CURRENT_ACCESS Der auf das zurückgegebene Dokument angewendete "SuggestViewMode" 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 standardmäßige Ansichtsmodus für Vorschläge.
SUGGESTIONS_INLINE

Das zurückgegebene Dokument enthält inline Vorschläge. Vorgeschlagene Änderungen werden vom Basisinhalt im Dokument unterschieden.

Bei Anfragen zum Abrufen eines Dokuments in diesem Modus wird ein 403-Fehler zurückgegeben, wenn der Nutzer nicht berechtigt ist, vorgeschlagene Änderungen anzusehen.

PREVIEW_SUGGESTIONS_ACCEPTED

Das zurückgegebene Dokument ist eine Vorschau, in der alle vorgeschlagenen Änderungen akzeptiert wurden.

Bei Anfragen zum Abrufen eines Dokuments in diesem Modus wird ein 403-Fehler zurückgegeben, wenn der Nutzer nicht berechtigt ist, vorgeschlagene Änderungen anzusehen.

PREVIEW_WITHOUT_SUGGESTIONS Das zurückgegebene Dokument ist eine Vorschau, bei der alle vorgeschlagenen Änderungen abgelehnt werden, falls das Dokument Vorschläge enthält.

Methoden

batchUpdate

Wendet mindestens eine Aktualisierung auf das Dokument an.

create

Erstellt ein leeres Dokument mit dem in der Anfrage angegebenen Titel.

get

Ruft die neueste Version des angegebenen Dokuments ab.