REST Resource: documents

Ressource: Document

Ein Google Docs-Dokument.

JSON-Darstellung
{
  "documentId": string,
  "title": string,
  "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)
    },
    ...
  },
  "revisionId": string,
  "suggestionsViewMode": enum (SuggestionsViewMode),
  "inlineObjects": {
    string: {
      object (InlineObject)
    },
    ...
  },
  "positionedObjects": {
    string: {
      object (PositionedObject)
    },
    ...
  }
}
Felder
documentId

string

Nur Ausgabe. Die ID des Dokuments.

title

string

Der Titel des Dokuments.

body

object (Body)

Nur Ausgabe. Der Hauptteil des Dokuments.

headers

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

Nur Ausgabe. Die Überschriften im Dokument, aufgeschlüsselt nach Header-ID.

footers

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

Nur Ausgabe. Die Fußzeilen im Dokument, die mit der Fußzeilen-ID versehen sind.

footnotes

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

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

documentStyle

object (DocumentStyle)

Nur Ausgabe. Der Stil des Dokuments.

suggestedDocumentStyleChanges

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

Nur Ausgabe. Die vorgeschlagenen Änderungen am Stil des Dokuments, aufgeschlüsselt nach Vorschlags-ID.

namedStyles

object (NamedStyles)

Nur Ausgabe. Die benannten Stile des Dokuments.

suggestedNamedStylesChanges

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

Nur Ausgabe. Die vorgeschlagenen Änderungen an den benannten Stilen des Dokuments, aufgeschlüsselt nach Vorschlags-ID.

lists

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

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

namedRanges

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

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

revisionId

string

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

Die Überarbeitungs-ID ist keine fortlaufende Nummer, sondern ein intransparenter String. Das Format der Überarbeitungs-ID kann sich im Laufe der Zeit ändern. Eine zurückgegebene Überarbeitungs-ID ist garantiert nur 24 Stunden lang gültig und kann nicht mit anderen Nutzern geteilt werden. Wenn die Überarbeitungs-ID zwischen Aufrufen unverändert ist, 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 durch interne Faktoren wie Änderungen des ID-Formats verursacht werden.

suggestionsViewMode

enum (SuggestionsViewMode)

Nur Ausgabe. Der Ansichtsmodus für Vorschläge wurde auf das Dokument angewendet.

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

inlineObjects

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

Nur Ausgabe. Die Inline-Objekte im Dokument, aufgeschlüsselt nach Objekt-ID.

positionedObjects

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

Nur Ausgabe. Die positionierten Objekte im Dokument, aufgeschlüsselt nach Objekt-ID.

Körper

Der Textkörper des Dokuments.

Der Text enthält in der Regel den gesamten Dokumentinhalt mit Ausnahme von headers, footers und footnotes.

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

object (StructuralElement)

Der Inhalt des Texts.

Die Indizes für den Inhalt des Texts beginnen bei null.

Strukturelement

Ein „StructuralElement“ 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 strukturellen Elements, exklusiv, in UTF-16-Codeeinheiten.

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

object (Paragraph)

Ein Absatztyp des strukturellen Elements.

sectionBreak

object (SectionBreak)

Ein Abschnittsbruchtyp des Strukturelements.

table

object (Table)

Ein Tabellentyp des strukturellen Elements.

tableOfContents

object (TableOfContents)

Ein Inhaltsverzeichnistyp des strukturellen Elements.

Absatz

Ein StructuralElement, das einen Absatz darstellt. Ein Absatz ist ein Bereich mit Inhalten, die mit einem Zeilenumbruch abgeschlossen werden.

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

paragraphStyle

object (ParagraphStyle)

Der Stil dieses Absatzes.

suggestedParagraphStyleChanges

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

Der vorgeschlagene Absatzstil wird zu diesem Absatz geändert und durch die Vorschlags-ID ersetzt.

bullet

object (Bullet)

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

suggestedBulletChanges

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

Die vorgeschlagenen Änderungen an diesem Aufzählungspunkt.

positionedObjectIds[]

string

Die IDs der positionierten Objekte, die an diesen Absatz gebunden sind.

suggestedPositionedObjectIds

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

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

ParagraphElement

Ein ParagraphElement beschreibt Inhalte 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 Zero-Base-Endindex dieses Absatzelements in UTF-16-Codeeinheiten, exklusiv.

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

object (TextRun)

Ein Absatzelement zur Textausführung.

autoText

object (AutoText)

Ein Absatzelement für automatische Texte.

pageBreak

object (PageBreak)

Ein Absatzelement für einen Seitenumbruch.

columnBreak

object (ColumnBreak)

Ein Absatzelement mit Spaltenumbrüchen.

footnoteReference

object (FootnoteReference)

Ein Absatzelement mit Fußnoten.

horizontalRule

object (HorizontalRule)

Ein Absatzelement mit horizontaler Regel

equation

object (Equation)

Ein Absatzelement für Gleichungen.

inlineObjectElement

object (InlineObjectElement)

Ein Absatzelement für Inline-Objekte

person

object (Person)

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

Textlauf

Ein ParagraphElement, der eine Textausführung mit demselben Stil darstellt.

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

string

Der Text dieser Ausführung.

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

suggestedInsertionIds[]

string

Die vorgeschlagenen Einfügungs-IDs. Eine TextRun kann mehrere Einfügungs-IDs haben, wenn es sich um eine verschachtelte vorgeschlagene Änderung handelt. Wenn das Feld leer ist, wird kein neuer Anzeigenauftrag vorgeschlagen.

suggestedDeletionIds[]

string

Die vorgeschlagenen Lösch-IDs. Wenn das Feld leer ist, wird kein Inhalt zum Löschen vorgeschlagen.

textStyle

object (TextStyle)

Der Textstil dieser Ausführung.

suggestedTextStyleChanges

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

Der vorgeschlagene Textstil ändert sich zu dieser Ausführung, eingegeben anhand der Vorschlags-ID.

Textstil

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

Übernommene Textstile werden in dieser Nachricht als nicht festgelegte 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 eines named style-Elements wird vom benannten normal text-Element übernommen.
  • Der TextStyle des benannten Stils normal text übernimmt den Standardtextstil im Docs-Editor.
  • Für den TextStyle eines Paragraph-Elements, das in einer Tabelle enthalten ist, wird möglicherweise der Textstil des Tabellenstils übernommen.

Wenn der Textstil nicht von einem übergeordneten Element übernommen wird, wird durch das Aufheben der Festlegung der Felder der Stil auf einen Wert zurückgesetzt, der den Standardwerten im 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 formatiert ist.

italic

boolean

Gibt an, ob der Text kursiv dargestellt wird.

underline

boolean

Gibt an, ob der Text unterstrichen ist.

strikethrough

boolean

Gibt an, ob der Text durchgestrichen wurde.

smallCaps

boolean

Gibt an, ob der Text in Großbuchstaben geschrieben ist.

backgroundColor

object (OptionalColor)

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

foregroundColor

object (OptionalColor)

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

fontSize

object (Dimension)

Die Schriftgröße des Texts.

weightedFontFamily

object (WeightedFontFamily)

Die Schriftfamilie und die gerenderte Gewichtung 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 „Fehlerhafte Anfrage“ zurückgegeben.

baselineOffset

enum (BaselineOffset)

Der vertikale Abstand des Texts von seiner normalen Position aus.

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

Optionale Farbe

Eine Farbe, die entweder vollständig undurchsichtig oder vollständig transparent ist

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

object (Color)

Wenn dieser Wert festgelegt ist, wird er als deckende Farbe verwendet. Wenn die Richtlinie nicht konfiguriert ist, bedeutet dies eine transparente Farbe.

Farbe

Einfarbig.

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

object (RgbColor)

Der RGB-Farbwert.

RgbFarbe

Eine RGB-Farbe

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

number

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

green

number

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

blue

number

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

Dimension

Eine Stärke in einer Richtung in den angegebenen Einheiten.

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

number

Der Umfang.

unit

enum (Unit)

Die Größenordnungen.

Einheit

Maßeinheiten.

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

Gewichtete Schriftfamilie

Eine Schriftfamilie und Schriftstärke des Textes.

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

string

Die Schriftfamilie des Texts.

Die Schriftfamilie kann aus einer beliebigen Schriftart im Menü „Schriftart“ in Google Docs oder aus Google Fonts bestehen. Wenn der Schriftname nicht erkannt wird, wird der Text in Arial gerendert.

weight

integer

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

Der Standardwert ist 400 („normal“).

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

  • Wenn der Text fett ist und die Gewichtung kleiner als 400 ist, beträgt die gerenderte Gewichtung 400.
  • Wenn der Text in Fettschrift und größer als oder gleich 400, aber kleiner als 700 ist, beträgt die gerenderte Gewichtung 700.
  • Wenn die Gewichtung größer als oder gleich 700 ist, ist die gerenderte Gewichtung gleich der Gewichtung.
  • Wenn der Text nicht fett formatiert ist, entspricht die gerenderte Gewichtung der Gewichtung.

BaselineOffset

Die Möglichkeiten, wie Text vertikal von seiner normalen Position verschoben werden können

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

Vorgeschlagener Textstil

Vorgeschlagene Änderung an TextStyle.

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

object (TextStyle)

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

textStyleSuggestionState

object (TextStyleSuggestionState)

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

TextStyleSuggestionState (Textstilvorschlag)

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

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

boolean

Gibt an, ob 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 eine Änderung an smallCaps vorgeschlagen wurde.

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.

Automatischer Text

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

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

enum (Type)

Der Typ dieses automatischen Texts.

suggestedInsertionIds[]

string

Die vorgeschlagenen Einfügungs-IDs. Eine AutoText kann mehrere Einfügungs-IDs haben, wenn es sich um eine verschachtelte vorgeschlagene Änderung handelt. Wenn das Feld leer ist, wird kein neuer Anzeigenauftrag vorgeschlagen.

suggestedDeletionIds[]

string

Die vorgeschlagenen Lösch-IDs. Wenn das Feld leer ist, wird kein Inhalt zum Löschen vorgeschlagen.

textStyle

object (TextStyle)

Der Textstil dieses AutoTexts.

suggestedTextStyleChanges

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

Der vorgeschlagene Textstil wird anhand der Vorschlags-ID in diesen AutoText geändert.

Typ

Die Arten von automatischem Text.

Enums
TYPE_UNSPECIFIED Ein nicht spezifizierter automatischer Texttyp.
PAGE_NUMBER Typ für automatischen Text, der die aktuelle Seitennummer darstellt.
PAGE_COUNT Typ für automatischen Text, der die Gesamtzahl der Seiten im Dokument darstellt.

Seitenumbruch

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

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

string

Die vorgeschlagenen Einfügungs-IDs. Eine PageBreak kann mehrere Einfügungs-IDs haben, wenn es sich um eine verschachtelte vorgeschlagene Änderung handelt. Wenn das Feld leer ist, wird kein neuer Anzeigenauftrag vorgeschlagen.

suggestedDeletionIds[]

string

Die vorgeschlagenen Lösch-IDs. Wenn das Feld leer ist, wird kein Inhalt zum Löschen vorgeschlagen.

textStyle

object (TextStyle)

Der Textstil dieses PageBreak.

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

suggestedTextStyleChanges

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

Der vorgeschlagene Textstil wird zu diesem „Seitenumbruch“ geändert, angegeben nach der Vorschlags-ID.

Spaltenumbruch

Ein ParagraphElement, der einen Spaltenumbruch darstellt. Durch einen Spaltenumbruch wird der nachfolgende Text an den Anfang der nächsten Spalte gesetzt.

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

string

Die vorgeschlagenen Einfügungs-IDs. Eine ColumnBreak kann mehrere Einfügungs-IDs haben, wenn es sich um eine verschachtelte vorgeschlagene Änderung handelt. Wenn das Feld leer ist, wird kein neuer Anzeigenauftrag vorgeschlagen.

suggestedDeletionIds[]

string

Die vorgeschlagenen Lösch-IDs. Wenn das Feld leer ist, wird kein Inhalt zum Löschen vorgeschlagen.

textStyle

object (TextStyle)

Der Textstil dieses ColumnBreak.

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

suggestedTextStyleChanges

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

Der vorgeschlagene Textstil wird anhand der Vorschlags-ID zu „ColumnBreak“ geändert.

Referenz für Fußnote

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

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

string

Die ID von footnote, die den Inhalt dieser Fußnote-Referenz enthält.

footnoteNumber

string

Die gerenderte Zahl dieser Fußnote.

suggestedInsertionIds[]

string

Die vorgeschlagenen Einfügungs-IDs. Eine FootnoteReference kann mehrere Einfügungs-IDs haben, wenn es sich um eine verschachtelte vorgeschlagene Änderung handelt. Wenn das Feld leer ist, wird kein neuer Anzeigenauftrag vorgeschlagen.

suggestedDeletionIds[]

string

Die vorgeschlagenen Lösch-IDs. Wenn das Feld leer ist, wird kein Inhalt zum Löschen vorgeschlagen.

textStyle

object (TextStyle)

Der Textstil dieser Fußnotenreferenz.

suggestedTextStyleChanges

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

Der vorgeschlagene Textstil ändert sich in diese Fußnotenreferenz (auf Basis der Vorschlags-ID).

Horizontale Regel

Ein ParagraphElement-Objekt, das eine horizontale Linie repräsentiert.

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

string

Die vorgeschlagenen Einfügungs-IDs. Eine HorizontalRule kann mehrere Einfügungs-IDs haben, wenn es sich um eine verschachtelte vorgeschlagene Änderung handelt. Wenn das Feld leer ist, wird kein neuer Anzeigenauftrag vorgeschlagen.

suggestedDeletionIds[]

string

Die vorgeschlagenen Lösch-IDs. Wenn das Feld leer ist, wird kein Inhalt zum Löschen vorgeschlagen.

textStyle

object (TextStyle)

Der Textstil dieser HorizontalRule.

Ähnlich wie bei Textinhalten, z. B. Textausführungen oder Fußnotenreferenzen, kann sich der Textstil einer horizontalen Regel auf das Inhaltslayout und den Stil des Texts daneben auswirken.

suggestedTextStyleChanges

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

Der vorgeschlagene Textstil wird anhand der Vorschlags-ID in diese HorizontalRule geändert.

Gleichung

Ein ParagraphElement, der eine Gleichung darstellt.

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

string

Die vorgeschlagenen Einfügungs-IDs. Eine Equation kann mehrere Einfügungs-IDs haben, wenn es sich um eine verschachtelte vorgeschlagene Änderung handelt. Wenn das Feld leer ist, wird kein neuer Anzeigenauftrag vorgeschlagen.

suggestedDeletionIds[]

string

Die vorgeschlagenen Lösch-IDs. Wenn das Feld leer ist, wird kein Inhalt zum Löschen vorgeschlagen.

Inline-Objektelement

Ein ParagraphElement, das einen InlineObject enthält.

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

string

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

suggestedInsertionIds[]

string

Die vorgeschlagenen Einfügungs-IDs. Eine InlineObjectElement kann mehrere Einfügungs-IDs haben, wenn es sich um eine verschachtelte vorgeschlagene Änderung handelt. Wenn das Feld leer ist, wird kein neuer Anzeigenauftrag vorgeschlagen.

suggestedDeletionIds[]

string

Die vorgeschlagenen Lösch-IDs. Wenn das Feld leer ist, wird kein Inhalt zum Löschen vorgeschlagen.

textStyle

object (TextStyle)

Der Textstil dieses InlineObjectElements.

Ähnlich wie bei Textinhalten, z. B. Textausführungen oder Fußnotenreferenzen, kann sich der Textstil eines Inline-Objektelements auf das Inhaltslayout und den Stil des Texts daneben auswirken.

suggestedTextStyleChanges

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

Der vorgeschlagene Textstil ändert sich in dieses InlineObject mit der Vorschlags-ID.

Personen

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

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

string

Nur Ausgabe. Die eindeutige ID dieses Links.

suggestedInsertionIds[]

string

IDs für Vorschläge, mit denen dieser Personenlink in das Dokument eingefügt wird. Ein Person kann mehrere Einfügungs-IDs haben, wenn es sich um eine geschachtelte Änderung handelt (z. B. ein Vorschlag innerhalb eines Vorschlags von einem anderen Nutzer). Wenn dieses Feld leer ist, wird kein Link zu einer Person eingefügt.

suggestedDeletionIds[]

string

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

textStyle

object (TextStyle)

Der Textstil dieses Person.

suggestedTextStyleChanges

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

Der vorgeschlagene Textstil ändert sich zu diesem Person-Schlüssel mit der Vorschlags-ID.

personProperties

object (PersonProperties)

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

Personeneigenschaften

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

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

string

Nur Ausgabe. Der Name der Person, wenn er im Linktext und nicht in der E-Mail-Adresse der Person angezeigt wird

email

string

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

RichLink-Properties

Attribute für RichLink.

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

string

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

uri

string

Nur Ausgabe. Der URI zu RichLink. Das ist immer vorhanden.

mimeType

string

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

Absatzstil

Stile, die für einen ganzen Absatz gelten.

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

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

Wenn der Absatzstil nicht von einem übergeordneten Element übernommen wird, wird durch das Zurücksetzen der Felder der Stil auf einen Wert zurückgesetzt, der den Standardwerten im 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 Überschrifts-ID des Absatzes. Wenn das Feld leer ist, wird dieser Absatz nicht als Überschrift verwendet.

Diese Property ist schreibgeschützt.

namedStyleType

enum (NamedStyleType)

Der benannte Stiltyp des Absatzes.

Da sich der benannte Stiltyp auf andere Eigenschaften innerhalb von „ParadigStyle“ auswirkt, wird der benannte Stiltyp vor der Aktualisierung der anderen Eigenschaften angewendet.

alignment

enum (Alignment)

Die Textausrichtung für diesen Absatz.

lineSpacing

number

Der Abstand zwischen den Zeilen in Prozent als Normalzahl, wobei „Normal“ als 100, 0 dargestellt wird. Wenn die Richtlinie nicht konfiguriert ist, wird der Wert vom übergeordneten Element übernommen.

direction

enum (ContentDirection)

Die Textrichtung dieses Absatzes. Wenn die Richtlinie 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 die Richtlinie nicht konfiguriert ist, wird der Wert vom übergeordneten Element übernommen.

spaceBelow

object (Dimension)

Der zusätzliche Abstand unter dem Absatz. Wenn die Richtlinie nicht konfiguriert ist, wird der Wert vom übergeordneten Element übernommen.

borderBetween

object (ParagraphBorder)

Der Rand zwischen diesem Absatz und dem nächsten und vorherigen Absatz. Wenn die Richtlinie nicht konfiguriert ist, wird der Wert vom übergeordneten Element übernommen.

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

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

borderTop

object (ParagraphBorder)

Der Rahmen oben in diesem Absatz. Wenn die Richtlinie nicht konfiguriert ist, wird der Wert vom übergeordneten Element übernommen.

Der obere Rahmen wird gerendert, wenn der obige Absatz unterschiedliche Rahmen- und Einzugseigenschaften hat.

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

borderBottom

object (ParagraphBorder)

Der Rahmen unten in diesem Absatz. Wenn die Richtlinie nicht konfiguriert ist, wird der Wert vom übergeordneten Element übernommen.

Der untere Rahmen wird gerendert, wenn der Absatz unten unterschiedliche Rahmen- und Einzugseigenschaften hat.

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

borderLeft

object (ParagraphBorder)

Der Rand links neben diesem Absatz. Wenn die Richtlinie nicht konfiguriert ist, wird der Wert vom übergeordneten Element übernommen.

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

borderRight

object (ParagraphBorder)

Der Rahmen rechts neben diesem Absatz. Wenn die Richtlinie nicht konfiguriert ist, wird der Wert vom übergeordneten Element übernommen.

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

indentFirstLine

object (Dimension)

Der Einzug in der ersten Zeile des Absatzes. Wenn die Richtlinie nicht konfiguriert ist, wird der Wert vom übergeordneten Element übernommen.

indentStart

object (Dimension)

Der Einzug für den Absatz auf der Seite, der dem Textanfang entspricht, basierend auf der aktuellen Absatzrichtung. Wenn die Richtlinie nicht konfiguriert ist, wird der Wert vom übergeordneten Element übernommen.

indentEnd

object (Dimension)

Der Einzug für den Absatz auf der Seite, der dem Textende entspricht, bezogen auf die aktuelle Absatzrichtung. Wenn die Richtlinie nicht konfiguriert ist, wird der Wert vom übergeordneten Element übernommen.

tabStops[]

object (TabStop)

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

Diese Property ist schreibgeschützt.

keepLinesTogether

boolean

Gibt an, ob alle Zeilen des Absatzes nach Möglichkeit auf derselben Seite oder Spalte platziert werden sollen. Wenn die Richtlinie nicht konfiguriert ist, wird der Wert vom übergeordneten Element übernommen.

keepWithNext

boolean

Legt fest, ob zumindest ein Teil dieses Absatzes auf derselben Seite oder Spalte erscheinen soll wie der nächste Absatz. Wenn die Richtlinie nicht konfiguriert ist, wird der Wert vom übergeordneten Element übernommen.

avoidWidowAndOrphan

boolean

Gibt an, ob Witwen und Waisen sich im Absatz befinden sollen. Wenn die Richtlinie nicht konfiguriert ist, wird der Wert vom übergeordneten Element übernommen.

shading

object (Shading)

Die Schattierung des Absatzes. Wenn die Richtlinie nicht konfiguriert ist, wird der Wert vom übergeordneten Element übernommen.

pageBreakBefore

boolean

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

Der Versuch, pageBreakBefore für Absätze in nicht unterstützten Regionen zu aktualisieren, z. B. Table, Header, Footer und Footnote, kann zu einem ungültigen Dokumentstatus mit dem Fehler 400 „Fehlerhafte Anfrage“ führen.

NameStyleType

Die Typen der benannten Stile.

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

Ausrichtung

Die Arten der Textausrichtung für einen Absatz.

Enums
ALIGNMENT_UNSPECIFIED Die Absatzausrichtung wird vom übergeordneten Element übernommen.
START Der Absatz ist am Zeilenanfang ausgerichtet. Links ausgerichtet für LTR-Text, ansonsten rechtsbündig.
CENTER Der Absatz ist zentriert.
END Der Absatz ist am Ende der Zeile ausgerichtet. Rechts ausgerichtet für LTR-Text, ansonsten linksbündig.
JUSTIFIED Der Absatz ist gerechtfertigt.

Inhaltsrichtung

Wegbeschreibungen können eingefügt werden.

Enums
CONTENT_DIRECTION_UNSPECIFIED Die Inhaltsrichtung ist nicht angegeben.
LEFT_TO_RIGHT Der Inhalt wechselt von links nach rechts.
RIGHT_TO_LEFT Der Inhalt wird von rechts nach links eingeblendet.

Abstandsmodus

Die verschiedenen Modi für Absatzabstand.

Enums
SPACING_MODE_UNSPECIFIED Der Abstandsmodus wird vom übergeordneten Element übernommen.
NEVER_COLLAPSE Absatzabstand wird immer gerendert.
COLLAPSE_LISTS Der Abstand zwischen den Listenelementen wird übersprungen.

Absatzrahmen

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

DashStyle

Die Arten von Bindestrichen, mit denen die 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 ECMA-376 4. Edition beschrieben ist.

Enums
DASH_STYLE_UNSPECIFIED Nicht angegebener Gedankenstrichstil.
SOLID Durchgängige Linie. Entspricht dem ST-PresetLineDashVal-Wert „Solid“ von ECMA-376. Dies ist der Standardstil für Bindestriche.
DOT Gepunktete Linie Entspricht ECMA-376 ST_PresetLineDashVal-Wert „dot“.
DASH Gestrichelte Linie. Entspricht dem ECMA-376-ST_PresetLineDashVal-Wert „dash“.

Tabstopp

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 Tabs wird beendet. Wenn kein Wert festgelegt ist, wird standardmäßig START verwendet.

Tabstopp-Ausrichtung

Die Ausrichtung des Tabs wird beendet.

Enums
TAB_STOP_ALIGNMENT_UNSPECIFIED Die Ausrichtung der Tabstopps ist nicht angegeben.
START Der Tabstopp ist am Zeilenanfang ausgerichtet. Das ist die Standardeinstellung.
CENTER Der Tabstopp ist auf die Mitte der Linie ausgerichtet.
END Der Tabstopp ist am Ende der Zeile ausgerichtet.

Schattierung

Die Schattierung eines Absatzes.

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

object (OptionalColor)

Die Hintergrundfarbe dieses Absatzes

Vorgeschlagener Absatzstil

Vorgeschlagene Änderung an ParagraphStyle.

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

object (ParagraphStyle)

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

paragraphStyleSuggestionState

object (ParagraphStyleSuggestionState)

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

Absatzstilstil

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

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

boolean

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

namedStyleTypeSuggested

boolean

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

alignmentSuggested

boolean

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

lineSpacingSuggested

boolean

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

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

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

pageBreakBeforeSuggested

boolean

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

Schattierungsvorschläge

Eine Maske, die angibt, welche der Felder der Basis-Shading in dieser vorgeschlagenen Ä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 Shading vorgeschlagen wurde.

Bullet-Diagramm

Beschreibt das Aufzählungszeichen eines Absatzes.

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

string

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

nestingLevel

integer

Die Verschachtelungsebene dieses Absatzes in der Liste.

textStyle

object (TextStyle)

Der Absatz-spezifischer Textstil, der auf diesen Aufzählungspunkt angewendet wird.

Vorgeschlagenes Aufzählungszeichen

Vorgeschlagene Änderung an Bullet.

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

object (Bullet)

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

bulletSuggestionState

object (BulletSuggestionState)

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

Aufzählungsstatus

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

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

boolean

Gibt an, ob listId vorgeschlagen wurde.

nestingLevelSuggested

boolean

Gibt an, ob nestingLevel vorgeschlagen wurde.

textStyleSuggestionState

object (TextStyleSuggestionState)

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

Objektreferenzen

Eine Sammlung von Objekt-IDs.

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

string

Die Objekt-IDs.

Abschnittswechsel

Ein StructuralElement, der einen Abschnittswechsel darstellt. Ein Abschnitt ist ein Bereich mit Inhalten, die denselben SectionStyle haben. Ein Abschnittswechsel steht für den Beginn eines neuen Abschnitts und der Abschnittsstil wird auf den Abschnitt nach dem Abschnittswechsel angewendet.

Der Textkörper des Dokuments beginnt immer mit einem Abschnittswechsel.

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

string

Die vorgeschlagenen Einfügungs-IDs. Eine SectionBreak kann mehrere Einfügungs-IDs haben, wenn es sich um eine verschachtelte vorgeschlagene Änderung handelt. Wenn das Feld leer ist, wird kein neuer Anzeigenauftrag vorgeschlagen.

suggestedDeletionIds[]

string

Die vorgeschlagenen Lösch-IDs. Wenn das Feld leer ist, wird kein Inhalt zum Löschen vorgeschlagen.

sectionStyle

object (SectionStyle)

Der Stil des Abschnitts nach diesem Abschnittsbruch.

Abschnittsstil

Der Stil, der für einen Abschnitt gilt

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
}
Felder
columnProperties[]

object (SectionColumnProperties)

Spalteneigenschaften des Bereichs.

Wenn das Feld leer ist, enthält der Abschnitt eine Spalte mit den Standardeigenschaften im Docs-Editor. Ein Abschnitt kann maximal 3 Spalten enthalten.

Wenn Sie diese Property aktualisieren, muss ein konkreter Wert festgelegt werden. Wenn Sie die Property aufheben, wird ein Fehler 400 zu einer ungültigen Anfrage angezeigt.

columnSeparatorStyle

enum (ColumnSeparatorStyle)

Der Stil von Spaltentrennzeichen.

Dieser Stil kann auch festgelegt werden, wenn im Abschnitt nur eine Spalte vorhanden ist.

Wenn Sie diese Property aktualisieren, muss ein konkreter Wert festgelegt werden. Wenn Sie die Property aufheben, wird ein Fehler 400 zu einer ungültigen Anfrage angezeigt.

contentDirection

enum (ContentDirection)

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

Wenn Sie diese Property aktualisieren, muss ein konkreter Wert festgelegt werden. Wenn Sie die Property aufheben, wird ein Fehler 400 zu einer ungültigen Anfrage angezeigt.

marginTop

object (Dimension)

Der obere Rand des Bereichs. Wenn kein Wert festgelegt ist, wird der Standardwert von DocumentStyle auf marginTop gesetzt.

Wenn Sie diese Property aktualisieren, muss ein konkreter Wert festgelegt werden. Wenn Sie die Property aufheben, wird ein Fehler 400 zu einer ungültigen Anfrage angezeigt.

marginBottom

object (Dimension)

Der untere Rand des Bereichs. Wenn kein Wert festgelegt ist, wird der Standardwert von DocumentStyle auf marginBottom gesetzt.

Wenn Sie diese Property aktualisieren, muss ein konkreter Wert festgelegt werden. Wenn Sie die Property aufheben, wird ein Fehler 400 zu einer ungültigen Anfrage angezeigt.

marginRight

object (Dimension)

Der rechte Rand des Bereichs. Wenn kein Wert festgelegt ist, wird der Standardwert von DocumentStyle auf marginRight gesetzt. Wenn Sie den rechten Rand aktualisieren, wird die Größe der Spalten in diesem Abschnitt angepasst. Da der Rand die Spaltenbreite beeinflusst, wird er vor den Spalteneigenschaften angewendet.

Wenn Sie diese Property aktualisieren, muss ein konkreter Wert festgelegt werden. Wenn Sie die Property aufheben, wird ein Fehler 400 zu einer ungültigen Anfrage angezeigt.

marginLeft

object (Dimension)

Der linke Seitenrand des Bereichs. Wenn kein Wert festgelegt ist, wird der Standardwert von DocumentStyle auf marginLeft gesetzt. Wenn Sie den linken Rand aktualisieren, ändert sich die Größe der Spalten in diesem Abschnitt. Da der Rand die Spaltenbreite beeinflusst, wird er vor den Spalteneigenschaften angewendet.

Wenn Sie diese Property aktualisieren, muss ein konkreter Wert festgelegt werden. Wenn Sie die Property aufheben, wird ein Fehler 400 zu einer ungültigen Anfrage angezeigt.

marginHeader

object (Dimension)

Der Kopfzeilenrand des Bereichs. Wenn kein Wert festgelegt ist, wird der Standardwert von DocumentStyle auf marginHeader gesetzt. Bei Aktualisierung wird useCustomHeaderFooterMargins für „DocumentStyle“ auf „true“ gesetzt. Der Wert von useCustomHeaderFooterMargins für DocumentStyle gibt an, ob ein Kopfzeilenrand für diesen Abschnitt beachtet werden soll.

Wenn Sie diese Property aktualisieren, muss ein konkreter Wert festgelegt werden. Wenn Sie die Property aufheben, wird ein Fehler 400 zu einer ungültigen Anfrage angezeigt.

sectionType

enum (SectionType)

Nur Ausgabe. Die Art des Abschnitts.

defaultHeaderId

string

Die ID des Standardheaders. Wenn kein Wert festgelegt ist, wird der Wert aus dem vorherigen SectionBreak's-Abschnittsstil übernommen. Wenn der Wert im ersten Abschnittswechsel nicht festgelegt ist, übernimmt er die defaultHeaderId von DocumentStyle.

Diese Property ist schreibgeschützt.

firstPageHeaderId

string

Die ID des Headers, der nur für die erste Seite des Abschnitts verwendet wird. Wenn useFirstPageHeaderFooter „true“ ist, wird dieser Wert für den Header auf der ersten Seite des Abschnitts verwendet. Wenn er auf „false“ gesetzt ist, wird im Header auf der ersten Seite des Bereichs das defaultHeaderId verwendet. Wenn kein Wert festgelegt ist, wird der Wert aus dem vorherigen SectionBreak's-Abschnittsstil übernommen. Wenn der Wert im ersten Abschnittswechsel nicht festgelegt ist, übernimmt er die firstPageHeaderId von DocumentStyle.

Diese Property ist schreibgeschützt.

evenPageHeaderId

string

Die ID des Headers, der nur für gerade Seiten verwendet wird. Wenn der Wert von useEvenPageHeaderFooter von DocumentStyle auf „true“ gesetzt ist, wird dieser Wert für die Header auf geraden Seiten im Abschnitt verwendet. Wenn er „falsch“ ist, wird für Kopfzeilen auf geraden Seiten das defaultHeaderId verwendet. Wenn kein Wert festgelegt ist, wird der Wert aus dem vorherigen SectionBreak's-Abschnittsstil übernommen. Wenn der Wert im ersten Abschnittswechsel nicht festgelegt ist, übernimmt er die evenPageHeaderId von DocumentStyle.

Diese Property ist schreibgeschützt.

pageNumberStart

integer

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

Wenn Sie diese Property aktualisieren, muss ein konkreter Wert festgelegt werden. Wenn Sie die Property aufheben, wird ein Fehler 400 zu einer ungültigen Anfrage angezeigt.

Eigenschaften der Abschnittsspalte

Attribute, die für die Spalte eines Bereichs gelten.

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

object (Dimension)

Nur Ausgabe. Breite der Spalte.

paddingEnd

object (Dimension)

Der Abstand am Ende der Spalte.

Spaltentrennerstil

Stil von Spaltentrennzeichen zwischen Spalten.

Enums
COLUMN_SEPARATOR_STYLE_UNSPECIFIED Ein nicht spezifizierter Stil für Spaltentrennzeichen.
NONE Zwischen den Spalten gibt es keine Spaltentrennzeichen.
BETWEEN_EACH_COLUMN Gibt eine Spaltentrennlinie zwischen den einzelnen Spalten wieder.

Abschnittstyp

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

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, der eine Tabelle darstellt.

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

integer

Anzahl der Zeilen in der Tabelle.

columns

integer

Anzahl der Spalten in der Tabelle.

Es ist möglich, dass eine Tabelle nicht rechteckig ist. In manchen Zeilen wird daher eine andere Anzahl von Zellen angezeigt.

tableRows[]

object (TableRow)

Inhalt und Stil der einzelnen Zeilen.

suggestedInsertionIds[]

string

Die vorgeschlagenen Einfügungs-IDs. Eine Table kann mehrere Einfügungs-IDs haben, wenn es sich um eine verschachtelte vorgeschlagene Änderung handelt. Wenn das Feld leer ist, wird kein neuer Anzeigenauftrag vorgeschlagen.

suggestedDeletionIds[]

string

Die vorgeschlagenen Lösch-IDs. Wenn das Feld leer ist, wird kein Inhalt zum Löschen vorgeschlagen.

tableStyle

object (TableStyle)

Der Stil der Tabelle.

TableRow

Der Inhalt und Stil einer Zeile in einem Table.

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

integer

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

endIndex

integer

Der nullbasierte Endindex dieser Zeile, exklusiv, in UTF-16-Codeeinheiten.

tableCells[]

object (TableCell)

Inhalt und Stil der einzelnen Zellen in dieser Zeile.

Es ist möglich, dass eine Tabelle nicht rechteckig ist. In diesem Fall können einige Zeilen eine andere Anzahl von Zellen haben als andere Zeilen in derselben Tabelle.

suggestedInsertionIds[]

string

Die vorgeschlagenen Einfügungs-IDs. Eine TableRow kann mehrere Einfügungs-IDs haben, wenn es sich um eine verschachtelte vorgeschlagene Änderung handelt. Wenn das Feld leer ist, wird kein neuer Anzeigenauftrag vorgeschlagen.

suggestedDeletionIds[]

string

Die vorgeschlagenen Lösch-IDs. Wenn das Feld leer ist, wird kein Inhalt zum Löschen vorgeschlagen.

tableRowStyle

object (TableRowStyle)

Der Stil der Tabellenzeile.

suggestedTableRowStyleChanges

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

Der vorgeschlagene Stil ändert sich in diese Zeile, aufgeschlüsselt nach Vorschlags-ID.

TableCell

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 nullbasierte Endindex dieser Zelle, exklusiv, in UTF-16-Codeeinheiten.

content[]

object (StructuralElement)

Der Inhalt der Zelle.

tableCellStyle

object (TableCellStyle)

Der Stil der Zelle.

suggestedInsertionIds[]

string

Die vorgeschlagenen Einfügungs-IDs. Eine TableCell kann mehrere Einfügungs-IDs haben, wenn es sich um eine verschachtelte vorgeschlagene Änderung handelt. Wenn das Feld leer ist, wird kein neuer Anzeigenauftrag vorgeschlagen.

suggestedDeletionIds[]

string

Die vorgeschlagenen Lösch-IDs. Wenn das Feld leer ist, wird kein Inhalt zum Löschen vorgeschlagen.

suggestedTableCellStyleChanges

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

Die vorgeschlagenen Änderungen am Tabellenzellenstil, aufgeschlüsselt nach Vorschlags-ID.

Tabellenzelle

Der Stil eines TableCell.

Übernommene Stile in Tabellenzellen werden in dieser Nachricht als nicht festgelegte Felder dargestellt. Ein Tabellenzellenstil kann aus dem Stil der Tabelle übernommen werden.

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

integer

Der Zeilenbereich der Zelle.

Diese Property ist schreibgeschützt.

columnSpan

integer

Der Spaltenbereich der Zelle.

Diese Property ist schreibgeschützt.

backgroundColor

object (OptionalColor)

Die Hintergrundfarbe der Zelle.

borderLeft

object (TableCellBorder)

Linker Rahmen der Zelle

borderRight

object (TableCellBorder)

Der rechte Rand der Zelle.

borderTop

object (TableCellBorder)

Oberer Rahmen der Zelle.

borderBottom

object (TableCellBorder)

Unterer Rahmen der Zelle

paddingLeft

object (Dimension)

Linker Abstand der Zelle.

paddingRight

object (Dimension)

Der rechte Rand der Zelle.

paddingTop

object (Dimension)

Oberer Abstand der Zelle.

paddingBottom

object (Dimension)

Unterer Abstand der Zelle.

contentAlignment

enum (ContentAlignment)

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

Tabellenrahmen

Ein Rahmen um eine Tabellenzelle.

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

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

object (OptionalColor)

Die Farbe des Rahmens.

Diese Farbe darf nicht transparent sein.

width

object (Dimension)

Die Breite des Rahmens.

dashStyle

enum (DashStyle)

Der Rahmenstil des Rahmens.

Inhaltsausrichtung

Die Arten der Inhaltsausrichtung.

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 ECMA-376 4. Edition.

Enums
CONTENT_ALIGNMENT_UNSPECIFIED Eine nicht angegebene Inhaltsausrichtung. Die Inhaltsausrichtung wird vom übergeordneten Element übernommen, sofern vorhanden.
CONTENT_ALIGNMENT_UNSUPPORTED Eine nicht unterstützte Inhaltsausrichtung.
TOP Eine Ausrichtung, bei der der Inhalt am oberen Rand des Rechteinhabers ausgerichtet wird. Entspricht ECMA-376 ST_TextAnchoringType 't'.
MIDDLE Eine Ausrichtung, bei der der Inhalt auf die Mitte des Rechteinhabers ausgerichtet wird. Entspricht ECMA-376 ST_TextAnchoringType "ctr".
BOTTOM Eine Ausrichtung, bei der der Inhalt am unteren Teil des Rechteinhabers ausgerichtet wird. Entspricht ECMA-376 ST_TextAnchoringType "b".

Vorgeschlagene Tabellenzelle

Vorgeschlagene Änderung an TableCellStyle.

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

object (TableCellStyle)

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

tableCellStyleSuggestionState

object (TableCellStyleSuggestionState)

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

TabellenZellenstilvorschlagStatus

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

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

boolean

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

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

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

paddingTopSuggested

boolean

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

paddingBottomSuggested

boolean

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

contentAlignmentSuggested

boolean

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

Tabellenzeilenstil

Stile, die auf eine Tabellenzeile angewendet werden.

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

object (Dimension)

Die Mindesthöhe der Zeile. Die Zeile wird im Docs-Editor auf einer Höhe größer oder gleich diesem Wert gerendert, damit der gesamte Inhalt in den Zellen der Zeile angezeigt wird.

tableHeader

boolean

Gibt an, ob die Zeile eine Kopfzeile ist.

preventOverflow

boolean

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

Vorgeschlagene Tabellenzeilenstil

Vorgeschlagene Änderung an TableRowStyle.

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

object (TableRowStyle)

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

tableRowStyleSuggestionState

object (TableRowStyleSuggestionState)

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

TableRowStyleSuggestionState

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

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

boolean

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

Tabellenstil

Stile, die auf eine Tabelle angewendet werden.

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

object (TableColumnProperties)

Die Eigenschaften der einzelnen Spalten.

Beachten Sie, dass Tabellen in Docs Zeilen enthalten und Zeilen Zellen enthalten, ähnlich wie HTML. Die Eigenschaften für eine Zeile finden Sie daher im tableRowStyle der Zeile.

Attribute der Tabellenspalte

Die Eigenschaften einer Spalte in einer Tabelle.

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

enum (WidthType)

Der Breitentyp der Spalte.

width

object (Dimension)

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

Breite

Der Spaltentyp.

Enums
WIDTH_TYPE_UNSPECIFIED Der Typ der Spaltenbreite 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 die Spaltenbreite wird gleich groß, nachdem alle Spalten mit bestimmten Breiten berücksichtigt wurden.

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

Inhaltsverzeichnis

Ein StructuralElement, das ein Inhaltsverzeichnis darstellt.

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

object (StructuralElement)

Der Inhalt des Inhaltsverzeichnisses.

suggestedInsertionIds[]

string

Die vorgeschlagenen Einfügungs-IDs. Eine TableOfContents kann mehrere Einfügungs-IDs haben, wenn es sich um eine verschachtelte vorgeschlagene Änderung handelt. Wenn das Feld leer ist, wird kein neuer Anzeigenauftrag vorgeschlagen.

suggestedDeletionIds[]

string

Die vorgeschlagenen Lösch-IDs. Wenn das Feld leer ist, wird kein Inhalt zum Löschen vorgeschlagen.

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
}
Felder
background

object (Background)

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

defaultHeaderId

string

Die ID des Standardheaders. Wenn die Richtlinie nicht konfiguriert ist, gibt es keine Standardüberschrift.

Diese Property ist schreibgeschützt.

evenPageHeaderId

string

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

Diese Property ist schreibgeschützt.

firstPageHeaderId

string

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

Diese Property ist schreibgeschützt.

pageNumberStart

integer

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

marginTop

object (Dimension)

Der obere Seitenrand.

Durch das Aktualisieren des oberen Seitenrands für den Dokumentstil wird der obere Seitenrand für alle Abschnittsstile gelöscht.

marginBottom

object (Dimension)

Der untere Seitenrand.

Wenn Sie den unteren Seitenrand des Dokumentstils aktualisieren, wird der Seitenränder bei allen Bereichsstilen gelöscht.

marginRight

object (Dimension)

Der rechte Rand der Seite.

Wenn Sie den rechten Seitenrand des Dokumentstils aktualisieren, wird der rechte Rand bei allen Abschnittsstilen gelöscht. Außerdem kann die Größe von Spalten in allen Bereichen geändert werden.

marginLeft

object (Dimension)

Der linke Seitenrand.

Wenn Sie den linken Seitenrand im Dokumentstil aktualisieren, wird der linke Rand bei allen Abschnittsstilen gelöscht. Außerdem kann die Größe von Spalten in allen Bereichen geändert werden.

pageSize

object (Size)

Die Größe einer Seite im Dokument.

marginHeader

object (Dimension)

Der Abstand zwischen dem oberen Rand der Seite und dem Inhalt des Headers.

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.

Vorgeschlagenes Dokumentstil

Ein Änderungsvorschlag für das DocumentStyle.

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

object (DocumentStyle)

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

documentStyleSuggestionState

object (DocumentStyleSuggestionState)

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

DocumentStyleSuggestionState (Dokumentstilvorschlag)

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

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

object (BackgroundSuggestionState)

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

defaultHeaderIdSuggested

boolean

Gibt an, ob eine Änderung 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 eine Änderung an marginTop vorgeschlagen wurde.

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 Felder in [size] [google.apps.docs.v1.DocumentStyle.size] in diesem Vorschlag geändert wurden.

marginHeaderSuggested

boolean

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

Hintergrundvorschlagsstatus

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

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

boolean

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

Größenvorschlagsstatus

Eine Maske, die angibt, welche der Felder des 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.

Benannte Stile

Die benannten Stile. Für Absätze im Dokument können die TextStyle und ParagraphStyle aus diesen benannten Stilen übernommen werden.

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

object (NamedStyle)

Die benannten Stile.

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

Benanntes Design

Ein benannter Stil. Für Absätze im Dokument können die Einstellungen TextStyle und ParagraphStyle von diesem benannten Stil übernommen werden, 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 dieses benannten Stils.

paragraphStyle

object (ParagraphStyle)

Der Absatzstil dieses benannten Stils

Vorgeschlagene Namensstile

Ein Änderungsvorschlag für das NamedStyles.

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

object (NamedStyles)

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

namedStylesSuggestionState

object (NamedStylesSuggestionState)

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

NameStyledSuggestionState

Der Vorschlagsstatus einer NamedStyles-Nachricht.

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

object (NamedStyleSuggestionState)

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

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

NameStyleStyleState

Ein 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 als Referenz für den Abgleich des NamedStyleSuggestionState-Elements mit dem entsprechenden NamedStyle.

textStyleSuggestionState

object (TextStyleSuggestionState)

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

paragraphStyleSuggestionState

object (ParagraphStyleSuggestionState)

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

Liste

Eine Liste stellt die Listenattribute für eine Absatzgruppe dar, die alle zur selben Liste gehören. Ein Absatz, der Teil einer Liste ist, verweist in seinem bullet auf die ID der Liste.

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

object (ListProperties)

Die Eigenschaften der Liste.

suggestedListPropertiesChanges

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

Die vorgeschlagenen Änderungen an den Listeneigenschaften, aufgeschlüsselt nach Vorschlags-ID.

suggestedInsertionId

string

Die vorgeschlagene Platzhalter-ID. Wenn das Feld leer ist, wird kein neuer Anzeigenauftrag vorgeschlagen.

suggestedDeletionIds[]

string

Die vorgeschlagenen Lösch-IDs. Wenn das Feld leer ist, wird die Liste nicht gelöscht.

ListProperties

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

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

object (NestingLevel)

Beschreibt die Attribute der Aufzählungspunkte auf der zugehörigen Ebene.

Eine Liste hat maximal neun Verschachtelungsebenen, wobei die Verschachtelungsebene 0 der obersten Ebene und die Verschachtelungsebene 8 der verschachtelten Ebene entspricht. Die Verschachtelungsebenen werden in aufsteigender Reihenfolge zurückgegeben, wobei das am wenigsten verschachtelte Element zuerst zurückgegeben wird.

Verschachtelungsebene

Enthält Eigenschaften, die das Design eines Listenpunkts auf einer bestimmten Verschachtelungsebene beschreiben.

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

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

enum (BulletAlignment)

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

glyphFormat

string

Der Formatstring, der von Aufzählungszeichen auf dieser Verschachtelungsebene verwendet wird.

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

Das Glyph-Format %0. gibt beispielsweise an, dass das gerenderte Glyph den Platzhalter durch die entsprechende Glyphe für Verschachtelungsebene 0 ersetzt, gefolgt von einem Punkt als Suffix. Eine Liste mit dem Glyphentyp UPPER_ALPHA und dem Glyphenformat %0. auf Verschachtelungsebene 0 führt zu einer Liste mit gerenderten Glyphen

A.

B.

C.

Das Glyphenformat kann Platzhalter für die aktuelle Verschachtelungsebene und Platzhalter für übergeordnete Verschachtelungsebenen enthalten. Eine Liste kann beispielsweise das Glyph-Format %0. auf Verschachtelungsebene 0 und das Glyph-Format %0.%1. auf Verschachtelungsebene 1 haben. Angenommen, beide Verschachtelungsebenen haben DECIMAL Glyphentypen, dies würde zu einer Liste mit gerenderten Glyphen führen.

1.

2.

2.1.

2.2.

3.

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

indentFirstLine

object (Dimension)

Der Einzug für die erste Absatzzeile auf dieser Verschachtelungsebene.

indentStart

object (Dimension)

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

textStyle

object (TextStyle)

Der Textstil von Aufzählungszeichen auf dieser Verschachtelungsebene.

startNumber

integer

Die Nummer des ersten Listenelements auf dieser Verschachtelungsebene.

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

Dieser Wert wird beim Verschachteln von Levels mit ungeordneten Glyphen ignoriert.

Union-Feld glyph_kind. Der Glyphentyp, der von Aufzählungszeichen verwendet wird. Definiert das Aufzählungszeichen für die Liste, 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ählungszeichen verwendet wird, wenn Absätze auf dieser Verschachtelungsebene angeordnet sind.

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

glyphSymbol

string

Ein benutzerdefiniertes Symbol, das von Aufzählungszeichen verwendet wird, wenn Absätze auf dieser Verschachtelungsebene ungeordnet sind.

Das Glyphensymbol ersetzt Platzhalter in glyphFormat. Wenn z. B. das glyphSymbol der durchgezogene Kreis für den Unicode-Code „U+25cf“ ist und glyphFormat den Wert „%0“ hat, ist das gerenderte Symbol der ausgefüllte Kreis.

Aufzählungszeichen

Die Arten der Ausrichtung für eine Aufzählung.

Enums
BULLET_ALIGNMENT_UNSPECIFIED Die Ausrichtung des Aufzählungszeichens ist nicht angegeben.
START Das Aufzählungszeichen wird am Anfang des Platzes ausgerichtet, der für das Rendering des Aufzählungszeichens vorgesehen ist. Links ausgerichtet für LTR-Text, ansonsten rechtsbündig.
CENTER Das Aufzählungszeichen ist an der Mitte des Raums ausgerichtet, der zum Rendern des Aufzählungszeichens vorgesehen ist.
END Das Aufzählungszeichen ist am Ende des Platzes ausgerichtet, der zum Rendern des Aufzählungszeichens vorgesehen ist. Rechts ausgerichtet für LTR-Text, ansonsten linksbündig.

Glyphentyp

Die Arten der Glyphen, die von Aufzählungszeichen verwendet werden, wenn Absätze auf dieser Verschachtelungsebene angeordnet sind.

Enums
GLYPH_TYPE_UNSPECIFIED Der Glyph-Typ 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 versehen sind, z. B. 01, 02 oder 03. Nummern mit mehr als einer Ziffer wird keine Null vorangestellt.
UPPER_ALPHA Ein Großbuchstaben, z. B. A, B oder C
ALPHA Ein Kleinbuchstaben, z. B. a, b oder c
UPPER_ROMAN Große römische Zahl, z. B. I, II oder III
ROMAN Ein römisches Kleinbuchstaben, wie i, ii oder iii.

Vorgeschlagene Listeneigenschaften

Eine vorgeschlagene Änderung für ListProperties.

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

object (ListProperties)

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

listPropertiesSuggestionState

object (ListPropertiesSuggestionState)

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

ListPropertiesSuggestionState

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

Die Vorschlagsstatus der Verschachtelungsebene werden in aufsteigender Reihenfolge der Verschachtelungsebene zurückgegeben, wobei das am wenigsten verschachtelte Attribut zuerst zurückgegeben wird.

Status der verschachtelten Stufe

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

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

boolean

Gibt an, ob 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 Felder in text style in diesem Vorschlag geändert wurden.

startNumberSuggested

boolean

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

BenannteBereiche

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

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

string

Der Name, den alle named ranges verwenden.

namedRanges[]

object (NamedRange)

Die NamedRanges mit demselben Namen.

BenannterBereich

Eine Sammlung von Ranges mit derselben benannten Bereichs-ID.

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

Ein benannter Bereich wird mit einem einzelnen Range erstellt und der Inhalt, der in einem benannten Bereich eingefügt wird, erweitert diesen Bereich im Allgemeinen. Bestimmte Dokumentänderungen können jedoch dazu führen, dass der Bereich in mehrere Bereiche aufgeteilt wird.

Benannte Bereiche sind nicht privat. Alle benannten Bereiche für Anwendungen und Mitbearbeiter mit Zugriff auf das Dokument werden angezeigt.

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.

Wertebereich

Gibt einen zusammenhängenden Textbereich an.

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

string

Die ID der Kopf-, Fußzeile 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 jeder aktuellen Verwendung muss ein Startindex angegeben werden. Dieses Feld ist ein Int32Value, um zukünftige Anwendungsfälle mit offenen Bereichen zu berücksichtigen.

endIndex

integer

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

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

Vorschlagsmodus für Vorschläge

Der Ansichtsmodus für Vorschläge, der auf das Dokument angewendet wird und angibt, wie die vorgeschlagenen Änderungen dargestellt werden Es bietet Optionen zum Lesen des Dokuments mit allen Vorschlägen inline, akzeptiert oder abgelehnt.

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

Das zurückgegebene Dokument enthält Vorschläge inline. Vorgeschlagene Änderungen unterscheiden sich vom Basisinhalt des Dokuments.

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

PREVIEW_SUGGESTIONS_ACCEPTED

Das zurückgegebene Dokument ist eine Vorschau mit allen vorgeschlagenen Änderungen.

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

PREVIEW_WITHOUT_SUGGESTIONS Das zurückgegebene Dokument ist eine Vorschau, bei der alle Änderungsvorschläge abgelehnt werden, falls es Vorschläge im Dokument gibt.

Inline-Objekt

Ein Objekt, das inline mit Text erscheint. Ein InlineObject enthält ein EmbeddedObject wie 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, aufgeschlüsselt nach Vorschlags-ID.

suggestedInsertionId

string

Die vorgeschlagene Platzhalter-ID. Wenn das Feld leer ist, wird kein neuer Anzeigenauftrag vorgeschlagen.

suggestedDeletionIds[]

string

Die vorgeschlagenen Lösch-IDs. Wenn das Feld leer ist, wird kein Inhalt zum Löschen vorgeschlagen.

InlineObjectProperties (Inline-Objekteigenschaften)

Attribute von InlineObject.

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

object (EmbeddedObject)

Das eingebettete Objekt dieses Inline-Objekts.

Eingebettetes Objekt

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 alternativen Text anzuzeigen.

description

string

Die Beschreibung des eingebetteten Objekts. title und description werden kombiniert, um alternativen Text anzuzeigen.

embeddedObjectBorder

object (EmbeddedObjectBorder)

Der Rahmen des eingebetteten Objekts.

size

object (Size)

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

marginTop

object (Dimension)

Der obere Rand des eingebetteten Objekts.

marginBottom

object (Dimension)

Der untere Rand des eingebetteten Objekts.

marginRight

object (Dimension)

Der rechte Rand des eingebetteten Objekts.

marginLeft

object (Dimension)

Der linke Rand des eingebetteten Objekts.

linkedContentReference

object (LinkedContentReference)

Ein Verweis auf den extern verknüpften Quellinhalt. Beispielsweise enthält es einen Verweis auf das Google Tabellen-Quelldiagramm, wenn das eingebettete Objekt ein verknüpftes Diagramm ist.

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

Union-Feld properties. Die 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

Die Eigenschaften einer eingebetteten Zeichnung, die zur Unterscheidung des Objekttyps verwendet wird. Eine eingebettete Zeichnung wird in einem Dokument erstellt und bearbeitet. Umfangreiche Informationen 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 Anforderers getaggt. Jeder Nutzer mit dem URI greift auf das Bild als ursprünglicher Anforderer zu. Der Zugriff auf das Bild geht möglicherweise verloren, wenn sich die Freigabeeinstellungen des Dokuments ändern.

sourceUri

string

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

brightness

number

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

contrast

number

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

transparency

number

Der Transparenzeffekt des Bildes. Der Wert sollte im Intervall [0.0, 1.0] liegen, wobei 0 keinen Effekt und 1 transparent bedeutet.

cropProperties

object (CropProperties)

Die Zuschneideeigenschaften des Bildes.

angle

number

Der Drehwinkel des Bildes im Uhrzeigersinn im Bogenmaß.

Ernteeigenschaften

Die Zuschneideeigenschaften eines Bildes.

Das Zuschneiderechteck wird durch Bruchteile von den vier Rändern des ursprünglichen Inhalts dargestellt.

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

number

Der Versatz gibt an, wie weit der linke Rand des Zuschneidebereichs vom linken Rand des Originalinhalts als Bruchteil der Breite des ursprünglichen Inhalts entfernt ist.

offsetRight

number

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

offsetTop

number

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

offsetBottom

number

Der Versatz gibt an, wie weit der untere Rand des Zuschneidebereichs vom unteren Rand des Originalinhalts als Bruchteil der Höhe des ursprünglichen Inhalts entfernt ist.

angle

number

Der Winkel des Zuschneidebereichs im Uhrzeigersinn um seine Mitte im Bogenmaß. Die Rotation wird nach den Offsets angewendet.

Eingebetteter Objektrahmen

Ein Rahmen um einen 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 Rahmenstil des Rahmens.

propertyState

enum (PropertyState)

Der Property-Status der Border-Property.

Property-Status

Die möglichen Status einer Property.

Enums
RENDERED Wenn der Status einer Eigenschaft RENDERED lautet, hat das Element die entsprechende Eigenschaft, wenn es im Dokument gerendert wird. „Immer“ ist der Standardwert.
NOT_RENDERED Wenn der Status einer Eigenschaft NOT_RENDERED ist, verfügt das Element nicht über die entsprechende Eigenschaft, wenn es im Dokument gerendert wird.

LinkedContentReference

Ein Verweis auf den extern verknüpften Quellinhalt.

JSON-Darstellung
{
  "sheetsChartReference": {
    object (SheetsChartReference)
  }
}
Felder
sheetsChartReference

object (SheetsChartReference)

Ein Verweis auf das verknüpfte Diagramm.

TabellenDiagrammreferenz

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

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

string

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

chartId

integer

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

Vorgeschlagene InlineObjectProperties

Eine vorgeschlagene Änderung für InlineObjectProperties.

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

object (InlineObjectProperties)

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

inlineObjectPropertiesSuggestionState

object (InlineObjectPropertiesSuggestionState)

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

InlineObjectPropertiesSuggestionState

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

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

object (EmbeddedObjectSuggestionState)

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

EmbeddedObjectSuggestionState

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

imagePropertiesSuggestionState

object (ImagePropertiesSuggestionState)

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

titleSuggested

boolean

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

descriptionSuggested

boolean

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

embeddedObjectBorderSuggestionState

object (EmbeddedObjectBorderSuggestionState)

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

sizeSuggestionState

object (SizeSuggestionState)

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

marginLeftSuggested

boolean

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

marginRightSuggested

boolean

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

marginTopSuggested

boolean

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

marginBottomSuggested

boolean

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

linkedContentReferenceSuggestionState

object (LinkedContentReferenceSuggestionState)

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

EmbeddedDrawingPropertiesSuggestionState

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

BildeigenschaftenVorschlagsstatus

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

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

boolean

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

sourceUriSuggested

boolean

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

brightnessSuggested

boolean

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

contrastSuggested

boolean

Gibt an, ob [Kontrast] [google.apps.docs.v1.EmbeddedObject.contrast] vorgeschlagen wurde.

transparencySuggested

boolean

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

cropPropertiesSuggestionState

object (CropPropertiesSuggestionState)

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

angleSuggested

boolean

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

Status von Zuschneideeigenschaften

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

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

boolean

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

offsetRightSuggested

boolean

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

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 des Basis-EmbeddedObjectBorder in diesem Vorschlag geändert wurden. Für jedes Feld, das auf „true“ gesetzt ist, gibt es einen neuen vorgeschlagenen Wert.

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

boolean

Gibt an, ob 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] vorgenommen 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 des 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 Felder in sheetsChartReference in diesem Vorschlag geändert wurden.

SheetsChartReferenceSuggestionState (TabellendiagrammReferenzvorschlag)

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

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

boolean

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

chartIdSuggested

boolean

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

Positioniertes Objekt

Ein Objekt, das mit einem Paragraph verknüpft und relativ zum Anfang des Absatzes positioniert ist. Ein PositionedObject enthält ein EmbeddedObject, beispielsweise ein Bild.

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

string

Die ID dieses positionierten Objekts.

positionedObjectProperties

object (PositionedObjectProperties)

Die Eigenschaften dieses positionierten Objekts.

suggestedPositionedObjectPropertiesChanges

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

Die vorgeschlagenen Änderungen an den Positionsobjekteigenschaften, aufgeschlüsselt nach Vorschlags-ID

suggestedInsertionId

string

Die vorgeschlagene Platzhalter-ID. Wenn das Feld leer ist, wird kein neuer Anzeigenauftrag vorgeschlagen.

suggestedDeletionIds[]

string

Die vorgeschlagenen Lösch-IDs. Wenn das Feld leer ist, wird kein Inhalt zum Löschen vorgeschlagen.

Positionierte Objekteigenschaften

Attribute von PositionedObject.

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

object (PositionedObjectPositioning)

Die Positionierung dieses positionierten Objekts im Verhältnis zur Zeilenumbruchzeile von Paragraph, die auf dieses positionierte Objekt verweist.

embeddedObject

object (EmbeddedObject)

Das eingebettete Objekt dieses positionierten Objekts.

Positioniertes Objekt positionieren

Die Positionierung eines PositionedObject. Das Positionierungsobjekt wird relativ zum Anfang der Paragraph ausgerichtet, an die es per Tethering gebunden 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 des linken Rands des positionierten Objekts relativ zum Anfang der Paragraph, an die das Tethering gebunden 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 der Paragraph, an die das Tethering gebunden ist. Die genaue Positionierung des Objekts kann von anderen Inhalten im Dokument und vom Stil des Dokuments abhängen.

PositioniertesObjektlayout

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

Enums
POSITIONED_OBJECT_LAYOUT_UNSPECIFIED Das Layout ist nicht angegeben.
WRAP_TEXT Der Text umschließt das positionierte Objekt.
BREAK_LEFT Schreibt Text so, dass sich das positionierte Objekt links und der Text rechts befindet.
BREAK_RIGHT Schreibt den Text so, dass sich das positionierte Objekt rechts und der Text links befindet.
BREAK_LEFT_RIGHT Zerstört Text, sodass links oder rechts vom positionierten Objekt kein Text mehr vorhanden ist.
IN_FRONT_OF_TEXT Das positionierte Objekt befindet sich vor dem Text.
BEHIND_TEXT Das positionierte Objekt befindet sich hinter dem Text.

VorgeschlagenePositionedObjectProperties

Eine vorgeschlagene Änderung für PositionedObjectProperties.

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

object (PositionedObjectProperties)

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

positionedObjectPropertiesSuggestionState

object (PositionedObjectPropertiesSuggestionState)

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

PositionedObjectPropertiesSuggestionState

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

embeddedObjectSuggestionState

object (EmbeddedObjectSuggestionState)

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

PositionedObjectPositioningSuggestionState

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

leftOffsetSuggested

boolean

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

topOffsetSuggested

boolean

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

Methoden

batchUpdate

Wendet eine oder mehrere Aktualisierungen auf das Dokument an.

create

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

get

Ruft die neueste Version des angegebenen Dokuments ab.