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 Tabs, die in einem anderen Tab verschachtelt sind. 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 Version eines Dokuments Aktualisierungen angewendet werden sollen und wie sich die Anfrage verhalten soll, wenn das Dokument seit dieser Version 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 sich die Revision-ID zwischen den Aufrufen nicht ändert, hat sich das Dokument nicht geändert. Umgekehrt bedeutet eine geänderte ID (für dasselbe Dokument und denselben Nutzer) in der Regel, dass das Dokument aktualisiert wurde. Eine geänderte ID kann jedoch auch auf interne Faktoren wie Änderungen am ID-Format zurückzuführen sein.

suggestionsViewMode

enum (SuggestionsViewMode)

Nur Ausgabe. Der Vorschlagsmodus, der auf das Dokument angewendet wird.

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

body

object (Body)

Nur Ausgabe. Der Haupttext 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 oder nicht festgelegt 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 oder nicht festgelegt 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, sortiert nach Fußzeilen-ID.

Alt-Feld: Verwenden Sie stattdessen Document.tabs.documentTab.footers. Wenn der Parameter includeTabsContent auf true festgelegt ist, wird der tatsächliche Dokumentinhalt aus allen Tabs angezeigt. 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, sortiert nach Fußnoten-ID.

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 oder nicht festgelegt ist, enthält dieses Feld Informationen zum ersten Tab im Dokument.

documentStyle

object (DocumentStyle)

Nur Ausgabe. Der Stil des Dokuments.

Alt-Feld: Verwenden Sie stattdessen Document.tabs.documentTab.documentStyle. Wenn der Parameter includeTabsContent auf true festgelegt ist, wird der tatsächliche Dokumentinhalt aus allen Tabs angezeigt. Wenn false oder nicht festgelegt 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, sortiert nach Vorschlags-ID.

Alt-Feld: Verwenden Sie stattdessen Document.tabs.documentTab.suggestedDocumentStyleChanges. Wenn der Parameter includeTabsContent auf true festgelegt ist, wird der tatsächliche Dokumentinhalt aus allen Tabs angezeigt. 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.

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

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

lists

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

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

Alt-Feld: Verwenden Sie stattdessen Document.tabs.documentTab.lists. Wenn der Parameter includeTabsContent auf true festgelegt ist, wird der tatsächliche Dokumentinhalt aus allen Tabs angezeigt. Wenn false oder nicht festgelegt 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, sortiert nach Name.

Alt-Feld: Verwenden Sie stattdessen Document.tabs.documentTab.namedRanges. Wenn der Parameter includeTabsContent auf true festgelegt ist, wird der tatsächliche Dokumentinhalt aus allen Tabs angezeigt. Wenn false oder nicht festgelegt 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, sortiert nach Objekt-ID.

Alt-Feld: Verwenden Sie stattdessen Document.tabs.documentTab.inlineObjects. Wenn der Parameter includeTabsContent auf true festgelegt ist, wird der tatsächliche Dokumentinhalt aus allen Tabs angezeigt. Wenn false oder nicht festgelegt 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, sortiert nach Objekt-ID.

Alt-Feld: Verwenden Sie stattdessen Document.tabs.documentTab.positionedObjects. Wenn der Parameter includeTabsContent auf true festgelegt ist, wird der tatsächliche Dokumentinhalt aus allen Tabs angezeigt. Wenn false oder nicht festgelegt 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 Nutzer sichtbare Name des Tabs.

parentTabId

string

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

index

integer

Der nullbasierte Index des Tabs innerhalb des übergeordneten Elements.

nestingLevel

integer

Nur Ausgabe. Die Tiefe des Tabulators im Dokument. Tabs auf oberster Ebene beginnen bei 0.

DocumentTab

Ein Tab mit dem Inhalt des Dokuments.

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 Tab „Dokument“, sortiert 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 Tab „Dokument“.

suggestedNamedStylesChanges

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

Die vorgeschlagenen Änderungen an den benannten Stilen des Dokumenttabs, sortiert nach 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 Tab „Dokument“, sortiert 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 Tab „Dokument“, sortiert nach Objekt-ID.

Text

Den Textkörper des Dokuments.

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 Indizes für den Inhalt des Textkörpers beginnen bei null.

StructuralElement

Ein Strukturelement beschreibt Inhalte, die dem Dokument 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 strukturellen Elements. Für content ist nur einer der folgenden Werte zulässig:
paragraph

object (Paragraph)

Ein strukturelles Element vom Typ „Absatz“.

sectionBreak

object (SectionBreak)

Abschnittswechseltyp eines Strukturelements.

table

object (Table)

Ein Tabellentyp eines Strukturelements.

tableOfContents

object (TableOfContents)

Ein strukturelles Element vom Typ „Inhaltsverzeichnis“.

Absatz

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

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

object (ParagraphElement)

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

paragraphStyle

object (ParagraphStyle)

Der Stil dieses Absatzes.

suggestedParagraphStyleChanges

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

Der vorgeschlagene Absatzstil wird auf diesen Absatz angewendet, der anhand der Vorschlags-ID identifiziert wird.

bullet

object (Bullet)

Der Aufzählungspunkt für diesen Absatz. Wenn das nicht der Fall ist, gehört der Absatz nicht zu einer Liste.

suggestedBulletChanges

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

Die vorgeschlagenen Änderungen für den Punkt in diesem Absatz.

positionedObjectIds[]

string

Die IDs der positionierten Objekte, die mit diesem Absatz verknüpft 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 den Inhalt innerhalb eines 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 Endindex dieses Absatzelements (ab Null gezählt) 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 Textabsatzelement.

autoText

object (AutoText)

Ein Absatzelement mit automatisch generiertem Text.

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 Absatzelement mit einer horizontalen Linie.

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 Textblock mit demselben Stil darstellt.

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

string

Der Text dieses Laufs.

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

suggestedInsertionIds[]

string

Die vorgeschlagenen Anzeigenauftrags-IDs. Ein TextRun kann mehrere Anzeigen-IDs haben, wenn es sich um eine verschachtelte vorgeschlagene Änderung handelt. Wenn das Feld leer ist, handelt es sich nicht um einen vorgeschlagenen Eintrag.

suggestedDeletionIds[]

string

Die vorgeschlagenen IDs für das Löschen. Wenn das Feld leer ist, gibt es keine Vorschläge zum Löschen dieser Inhalte.

textStyle

object (TextStyle)

Der Textstil dieses Laufs.

suggestedTextStyleChanges

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

Der vorgeschlagene Textstil ändert sich für diesen Lauf, basierend auf der Vorschlags-ID.

TextStyle

Stellt die Formatierung dar, die 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:

  • Der TextStyle von Text in einem Paragraph wird vom entsprechenden named style type des Absatzes übernommen.
  • Der TextStyle auf einer named style erbt den Stil normal text.
  • Der TextStyle des Stils normal text wird vom Standardtextstil im Google Docs-Editor übernommen.
  • Der Textstil des TextStyle-Attributs eines Paragraph-Elements in einer Tabelle kann vom Tabellenstil übernommen werden.

Wenn der Textstil nicht von einem übergeordneten Element übernommen wird, wird der Stil durch das Entfernen von Feldern auf einen Wert zurückgesetzt, der den Standardwerten im Google Docs-Editor entspricht.

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

underline

boolean

Gibt an, ob der Text unterstrichen ist.

strikethrough

boolean

Gibt an, ob der Text durchgestrichen ist oder nicht.

smallCaps

boolean

Ob der Text in Kleinbuchstaben geschrieben ist oder nicht.

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 Texts.

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

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

Wenn weightedFontFamily festgelegt ist, muss auch weightedFontFamily#fontFamily mit einem nicht leeren Wert festgelegt werden. Andernfalls wird der Fehler 400 Bad Request zurückgegeben.

baselineOffset

enum (BaselineOffset)

Der vertikale Versatz des Texts von seiner normalen Position.

Text mit SUPERSCRIPT- oder SUBSCRIPT-Grundlinienabständen wird automatisch in einer kleineren Schriftgröße gerendert, die anhand des Felds fontSize berechnet wird. Änderungen an diesem Feld wirken sich nicht auf die fontSize aus.

OptionalColor

Eine Farbe, die entweder vollständig opak 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 dieser Wert nicht festgelegt ist, entspricht er einer transparenten Farbe.

Farbe

Eine einfarbige Farbe.

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

object (RgbColor)

Der RGB-Farbwert.

RgbColor

Eine RGB-Farbe.

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

number

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

green

number

Die grüne Komponente der Farbe. 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 einzigen 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 entspricht 1/72 Zoll.

WeightedFontFamily

Eine Schriftfamilie und -stärke von Text.

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

string

Die Schriftfamilie des Texts.

Die Schriftfamilie kann eine beliebige Schriftart aus dem Menü „Schriftart“ in Google Docs oder aus Google Fonts sein. Wenn der Name der Schriftart nicht erkannt wird, wird der Text in Arial gerendert.

weight

integer

Die Schriftstärke. Dieses Feld kann jeden Wert haben, der ein Vielfaches von 100 zwischen 100 und 900 (einschließlich) ist. Dieser Bereich entspricht den numerischen Werten, die in der CSS 2.1-Spezifikation in Abschnitt 15.6 beschrieben sind. Nicht numerische Werte sind nicht zulässig.

Der Standardwert ist 400 („normal“).

Die Schriftstärke ist nur eine Komponente der gerenderten Schriftstärke. 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 formatiert ist und die Gewichtung unter 400 liegt, wird eine Gewichtung von 400 angewendet.
  • Wenn der Text fett formatiert ist und das Gewicht größer oder gleich 400, aber kleiner als 700 ist, wird das Gewicht 700 gerendert.
  • Wenn das Gewicht größer oder gleich 700 ist, entspricht das gerenderte Gewicht dem Gewicht.
  • Wenn der Text nicht fett ist, entspricht die gerenderte Schriftstärke der Schriftstärke.

BaselineOffset

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

Enums
BASELINE_OFFSET_UNSPECIFIED Der Baseline-Versatz des Texts wird vom übergeordneten Element übernommen.
NONE Der Text ist nicht vertikal verschoben.
SUPERSCRIPT Der Text ist vertikal nach oben verschoben (Hochstellung).
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)

Eine TextStyle, die nur die in diesem Vorschlag vorgenommenen Änderungen enthält. Sie können diese Funktion zusammen mit textStyleSuggestionState verwenden, um zu sehen, welche Felder sich geändert haben und welche neuen Werte sie haben.

textStyleSuggestionState

object (TextStyleSuggestionState)

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

TextStyleSuggestionState

Eine Maske, die angibt, welche der Felder in der BasisTextStyle in diesem Vorschlag geändert wurden. Für jedes Feld, das auf „wahr“ gesetzt ist, wird ein neuer vorgeschlagener Wert angezeigt.

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

boolean

Gibt an, ob eine Änderung an bold vorgeschlagen wurde.

italicSuggested

boolean

Gibt an, ob eine Änderung an italic vorgeschlagen wurde.

underlineSuggested

boolean

Gibt an, ob eine Änderung an underline vorgeschlagen wurde.

strikethroughSuggested

boolean

Gibt an, ob eine Änderung an strikethrough vorgeschlagen wurde.

smallCapsSuggested

boolean

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

backgroundColorSuggested

boolean

Gibt an, ob eine Änderung an backgroundColor vorgeschlagen wurde.

foregroundColorSuggested

boolean

Gibt an, ob eine Änderung an foregroundColor vorgeschlagen wurde.

fontSizeSuggested

boolean

Gibt an, ob eine Änderung an fontSize vorgeschlagen wurde.

weightedFontFamilySuggested

boolean

Gibt an, ob eine Änderung an weightedFontFamily vorgeschlagen wurde.

baselineOffsetSuggested

boolean

Gibt an, ob eine Änderung an baselineOffset vorgeschlagen wurde.

AutoText

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

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

enum (Type)

Die Art dieses automatischen Textes.

suggestedInsertionIds[]

string

Die vorgeschlagenen Anzeigenauftrags-IDs. Ein AutoText kann mehrere Anzeigen-IDs haben, wenn es sich um eine verschachtelte vorgeschlagene Änderung handelt. Wenn das Feld leer ist, handelt es sich nicht um einen vorgeschlagenen Eintrag.

suggestedDeletionIds[]

string

Die vorgeschlagenen IDs für das Löschen. Wenn das Feld leer ist, gibt es keine Vorschläge zum Löschen dieser Inhalte.

textStyle

object (TextStyle)

Der Textstil dieses AutoText-Elements.

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 angegebener automatischer Texttyp.
PAGE_NUMBER Geben Sie Text ein, der die aktuelle Seitenzahl darstellt.
PAGE_COUNT Geben Sie einen automatischen Text ein, 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 Anzeigenauftrags-IDs. Eine PageBreak kann mehrere Anzeigen-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 IDs für das Löschen. Wenn das Feld leer ist, werden keine Vorschläge zum Löschen dieses Inhalts vorgeschlagen.

textStyle

object (TextStyle)

Der Textstil dieses Seitenumbruchs.

Ähnlich wie Textinhalte wie Textabfolgen und Fußnoten kann sich der Textstil eines Seitenumbruchs auf das Inhaltslayout sowie auf den Stil des daneben eingefügten Texts auswirken.

suggestedTextStyleChanges

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

Der vorgeschlagene Textstil ändert sich in diesen Seitenumbruch, der anhand der Vorschlags-ID identifiziert wird.

ColumnBreak

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

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

string

Die vorgeschlagenen Anzeigenauftrags-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 IDs für das Löschen. Wenn das Feld leer ist, gibt es keine Vorschläge zum Löschen dieser Inhalte.

textStyle

object (TextStyle)

Der Textstil dieses Spaltenbruchs.

Ähnlich wie Textinhalte wie Textabfolgen und Fußnoten kann der Textstil eines Spaltenbruchs das Inhaltslayout sowie den Stil des daneben eingefügten Texts beeinflussen.

suggestedTextStyleChanges

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

Der vorgeschlagene Textstil ändert sich in diesen Spaltenumbruch, der anhand der Vorschlags-ID identifiziert wird.

FootnoteReference

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

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

string

Die ID des footnote, das den Inhalt dieser Fußnote enthält.

footnoteNumber

string

Die gerenderte Nummer dieser Fußnote.

suggestedInsertionIds[]

string

Die vorgeschlagenen Anzeigenauftrags-IDs. Ein FootnoteReference kann mehrere Anzeigen-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 IDs für das Löschen. Wenn das Feld leer ist, gibt es keine Vorschläge zum Löschen dieser Inhalte.

textStyle

object (TextStyle)

Der Textstil dieser Fußnote.

suggestedTextStyleChanges

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

Der vorgeschlagene Textstil ändert sich in diesen Fußnotenverweise, die anhand der Vorschlags-ID gekennzeichnet sind.

HorizontalRule

Ein ParagraphElement steht für eine horizontale Linie.

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 Anzeigen-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 IDs für das Löschen. Wenn das Feld leer ist, gibt es keine Vorschläge zum Löschen dieser Inhalte.

textStyle

object (TextStyle)

Der Textstil dieser HorizontalRule.

Ähnlich wie Textinhalte wie Textabfolgen und Fußnotenverweise kann sich der Textstil einer horizontalen Linie auf das Inhaltslayout sowie auf den Stil des daneben eingefügten Texts auswirken.

suggestedTextStyleChanges

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

Der vorgeschlagene Textstil ändert sich in diese HorizontalRule, die anhand der Vorschlags-ID identifiziert wird.

Gleichung

Eine ParagraphElement, die eine Gleichung darstellt.

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

string

Die vorgeschlagenen Anzeigenauftrags-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 IDs für das Löschen. Wenn das Feld leer ist, gibt es keine Vorschläge zum Löschen dieser Inhalte.

InlineObjectElement

Ein ParagraphElement, das ein InlineObject enthält.

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

string

Die ID von InlineObject, die dieses Element enthält.

suggestedInsertionIds[]

string

Die vorgeschlagenen Anzeigenauftrags-IDs. Ein InlineObjectElement kann mehrere Anzeigen-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 IDs für das Löschen. Wenn das Feld leer ist, gibt es keine Vorschläge zum Löschen dieser Inhalte.

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 Person oder E-Mail-Adresse, die in einem Dokument erwähnt wird. Diese Erwähnungen verhalten sich wie ein einzelnes, unveränderliches Element, das den Namen oder die E-Mail-Adresse der Person enthält.

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

string

Nur Ausgabe. Die eindeutige ID dieses Links.

suggestedInsertionIds[]

string

IDs der Vorschläge zum Einfügen des Links zu dieser Person in das Dokument. Ein Person kann mehrere Einfüge-IDs haben, wenn es sich um eine verschachtelte vorgeschlagene Änderung handelt (z. B. ein Vorschlag in einem Vorschlag, der von einem anderen Nutzer gemacht wurde). Wenn das Feld leer ist, wird dieser Personenlink nicht als Platzhalter verwendet.

suggestedDeletionIds[]

string

IDs für Vorschläge, durch die der Link zu dieser Person aus dem Dokument entfernt wird. Ein Person kann mehrere Lösch-IDs haben, wenn beispielsweise mehrere Nutzer vorschlagen, es zu löschen. Ist das Feld leer, wird der Link zu dieser Person nicht zum Löschen vorgeschlagen.

textStyle

object (TextStyle)

Der Textstil von Person.

suggestedTextStyleChanges

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

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

personProperties

object (PersonProperties)

Nur Ausgabe. Die Eigenschaften 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 anstelle der E-Mail-Adresse der Person angezeigt wird.

email

string

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

RichLinkProperties

Für RichLink spezifische Properties

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

string

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

uri

string

Nur Ausgabe. URI zu RichLink. Dieser Wert ist immer vorhanden.

mimeType

string

Nur Ausgabe. Der MIME-Typ der RichLink, sofern vorhanden (z. B. wenn es sich um eine Datei in Drive handelt).

ParagraphStyle

Stile, die auf einen ganzen Absatz angewendet werden.

Übernommene Absatzstile werden in dieser Meldung als nicht festgelegte 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.
  • Der ParagraphStyle auf einem named style wird vom Stil normal text ü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 der Stil durch das Zurücksetzen der Felder auf einen Wert zurückgesetzt, der den Standardwerten im Google Docs-Editor entspricht.

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

string

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

Dieses Attribut 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 Linien als Prozentsatz des Normalwerts, wobei der Normalwert mit 100, 0 angegeben wird. Wenn der Wert nicht festgelegt ist, wird er vom übergeordneten Element übernommen.

direction

enum (ContentDirection)

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

spacingMode

enum (SpacingMode)

Der Abstandsmodus für den Absatz.

spaceAbove

object (Dimension)

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

spaceBelow

object (Dimension)

Der zusätzliche Abstand unter dem Absatz. Wenn der Wert nicht festgelegt ist, wird er 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 Zwischenraum wird gerendert, wenn der benachbarte Absatz dieselben Rahmen- und Einzugeigenschaften hat.

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

borderTop

object (ParagraphBorder)

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

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

Absätzeränder 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 der Wert nicht festgelegt ist, wird er vom übergeordneten Element übernommen.

Der untere Rahmen wird gerendert, wenn der nachfolgende Absatz andere Rahmen- und Einzug-Properties hat.

Absätzeränder 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 der Wert nicht festgelegt ist, wird er 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 der Wert nicht festgelegt ist, wird er vom übergeordneten Element übernommen.

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

indentFirstLine

object (Dimension)

Der Einzug der ersten Zeile des Absatzes. Wenn der Wert nicht festgelegt ist, wird er vom übergeordneten Element übernommen.

indentStart

object (Dimension)

Die Einzugtiefe des Absatzes auf der Seite, die dem Anfang des Texts 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 der Wert nicht festgelegt ist, wird er vom übergeordneten Element übernommen.

tabStops[]

object (TabStop)

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

Dieses Attribut ist schreibgeschützt.

keepLinesTogether

boolean

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

keepWithNext

boolean

Gibt an, ob mindestens ein Teil dieses Absatzes nach Möglichkeit auf derselben Seite oder in derselben Spalte wie der nächste Absatz dargestellt 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 der Wert nicht festgelegt ist, wird er vom übergeordneten Element übernommen.

shading

object (Shading)

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

pageBreakBefore

boolean

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

Wenn Sie versuchen, pageBreakBefore für Absätze in nicht unterstützten Regionen wie Table, Header, Footer und Footnote zu aktualisieren, kann das zu einem ungültigen Dokumentstatus führen, der den Fehler 400 „Ungültige Anfrage“ zurückgibt.

NamedStyleType

Die Arten von benannten Stilen.

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 Textausrichtungstypen 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 linksläufigen Text, rechtsbündig andernfalls.
CENTER Der Absatz ist zentriert.
END Der Absatz ist am Zeilenende ausgerichtet. Rechtsbündig für LTR-Text, ansonsten linksbündig.
JUSTIFIED Der Absatz ist linksbündig ausgerichtet.

ContentDirection

Die Wegbeschreibung kann einfließen.

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

SpacingMode

Die verschiedenen Modi für den Absatzabstand.

Enums
SPACING_MODE_UNSPECIFIED Der Abstandsmodus wird vom übergeordneten Element übernommen.
NEVER_COLLAPSE Absätze werden immer gerendert.
COLLAPSE_LISTS Zwischen den Listenelementen wird kein Absatzabstand verwendet.

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 Strichstil des Rahmens.

DashStyle

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

Enums
DASH_STYLE_UNSPECIFIED Nicht angegebener Bindestrichstil.
SOLID Durchgezogene Linie Entspricht dem ECMA-376 ST_PresetLineDashVal-Wert "solid". Dies ist der Standard-Strichstil.
DOT Gestrichelte Linie. Entspricht dem ECMA-376-Wert „ST_PresetLineDashVal“, „dot“.
DASH Gestrichelte Linie Entspricht dem ECMA-376-Wert „ST_PresetLineDashVal“, also „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 der Wert nicht festgelegt ist, wird standardmäßig START verwendet.

TabStopAlignment

Ausrichtung des Tabstopps.

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

Schattierung

Die Schattierung eines Absatzes.

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

object (OptionalColor)

Die Hintergrundfarbe der Absatzschattierung.

SuggestedParagraphStyle

Eine vorgeschlagene Änderung an einer ParagraphStyle.

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

object (ParagraphStyle)

Eine ParagraphStyle, die nur die in diesem Vorschlag vorgenommenen Änderungen enthält. Sie können diese Funktion zusammen mit paragraphStyleSuggestionState verwenden, um zu sehen, welche Felder sich geändert haben und welche neuen Werte sie haben.

paragraphStyleSuggestionState

object (ParagraphStyleSuggestionState)

Eine Maske, die angibt, welche der Felder in der BasisParagraphStyle 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 „wahr“ gesetzt ist, wird ein neuer vorgeschlagener Wert angezeigt.

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

boolean

Gibt an, ob eine Änderung an headingId vorgeschlagen wurde.

namedStyleTypeSuggested

boolean

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

alignmentSuggested

boolean

Gibt an, ob eine Änderung an alignment vorgeschlagen wurde.

lineSpacingSuggested

boolean

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

directionSuggested

boolean

Gibt an, ob eine Änderung an direction vorgeschlagen wurde.

spacingModeSuggested

boolean

Gibt an, ob eine Änderung an spacingMode vorgeschlagen wurde.

spaceAboveSuggested

boolean

Gibt an, ob eine Änderung an spaceAbove vorgeschlagen wurde.

spaceBelowSuggested

boolean

Gibt an, ob eine Änderung an spaceBelow vorgeschlagen wurde.

borderBetweenSuggested

boolean

Gibt an, ob eine Änderung an borderBetween vorgeschlagen wurde.

borderTopSuggested

boolean

Gibt an, ob eine Änderung an borderTop vorgeschlagen wurde.

borderBottomSuggested

boolean

Gibt an, ob eine Änderung an borderBottom vorgeschlagen wurde.

borderLeftSuggested

boolean

Gibt an, ob eine Änderung an borderLeft vorgeschlagen wurde.

borderRightSuggested

boolean

Gibt an, ob eine Änderung an borderRight vorgeschlagen wurde.

indentFirstLineSuggested

boolean

Gibt an, ob eine Änderung an indentFirstLine vorgeschlagen wurde.

indentStartSuggested

boolean

Gibt an, ob eine Änderung an indentStart vorgeschlagen wurde.

indentEndSuggested

boolean

Gibt an, ob eine Änderung an indentEnd vorgeschlagen wurde.

keepLinesTogetherSuggested

boolean

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

keepWithNextSuggested

boolean

Gibt an, ob eine Änderung an keepWithNext vorgeschlagen wurde.

avoidWidowAndOrphanSuggested

boolean

Gibt an, ob eine Änderung an avoidWidowAndOrphan vorgeschlagen wurde.

shadingSuggestionState

object (ShadingSuggestionState)

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

pageBreakBeforeSuggested

boolean

Gibt an, ob eine Änderung an pageBreakBefore vorgeschlagen wurde.

ShadingSuggestionState

Eine Maske, die angibt, welche der Felder in der BasisShading 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 eine Änderung an der Shading vorgeschlagen wurde.

Aufzählungszeichen

Beschreibt die Aufzählungspunkte eines Absatzes.

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

string

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

nestingLevel

integer

Die Verschachtelungsebene dieses Absatzes in der Liste.

textStyle

object (TextStyle)

Der paragrapfhspezifische Textstil, der auf diese Aufzählung angewendet wird.

SuggestedBullet

Eine vorgeschlagene Änderung an einer Bullet.

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

object (Bullet)

Eine Bullet, die nur die Änderungen enthält, die in diesem Vorschlag vorgenommen wurden. Sie können diese Funktion zusammen mit bulletSuggestionState verwenden, um zu sehen, welche Felder sich geändert haben und welche neuen Werte sie haben.

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 in der BasisBullet in diesem Vorschlag geändert wurden. Für jedes Feld, das auf „wahr“ gesetzt ist, wird ein neuer vorgeschlagener Wert angezeigt.

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

boolean

Gibt an, ob eine Änderung an der listId vorgeschlagen wurde.

nestingLevelSuggested

boolean

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

textStyleSuggestionState

object (TextStyleSuggestionState)

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

ObjectReferences

Eine Sammlung von Objekt-IDs.

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

string

Die Objekt-IDs.

SectionBreak

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

Der Textkörper beginnt immer mit einem Abschnittswechsel.

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

string

Die vorgeschlagenen Anzeigenauftrags-IDs. Eine SectionBreak kann mehrere Anzeigen-IDs haben, wenn es sich um eine verschachtelte vorgeschlagene Änderung handelt. Wenn das Feld leer ist, handelt es sich nicht um einen vorgeschlagenen Eintrag.

suggestedDeletionIds[]

string

Die vorgeschlagenen Lösch-IDs. Wenn das Feld leer ist, gibt es keine Vorschläge zum Löschen dieser Inhalte.

sectionStyle

object (SectionStyle)

Der Stil des Abschnitts nach dieser Abschnittsübergabe.

SectionStyle

Das Design, das auf einen Abschnitt angewendet wird.

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

object (SectionColumnProperties)

Die Spalteneigenschaften des Abschnitts.

Wenn er leer ist, enthält der Abschnitt 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 diese Property nicht festlegen, wird der Fehler 400 (Bad Request) ausgegeben.

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 Property muss ein konkreter Wert festgelegt werden. Wenn Sie diese Property nicht festlegen, wird der Fehler 400 (Bad Request) ausgegeben.

contentDirection

enum (ContentDirection)

Die Inhaltsrichtung dieses Abschnitts. 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 der Wert nicht festgelegt ist, wird standardmäßig marginTop aus „DocumentStyle“ verwendet.

Beim Aktualisieren dieser Property muss ein konkreter Wert festgelegt werden. Wenn Sie diese Property nicht festlegen, wird der Fehler 400 (Bad Request) ausgegeben.

marginBottom

object (Dimension)

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

Beim Aktualisieren dieser Property muss ein konkreter Wert festgelegt werden. 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, ändert sich die Größe der Spalten in diesem Abschnitt. Da sich der Rand auf die Spaltenbreite auswirkt, wird er vor den Spalteneigenschaften angewendet.

Beim Aktualisieren dieser Property muss ein konkreter Wert festgelegt werden. Wenn Sie dieses Attribut zurücksetzen, wird ein Fehler vom Typ „400 Bad Request“ angezeigt.

marginLeft

object (Dimension)

Der linke Seitenrand des Abschnitts. Wenn der Wert nicht 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 Property muss ein konkreter Wert festgelegt werden. Wenn Sie diese Property nicht festlegen, wird der Fehler 400 (Bad Request) ausgegeben.

marginHeader

object (Dimension)

Der Kopfzeilenrand des Abschnitts. Wenn der Wert nicht festgelegt ist, wird standardmäßig marginHeader aus „DocumentStyle“ verwendet. Wenn aktualisiert, 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 Property muss ein konkreter Wert festgelegt werden. Wenn Sie dieses Attribut zurücksetzen, wird ein Fehler vom Typ „400 Bad Request“ angezeigt.

sectionType

enum (SectionType)

Nur Ausgabe. Der Abschnittstyp.

defaultHeaderId

string

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

Dieses Attribut ist schreibgeschützt.

firstPageHeaderId

string

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

Dieses Attribut ist schreibgeschützt.

evenPageHeaderId

string

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

Dieses Attribut ist schreibgeschützt.

pageNumberStart

integer

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

Beim Aktualisieren dieser Property muss ein konkreter Wert festgelegt werden. Wenn Sie diese Property nicht festlegen, wird der Fehler 400 (Bad Request) ausgegeben.

flipPageOrientation

boolean

Optional. Gibt an, ob die Abmessungen von pageSize des Dokumentstils für diesen Abschnitt gespiegelt werden sollen. Dadurch kann die Seitenausrichtung zwischen Hoch- und Querformat geändert werden. Wenn der Wert nicht festgelegt ist, wird er von flipPageOrientation des Dokumentstils ü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 angegebener Stil für Spaltentrennzeichen.
NONE Keine Spaltentrennzeichen zwischen den Spalten.
BETWEEN_EACH_COLUMN Zwischen den einzelnen Spalten wird eine Spaltenabstandslinie gerendert.

SectionType

Gibt an, wie der Anfang des aktuellen Abschnitts relativ zum vorherigen Abschnitt positioniert ist.

Enums
SECTION_TYPE_UNSPECIFIED Der Abschnittstyp 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.

Eine Tabelle kann nicht rechteckig sein. Daher haben einige Zeilen möglicherweise eine andere Anzahl von Zellen.

tableRows[]

object (TableRow)

Inhalt und Stil jeder Zeile.

suggestedInsertionIds[]

string

Die vorgeschlagenen Anzeigenauftrags-IDs. Ein Table kann mehrere Anzeigen-IDs haben, wenn es sich um eine verschachtelte vorgeschlagene Änderung handelt. Wenn das Feld leer ist, handelt es sich nicht um einen vorgeschlagenen Eintrag.

suggestedDeletionIds[]

string

Die vorgeschlagenen Lösch-IDs. Wenn das Feld leer ist, gibt es keine Vorschläge zum Löschen dieser Inhalte.

tableStyle

object (TableStyle)

Der Stil der Tabelle.

TableRow

Inhalt und Stil einer Zeile in einer Table.

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

integer

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

endIndex

integer

Der Endindex dieser Zeile (ab Null gezählt) in UTF-16-Codeeinheiten.

tableCells[]

object (TableCell)

Inhalt und Stil jeder Zelle in dieser Zeile.

Eine Tabelle kann nicht rechteckig sein. Daher haben einige Zeilen möglicherweise eine andere Anzahl von Zellen als andere Zeilen in derselben Tabelle.

suggestedInsertionIds[]

string

Die vorgeschlagenen Anzeigenauftrags-IDs. Ein TableRow kann mehrere Anzeigen-IDs haben, wenn es sich um eine verschachtelte vorgeschlagene Änderung handelt. Wenn das Feld leer ist, handelt es sich nicht um einen vorgeschlagenen Eintrag.

suggestedDeletionIds[]

string

Die vorgeschlagenen IDs für das Löschen. Wenn das Feld leer ist, gibt es keine Vorschläge zum Löschen dieser Inhalte.

tableRowStyle

object (TableRowStyle)

Der Stil der Tabellenzeile.

suggestedTableRowStyleChanges

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

Der vorgeschlagene Stil wird in dieser Zeile geändert, wobei die Vorschlags-ID als Schlüssel verwendet wird.

TableCell

Der Inhalt und Stil einer Zelle in einer 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 Endindex dieser Zelle (ab Null gezählt) in UTF-16-Codeeinheiten.

content[]

object (StructuralElement)

Der Inhalt der Zelle.

tableCellStyle

object (TableCellStyle)

Der Stil der Zelle.

suggestedInsertionIds[]

string

Die vorgeschlagenen Anzeigenauftrags-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 IDs für das Löschen. Wenn das Feld leer ist, gibt es keine Vorschläge zum Löschen dieser Inhalte.

suggestedTableCellStyleChanges

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

Die vorgeschlagenen Änderungen am Tabellenzellenstil, sortiert nach Vorschlags-ID.

TableCellStyle

Der Stil eines TableCell.

Übernommene Tabellenzellstile werden in dieser Meldung 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

Die Zeilenspanne der Zelle.

Diese Eigenschaft ist schreibgeschützt.

columnSpan

integer

Die Spaltenspanne der Zelle.

Dieses Attribut ist schreibgeschützt.

backgroundColor

object (OptionalColor)

Die Hintergrundfarbe der Zelle.

borderLeft

object (TableCellBorder)

Der linke Rahmen der Zelle.

borderRight

object (TableCellBorder)

Der rechte Rahmen der Zelle.

borderTop

object (TableCellBorder)

Oberer Rahmen der Zelle.

borderBottom

object (TableCellBorder)

Unterer Rahmen der Zelle.

paddingLeft

object (Dimension)

Der linke Abstand der Zelle.

paddingRight

object (Dimension)

Der rechte Textabstand der Zelle.

paddingTop

object (Dimension)

Der obere Abstand der Zelle.

paddingBottom

object (Dimension)

Der Abstand unten in der Zelle.

contentAlignment

enum (ContentAlignment)

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

TableCellBorder

Ein Rahmen um eine Tabellenzelle.

Tabellenzellrahmen dürfen nicht transparent sein. Wenn Sie den Rahmen einer Tabellenzelle ausblenden möchten, geben Sie als Breite „0“ an.

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 Strichstil des Rahmens.

ContentAlignment

Die Arten der Textausrichtung.

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

Enums
CONTENT_ALIGNMENT_UNSPECIFIED Eine nicht angegebene Inhaltsausrichtung. Die Textausrichtung wird vom übergeordneten Element übernommen, sofern vorhanden.
CONTENT_ALIGNMENT_UNSUPPORTED Eine nicht unterstützte Inhaltsausrichtung.
TOP Eine Ausrichtung, bei der die Inhalte oben im Inhaltshalter ausgerichtet sind. Entspricht dem ECMA-376-ST_TextAnchoringType „t“.
MIDDLE Eine Ausrichtung, bei der die Inhalte mittig im Inhaltshalter ausgerichtet werden. Entspricht ECMA-376 ST_TextAnchoringType "ctr".
BOTTOM Eine Ausrichtung, durch die der Inhalt am unteren Rand des Inhaltshalters ausgerichtet wird. Entspricht dem ECMA-376-ST_TextAnchoringType „b“.

SuggestedTableCellStyle

Eine vorgeschlagene Änderung an einer TableCellStyle.

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

object (TableCellStyle)

Eine TableCellStyle, die 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 in der BasisTableCellStyle 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 „wahr“ gesetzt ist, wird ein neuer vorgeschlagener Wert angezeigt.

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 eine Änderung an columnSpan vorgeschlagen wurde.

backgroundColorSuggested

boolean

Gibt an, ob eine Änderung an backgroundColor vorgeschlagen wurde.

borderLeftSuggested

boolean

Gibt an, ob eine Änderung an borderLeft vorgeschlagen wurde.

borderRightSuggested

boolean

Gibt an, ob eine Änderung an borderRight vorgeschlagen wurde.

borderTopSuggested

boolean

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

borderBottomSuggested

boolean

Gibt an, ob eine Änderung an borderBottom vorgeschlagen wurde.

paddingLeftSuggested

boolean

Gibt an, ob eine Änderung an paddingLeft vorgeschlagen wurde.

paddingRightSuggested

boolean

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

paddingTopSuggested

boolean

Gibt an, ob eine Änderung an paddingTop vorgeschlagen wurde.

paddingBottomSuggested

boolean

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

contentAlignmentSuggested

boolean

Gibt an, ob eine Änderung an contentAlignment vorgeschlagen wurde.

TableRowStyle

Stile, die auf eine Tabellenzeile angewendet werden.

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

object (Dimension)

Die minimale Höhe der Zeile. Die Zeile wird im Docs-Editor mit einer Höhe gerendert, die diesem Wert entspricht oder größer ist, damit der gesamte Inhalt in den Zellen der Zeile angezeigt wird.

tableHeader

boolean

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

preventOverflow

boolean

Gibt an, ob die Zeile nicht über Seiten- oder Spaltengrenzen hinweg überlaufen darf.

SuggestedTableRowStyle

Eine vorgeschlagene Änderung an einer 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. Sie können diese Funktion zusammen mit tableRowStyleSuggestionState verwenden, um zu sehen, welche Felder sich geändert haben und welche neuen Werte sie haben.

tableRowStyleSuggestionState

object (TableRowStyleSuggestionState)

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

TableRowStyleSuggestionState

Eine Maske, die angibt, welche der Felder in der BasisTableRowStyle in diesem Vorschlag geändert wurden. Für jedes Feld, das auf „wahr“ gesetzt ist, wird ein neuer vorgeschlagener Wert angezeigt.

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

boolean

Gibt an, ob eine Änderung an minRowHeight vorgeschlagen wurde.

TableStyle

Stile, die auf eine Tabelle angewendet werden.

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

object (TableColumnProperties)

Die Eigenschaften der einzelnen Spalten.

Ähnlich wie in HTML enthalten Tabellen in Google Docs Zeilen und Zeilen enthalten Zellen. Die Eigenschaften einer Zeile finden Sie also im tableRowStyle der Zeile.

TableColumnProperties

Die Eigenschaften einer Spalte in einer Tabelle.

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

enum (WidthType)

Der Breitetyp der Spalte.

width

object (Dimension)

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

WidthType

Der Typ der Spaltenbreite.

Enums
WIDTH_TYPE_UNSPECIFIED Der Spaltenbreitentyp ist nicht angegeben.
EVENLY_DISTRIBUTED

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

Die Breite der Spalte wird automatisch bestimmt und entspricht 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

Eine StructuralElement, die ein Inhaltsverzeichnis darstellt.

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

object (StructuralElement)

Der Inhalt des Inhaltsverzeichnisses.

suggestedInsertionIds[]

string

Die vorgeschlagenen Anzeigenauftrags-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 IDs für das Löschen. Wenn das Feld leer ist, gibt es keine Vorschläge zum Löschen dieser Inhalte.

Fußnote

Eine Fußnote in einem Dokument.

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

string

Die 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 keinen transparenten Hintergrund haben.

defaultHeaderId

string

Die ID des Standardheaders. Wenn dieser Wert nicht festgelegt 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.

Dieses Attribut ist schreibgeschützt.

firstPageHeaderId

string

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

Dieses Attribut ist schreibgeschützt.

pageNumberStart

integer

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

marginTop

object (Dimension)

Der obere Seitenrand.

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

marginBottom

object (Dimension)

Der untere Seitenrand.

Wenn Sie den unteren Seitenrand im Dokumentstil aktualisieren, wird der untere Seitenrand in 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. Außerdem kann es dazu führen, dass sich die Spaltengröße in allen Abschnitten ändert.

marginLeft

object (Dimension)

Der linke Seitenrand.

Wenn Sie den linken Seitenrand im Dokumentstil aktualisieren, wird der linke Seitenrand in 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 der Kopfzeile und dem Inhalt der Seite.

flipPageOrientation

boolean

Optional. Gibt an, ob die Abmessungen der pageSize gespiegelt 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)

Eine DocumentStyle, die nur die in diesem Vorschlag vorgenommenen Änderungen enthält. Sie können diese Funktion zusammen mit documentStyleSuggestionState verwenden, um zu sehen, welche Felder sich geändert haben und welche neuen Werte sie haben.

documentStyleSuggestionState

object (DocumentStyleSuggestionState)

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

DocumentStyleSuggestionState

Eine Maske, die angibt, welche der Felder in der BasisDocumentStyle in diesem Vorschlag geändert wurden. Für jedes Feld, das auf „wahr“ gesetzt ist, wird ein neuer vorgeschlagener Wert angezeigt.

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 eine Änderung an defaultHeaderId vorgeschlagen wurde.

evenPageHeaderIdSuggested

boolean

Gibt an, ob eine Änderung an evenPageHeaderId vorgeschlagen wurde.

firstPageHeaderIdSuggested

boolean

Gibt an, ob eine Änderung an firstPageHeaderId vorgeschlagen wurde.

pageNumberStartSuggested

boolean

Gibt an, ob eine Änderung an pageNumberStart vorgeschlagen wurde.

marginTopSuggested

boolean

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

marginBottomSuggested

boolean

Gibt an, ob eine Änderung an marginBottom vorgeschlagen wurde.

marginRightSuggested

boolean

Gibt an, ob eine Änderung an marginRight vorgeschlagen wurde.

marginLeftSuggested

boolean

Gibt an, ob eine Änderung an marginLeft vorgeschlagen wurde.

pageSizeSuggestionState

object (SizeSuggestionState)

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

marginHeaderSuggested

boolean

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

flipPageOrientationSuggested

boolean

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

BackgroundSuggestionState

Eine Maske, die angibt, welche der Felder in der BasisBackground 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 eine Änderung an height vorgeschlagen wurde.

widthSuggested

boolean

Gibt an, ob eine Änderung an width vorgeschlagen wurde.

NamedStyles

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

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

object (NamedStyle)

Die benannten Stile.

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

NamedStyle

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

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

enum (NamedStyleType)

Der Typ dieses benannten Stils.

textStyle

object (TextStyle)

Der Textstil des benannten Stils.

paragraphStyle

object (ParagraphStyle)

Der Absatzstil dieses benannten Stils.

SuggestedNamedStyles

Eine vorgeschlagene Änderung am 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. Sie können diese Funktion zusammen mit namedStylesSuggestionState verwenden, um zu sehen, welche Felder sich geändert haben und welche neuen Werte sie haben.

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 Zustände für Vorschläge für benannte Stile entspricht der Reihenfolge des entsprechenden benannten Stils im named styles-Vorschlag.

NamedStyleSuggestionState

Der Vorschlagsstatus einer NamedStyle-Nachricht.

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

enum (NamedStyleType)

Der benannte Stiltyp, dem dieser Vorschlagsstatus entspricht.

Dieses Feld 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 in diesem Vorschlag geändert wurden.

paragraphStyleSuggestionState

object (ParagraphStyleSuggestionState)

Eine Maske, die angibt, welche der Felder in paragraph style in 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, enthält in seinem bullet einen Verweis auf die ID der Liste.

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

object (ListProperties)

Die Eigenschaften der Liste.

suggestedListPropertiesChanges

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

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

suggestedInsertionId

string

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

suggestedDeletionIds[]

string

Die vorgeschlagenen Lösch-IDs. Wenn die Liste leer ist, gibt es keine vorgeschlagenen Löschungen.

ListProperties

Die Eigenschaften eines list, die das Aussehen von Aufzählungszeichen in Absätzen beschreiben, die mit einer Liste verknüpft sind.

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

object (NestingLevel)

Hier werden die Eigenschaften der Aufzählungspunkte auf der entsprechenden Ebene beschrieben.

Eine Liste kann maximal 9 Verschachtelungsebenen haben. Ebene 0 entspricht der obersten Ebene und Ebene 8 der am weitesten verschachtelten Ebene. 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ählungspunktes innerhalb des Bereichs, der für das Rendern des Aufzählungspunktes vorgesehen ist.

glyphFormat

string

Der Formatstring, der für Aufzählungspunkte auf dieser Verschachtelungsebene verwendet wird.

Das Glyphformat 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 Glyphformat folgt also dem Muster <prefix>%[nestingLevel]<suffix>. Präfix und Suffix sind optional und können beliebige Strings sein.

Das Glyphformat %0. gibt beispielsweise an, dass der Platzhalter durch das gerenderte Glyph für die Verschachtelungsebene 0 ersetzt wird, 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 Glyphformat kann Platzhalter für die aktuelle Verschachtelungsebene sowie Platzhalter für übergeordnete Verschachtelungsebenen enthalten. Eine Liste kann beispielsweise das Schriftbildformat %0. auf Verschachtelungsebene 0 und das Schriftbildformat %0.%1. auf Verschachtelungsebene 1 haben. Angenommen, beide Verschachtelungsebenen haben DECIMAL Glyph-Typen, 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)

Die Einrückung von Absätzen 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 in Listen mit Buchstaben und römischen Ziffern als Wert von 1 behandelt. Bei den Werten 0 und 1 beginnen die Listen mit Buchstaben und römischen Ziffern jeweils bei a und i.

Dieser Wert wird für Verschachtelungsebenen mit ungeordneten Schriftzeichen ignoriert.

Union-Feld glyph_kind. Die Art des Glyphens, das für Aufzählungspunkte verwendet wird. Damit wird das 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, glyphFormat %0. und der Glyphentyp DECIMAL ist, ersetzt das gerenderte Glyph das Platzhaltersymbol %0 im Glyphenformat durch eine Zahl, die der Reihenfolge des Listenelements in der Liste entspricht.

glyphSymbol

string

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

Das Schriftzeichensymbol ersetzt Platzhalter innerhalb von glyphFormat. Wenn das Glyphsymbol beispielsweise der Vollkreis ist, der dem Unicode-Codepunkt U+25cf entspricht, und glyphFormat = %0 ist, wird der Vollkreis gerendert.

BulletAlignment

Die Ausrichtungstypen für Aufzählungspunkte.

Enums
BULLET_ALIGNMENT_UNSPECIFIED Die Ausrichtung der Aufzählungspunkte ist nicht angegeben.
START Der Aufzählungspunkt ist am Anfang des Bereichs ausgerichtet, der für das Rendern des Aufzählungspunkts vorgesehen ist. Linksbündig für LTR-Text, ansonsten rechtsbündig.
CENTER Der Aufzählungspunkt wird in der Mitte des Bereichs ausgerichtet, der für das Rendern des Aufzählungspunkts vorgesehen ist.
END Der Aufzählungspunkt ist am Ende des Bereichs ausgerichtet, der für das Rendern des Aufzählungspunkts vorgesehen ist. Bei linksläufigem Text rechtsbündig, andernfalls linksbündig.

GlyphType

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

Enums
GLYPH_TYPE_UNSPECIFIED Der Schriftzeichentyp 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 vorangestellt sind, 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 Ein Großbuchstaben-römisches Ziffer, z. B. I, II oder III.
ROMAN Eine kleine römische Ziffer wie i, ii oder iii.

SuggestedListProperties

Eine vorgeschlagene Änderung an ListProperties.

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

object (ListProperties)

Eine ListProperties, die nur die Änderungen enthält, die in diesem Vorschlag vorgenommen wurden. Sie können diese Funktion zusammen mit listPropertiesSuggestionState verwenden, um zu sehen, welche Felder sich geändert haben und welche neuen Werte sie haben.

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 in der entsprechenden NestingLevel in nestingLevels in diesem Vorschlag geändert wurden.

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

NestingLevelSuggestionState

Eine Maske, die angibt, welche der Felder auf der Basis NestingLevel in diesem Vorschlag geändert wurden. Für jedes Feld, das auf „wahr“ gesetzt ist, wird ein neuer vorgeschlagener Wert angezeigt.

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

boolean

Gibt an, ob eine Änderung an bulletAlignment vorgeschlagen wurde.

glyphTypeSuggested

boolean

Gibt an, ob eine Änderung an glyphType vorgeschlagen wurde.

glyphFormatSuggested

boolean

Gibt an, ob eine Änderung an glyphFormat vorgeschlagen wurde.

glyphSymbolSuggested

boolean

Gibt an, ob eine Änderung an glyphSymbol vorgeschlagen wurde.

indentFirstLineSuggested

boolean

Gibt an, ob eine Änderung an indentFirstLine vorgeschlagen wurde.

indentStartSuggested

boolean

Gibt an, ob eine Änderung an indentStart vorgeschlagen wurde.

textStyleSuggestionState

object (TextStyleSuggestionState)

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

startNumberSuggested

boolean

Gibt an, ob eine Änderung an startNumber vorgeschlagen wurde.

NamedRanges

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

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

string

Der Name, den alle named ranges gemeinsam haben.

namedRanges[]

object (NamedRange)

Die NamedRange mit demselben Namen.

NamedRange

Eine Sammlung von Ranges mit derselben benannten Bereichs-ID.

Mit benannten Bereichen können Entwickler Teile eines Dokuments einem beliebigen benutzerdefinierten Label zuordnen, damit deren Inhalt später programmatisch gelesen oder bearbeitet werden kann. Ein Dokument kann mehrere benannte Bereiche mit demselben Namen enthalten. Jeder benannte Bereich hat jedoch eine eindeutige ID.

Ein benannter Bereich wird mit einem einzelnen Range erstellt. Wenn Sie Inhalte in einen benannten Bereich einfügen, wird dieser Bereich in der Regel erweitert. 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ß- oder Fußnote, in der sich dieser Bereich befindet. Eine leere Segment-ID steht für 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 Endindex dieses Bereichs (ab Null gezählt), exklusiv, in UTF-16-Codeeinheiten.

Bei allen aktuellen Verwendungen muss ein Endindex angegeben werden. Dieses Feld ist ein Int32Value, um zukünftigen Anwendungsfällen mit offenen Bereichen gerecht zu werden.

tabId

string

Der Tab, der diesen Bereich enthält Wird der Parameter weggelassen, gilt die Anfrage für den ersten Tab.

In einem Dokument mit einem einzelnen Tab:

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

  • Wird diese Option nicht angegeben, bezieht sich die Anfrage auf den einzelnen Tab.

In einem Dokument mit mehreren Tabs:

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

  • Wird dieser Parameter weggelassen, bezieht sich die Anfrage auf den ersten Tab im Dokument.

InlineObject

Ein Objekt, das inline mit Text erscheint. Ein InlineObject enthält ein EmbeddedObject, z. B. ein Bild.

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

string

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

inlineObjectProperties

object (InlineObjectProperties)

Die Eigenschaften dieses Inline-Objekts.

suggestedInlineObjectPropertiesChanges

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

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

suggestedInsertionId

string

Die vorgeschlagene Anzeigenauftrags-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

Eigenschaften eines InlineObject

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

object (EmbeddedObject)

Das eingebettete Objekt dieses Inline-Objekts.

EmbeddedObject

Ein eingebettetes Objekt im Dokument.

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

  // 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 die externen verknüpften Quellinhalte. Wenn das eingebettete Objekt beispielsweise ein verknüpftes Diagramm ist, enthält es einen Verweis auf das Quelldiagramm in Google Tabellen.

Wenn das Attribut nicht festgelegt ist, ist das eingebettete Objekt nicht verknüpft.

Union-Feld properties. Die Eigenschaften, die für jeden eingebetteten Objekttyp spezifisch sind. 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, mit denen der Objekttyp unterschieden wird. 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 zum Bild mit einer Standardlebensdauer von 30 Minuten. Dieser URI ist mit dem Konto des Antragstellers getaggt. Jeder, der den URI hat, kann auf das Bild zugreifen, als wäre er der ursprüngliche Anfragende. Wenn sich die Freigabeeinstellungen des Dokuments ändern, verlieren Sie möglicherweise den Zugriff auf das Bild.

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 Bilds. Der Wert sollte im Intervall [-1,0; 1,0] liegen. 0 bedeutet, dass keine Wirkung erzielt wird.

contrast

number

Der Kontrasteffekt des Bildes. Der Wert sollte im Intervall [-1,0; 1,0] liegen. 0 bedeutet, dass keine Wirkung erzielt wird.

transparency

number

Der Transparenzeffekt des Bilds. Der Wert muss im Intervall [0,0; 1,0] liegen, wobei 0 für keinen Effekt und 1 für transparent steht.

cropProperties

object (CropProperties)

Die Zuschneideeigenschaften des Bilds.

angle

number

Der Drehwinkel des Bildes im Uhrzeigersinn in Radian.

CropProperties

Die Zuschneideeigenschaften eines Bilds.

Das Zuschneide-Rechteck wird durch Bruchteilabstände von den vier Rändern des Originalinhalts dargestellt.

  • Wenn der Offset im Intervall (0, 1) liegt, befindet sich die entsprechende Kante des Zuschneide-Rechtecks innerhalb des ursprünglichen Begrenzungs-Rechtecks des Bilds.
  • Wenn der Offset negativ oder größer als 1 ist, befindet sich der entsprechende Rand des Zuschneiderects außerhalb des ursprünglichen Begrenzungsrects des Bilds.
  • Wenn alle Abweichungen und der Drehwinkel 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 der linke Rand des Zuschneide-Rechtecks vom linken Rand des ursprünglichen Inhalts entfernt ist, als Bruchteil der Breite des ursprünglichen Inhalts.

offsetRight

number

Der Versatz gibt an, wie weit der rechte Rand des Zuschneiderects vom rechten Rand des ursprünglichen Inhalts entfernt ist, als Bruchteil der Breite des ursprünglichen Inhalts.

offsetTop

number

Der Versatz gibt an, wie weit der obere Rand des Zuschneide-Rechtecks vom oberen Rand des ursprünglichen Inhalts entfernt ist, als Bruchteil der Höhe des ursprünglichen Inhalts.

offsetBottom

number

Mit dem Versatz wird angegeben, wie weit der untere Rand des Zuschneiderects vom unteren Rand des ursprünglichen Inhalts entfernt ist, als Bruchteil der Höhe des ursprünglichen Inhalts.

angle

number

Der Drehwinkel des Zuschneide-Rechtecks im Uhrzeigersinn um seine Mitte, in Bogenmaß. Die Drehung wird nach den Verschiebungen angewendet.

EmbeddedObjectBorder

Ein Rahmen um eine 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 Eigenschaft „Grenze“.

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 die externen verknüpften Quellinhalte.

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 sich auf die Art der verknüpften Inhalte bezieht. 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 wurde.

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 eingebetteten Google-Tabelle.

SuggestedInlineObjectProperties

Eine vorgeschlagene Änderung an InlineObjectProperties.

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

object (InlineObjectProperties)

Eine InlineObjectProperties, die nur die in diesem Vorschlag vorgenommenen Änderungen enthält. Sie können diese Funktion zusammen mit inlineObjectPropertiesSuggestionState verwenden, um zu sehen, welche Felder sich geändert haben und welche neuen Werte sie haben.

inlineObjectPropertiesSuggestionState

object (InlineObjectPropertiesSuggestionState)

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

InlineObjectPropertiesSuggestionState

Eine Maske, die angibt, welche der Felder in der BasisInlineObjectProperties in diesem Vorschlag geändert wurden. Für jedes Feld, das auf „wahr“ gesetzt ist, wird ein neuer vorgeschlagener Wert angezeigt.

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

object (EmbeddedObjectSuggestionState)

Eine Maske, die angibt, welche der Felder in embeddedObject in 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 in diesem Vorschlag geändert wurden.

titleSuggested

boolean

Gibt an, ob eine Änderung an title vorgeschlagen wurde.

descriptionSuggested

boolean

Gibt an, ob eine Änderung an description vorgeschlagen wurde.

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 in diesem Vorschlag geändert wurden.

marginLeftSuggested

boolean

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

marginRightSuggested

boolean

Gibt an, ob eine Änderung an marginRight vorgeschlagen wurde.

marginTopSuggested

boolean

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

marginBottomSuggested

boolean

Gibt an, ob eine Änderung an marginBottom vorgeschlagen wurde.

linkedContentReferenceSuggestionState

object (LinkedContentReferenceSuggestionState)

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

EmbeddedDrawingPropertiesSuggestionState

Dieser Typ hat keine Felder.

Eine Maske, die angibt, welche der Felder in der BasisEmbeddedDrawingProperties 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 in der BasisImageProperties 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 eine Änderung an [sourceUri] vorgeschlagen wurde [google.apps.docs.v1.EmbeddedObject.source_uri].

brightnessSuggested

boolean

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

contrastSuggested

boolean

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

transparencySuggested

boolean

Gibt an, ob eine Änderung an [transparency] vorgeschlagen wurde [google.apps.docs.v1.EmbeddedObject.transparency].

cropPropertiesSuggestionState

object (CropPropertiesSuggestionState)

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

angleSuggested

boolean

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

CropPropertiesSuggestionState

Eine Maske, die angibt, welche der Felder in der BasisCropProperties in diesem Vorschlag geändert wurden. Für jedes Feld, das auf „wahr“ gesetzt ist, wird ein neuer vorgeschlagener Wert angezeigt.

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

boolean

Gibt an, ob eine Änderung an offsetLeft vorgeschlagen wurde.

offsetRightSuggested

boolean

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

offsetTopSuggested

boolean

Gibt an, ob eine Änderung an offsetTop vorgeschlagen wurde.

offsetBottomSuggested

boolean

Gibt an, ob eine Änderung an offsetBottom vorgeschlagen wurde.

angleSuggested

boolean

Gibt an, ob eine Änderung an angle vorgeschlagen wurde.

EmbeddedObjectBorderSuggestionState

Eine Maske, die angibt, welche der Felder in der BasisEmbeddedObjectBorder 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 eine Änderung an [color] [google.apps.docs.v1.EmbeddedBorderObject.color] vorgeschlagen wurde.

widthSuggested

boolean

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

dashStyleSuggested

boolean

Gibt an, ob eine Änderung an [dashStyle] [google.apps.docs.v1.EmbeddedBorderObject.dash_style] vorgeschlagen wurde.

propertyStateSuggested

boolean

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

LinkedContentReferenceSuggestionState

Eine Maske, die angibt, welche 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 in der BasisSheetsChartReference 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 eine Änderung an spreadsheetId vorgeschlagen wurde.

chartIdSuggested

boolean

Gibt an, ob eine Änderung an chartId vorgeschlagen wurde.

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 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 Anzeigenauftrags-ID. Wenn das Feld leer ist, handelt es sich nicht um einen vorgeschlagenen Eintrag.

suggestedDeletionIds[]

string

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

PositionedObjectProperties

Eigenschaften eines PositionedObject

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

object (PositionedObjectPositioning)

Die Positionierung dieses positionierten Objekts relativ zum neuen Zeilenumbruch des Paragraph, der 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, mit dem es verbunden 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 vom Stil des Dokuments abhängen.

topOffset

object (Dimension)

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

PositionedObjectLayout

Die möglichen Layouts eines [PositionedObjects][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 Text wird so umgebrochen, dass das positionierte Objekt links und der Text rechts ist.
BREAK_RIGHT Text wird so umgebrochen, dass das positionierte Objekt rechts und der Text links ist.
BREAK_LEFT_RIGHT Text wird so umgebrochen, dass links oder rechts vom positionierten Objekt kein Text zu sehen ist.
IN_FRONT_OF_TEXT Das positionierte Objekt befindet sich vor dem Text.
BEHIND_TEXT Das positionierte Objekt befindet sich hinter dem Text.

SuggestedPositionedObjectProperties

Eine vorgeschlagene Änderung an PositionedObjectProperties.

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

object (PositionedObjectProperties)

Eine PositionedObjectProperties, die nur die in diesem Vorschlag vorgenommenen Änderungen enthält. Sie können diese Funktion zusammen mit positionedObjectPropertiesSuggestionState verwenden, um zu sehen, welche Felder sich geändert haben und welche neuen Werte sie haben.

positionedObjectPropertiesSuggestionState

object (PositionedObjectPropertiesSuggestionState)

Eine Maske, die angibt, welche der Felder in der BasisPositionedObjectProperties 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 in diesem Vorschlag geändert wurden.

embeddedObjectSuggestionState

object (EmbeddedObjectSuggestionState)

Eine Maske, die angibt, welche der Felder in embeddedObject in 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 eine Änderung an leftOffset vorgeschlagen wurde.

topOffsetSuggested

boolean

Gibt an, ob eine Änderung an topOffset vorgeschlagen wurde.

SuggestionsViewMode

Der Vorschlagsmodus, der auf das Dokument angewendet wird und angibt, wie vorgeschlagene Änderungen dargestellt werden. Sie bietet Optionen zum Lesen des Dokuments mit allen Vorschlägen, die inline, akzeptiert oder abgelehnt wurden.

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. Das ist der Standardmodus für die Ansicht von Vorschlägen.
SUGGESTIONS_INLINE

Das zurückgegebene Dokument enthält Vorschläge im Text. Vorgeschlagene Änderungen werden im Dokument von den ursprünglichen Inhalten unterschieden.

Anfragen zum Abrufen eines Dokuments mit diesem Modus schlagen mit dem Fehler 403 fehl, wenn der Nutzer keine Berechtigung zum Ansehen der vorgeschlagenen Änderungen hat.

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, in der alle vorgeschlagenen Änderungen abgelehnt werden, sofern solche vorhanden sind.

Methoden

batchUpdate

Wendet eine oder mehrere Aktualisierungen auf das Dokument an.

create

Es wird ein leeres Dokument mit dem in der Anfrage angegebenen Titel erstellt.

get

Ruft die neueste Version des angegebenen Dokuments ab.