Requests

{

  // Union field request can be only one of the following:
  "replaceAllText": {
    object (ReplaceAllTextRequest)
  },
  "insertText": {
    object (InsertTextRequest)
  },
  "updateTextStyle": {
    object (UpdateTextStyleRequest)
  },
  "createParagraphBullets": {
    object (CreateParagraphBulletsRequest)
  },
  "deleteParagraphBullets": {
    object (DeleteParagraphBulletsRequest)
  },
  "createNamedRange": {
    object (CreateNamedRangeRequest)
  },
  "deleteNamedRange": {
    object (DeleteNamedRangeRequest)
  },
  "updateParagraphStyle": {
    object (UpdateParagraphStyleRequest)
  },
  "deleteContentRange": {
    object (DeleteContentRangeRequest)
  },
  "insertInlineImage": {
    object (InsertInlineImageRequest)
  },
  "insertTable": {
    object (InsertTableRequest)
  },
  "insertTableRow": {
    object (InsertTableRowRequest)
  },
  "insertTableColumn": {
    object (InsertTableColumnRequest)
  },
  "deleteTableRow": {
    object (DeleteTableRowRequest)
  },
  "deleteTableColumn": {
    object (DeleteTableColumnRequest)
  },
  "insertPageBreak": {
    object (InsertPageBreakRequest)
  },
  "deletePositionedObject": {
    object (DeletePositionedObjectRequest)
  },
  "updateTableColumnProperties": {
    object (UpdateTableColumnPropertiesRequest)
  },
  "updateTableCellStyle": {
    object (UpdateTableCellStyleRequest)
  },
  "updateTableRowStyle": {
    object (UpdateTableRowStyleRequest)
  },
  "replaceImage": {
    object (ReplaceImageRequest)
  },
  "updateDocumentStyle": {
    object (UpdateDocumentStyleRequest)
  },
  "mergeTableCells": {
    object (MergeTableCellsRequest)
  },
  "unmergeTableCells": {
    object (UnmergeTableCellsRequest)
  },
  "createHeader": {
    object (CreateHeaderRequest)
  },
  "createFooter": {
    object (CreateFooterRequest)
  },
  "createFootnote": {
    object (CreateFootnoteRequest)
  },
  "replaceNamedRangeContent": {
    object (ReplaceNamedRangeContentRequest)
  },
  "updateSectionStyle": {
    object (UpdateSectionStyleRequest)
  },
  "insertSectionBreak": {
    object (InsertSectionBreakRequest)
  },
  "deleteHeader": {
    object (DeleteHeaderRequest)
  },
  "deleteFooter": {
    object (DeleteFooterRequest)
  },
  "pinTableHeaderRows": {
    object (PinTableHeaderRowsRequest)
  }
  // End of list of possible types for union field request.
}

object (ReplaceAllTextRequest)

Ersetzt alle Instanzen des angegebenen Textes.

object (InsertTextRequest)

Fügt Text an der angegebenen Stelle ein.

object (UpdateTextStyleRequest)

Aktualisiert den Textstil im angegebenen Bereich.

object (CreateParagraphBulletsRequest)

Erstellt Aufzählungszeichen für Absätze.

object (DeleteParagraphBulletsRequest)

Löscht Aufzählungszeichen aus Absätzen.

object (CreateNamedRangeRequest)

Erstellt einen benannten Bereich.

object (DeleteNamedRangeRequest)

Löscht einen benannten Bereich.

object (UpdateParagraphStyleRequest)

Aktualisiert den Absatzstil im angegebenen Bereich.

object (DeleteContentRangeRequest)

Löscht Inhalte aus dem Dokument.

object (InsertInlineImageRequest)

Fügt an der angegebenen Stelle ein Inline-Bild ein.

object (InsertTableRequest)

Fügt an der angegebenen Stelle eine Tabelle ein.

object (InsertTableRowRequest)

Fügt eine leere Zeile in eine Tabelle ein.

object (InsertTableColumnRequest)

Fügt eine leere Spalte in eine Tabelle ein.

object (DeleteTableRowRequest)

Löscht eine Zeile aus einer Tabelle.

object (DeleteTableColumnRequest)

Löscht eine Spalte aus einer Tabelle.

object (InsertPageBreakRequest)

Fügt an der angegebenen Stelle einen Seitenumbruch ein.

object (DeletePositionedObjectRequest)

Löscht ein positioniertes Objekt aus dem Dokument.

object (UpdateTableColumnPropertiesRequest)

Aktualisiert die Eigenschaften von Spalten in einer Tabelle.

object (UpdateTableCellStyleRequest)

Hiermit wird der Stil der Tabellenzellen aktualisiert.

object (UpdateTableRowStyleRequest)

Aktualisiert den Zeilenstil in einer Tabelle.

object (ReplaceImageRequest)

Ersetzt ein Bild im Dokument.

object (UpdateDocumentStyleRequest)

Aktualisiert den Stil des Dokuments.

object (MergeTableCellsRequest)

Verbindet Zellen in einer Tabelle.

object (UnmergeTableCellsRequest)

Hebt den Zellenverbund in einer Tabelle auf.

object (CreateHeaderRequest)

Erstellt einen Header.

object (CreateFooterRequest)

Erstellt eine Fußzeile.

object (CreateFootnoteRequest)

Erstellt eine Fußnote.

object (ReplaceNamedRangeContentRequest)

Ersetzt den Inhalt eines benannten Bereichs.

object (UpdateSectionStyleRequest)

Aktualisiert den Abschnittsstil des angegebenen Bereichs.

object (InsertSectionBreakRequest)

Fügt an der angegebenen Stelle einen Abschnittsumbruch ein.

object (DeleteHeaderRequest)

Löscht eine Kopfzeile aus dem Dokument.

object (DeleteFooterRequest)

Löscht eine Fußzeile aus dem Dokument.

object (PinTableHeaderRowsRequest)

Aktualisiert die Anzahl der angepinnten Überschriftenzeilen in einer Tabelle.

{
  "replaceText": string,
  "tabsCriteria": {
    object (TabsCriteria)
  },

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

string

Der Text, der den übereinstimmenden Text ersetzt.

object (TabsCriteria)

Optional. Die Kriterien, mit denen festgelegt wird, auf welchen Tabs die Ersetzung erfolgt.

Wenn Sie den Parameter weglassen, gilt der Ersatz für alle Tabs.

In einem Dokument mit einem einzelnen Tab:

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

• Wenn Sie diese Option weglassen, wird der Ersatz auf den einzelnen Tab angewendet.

In einem Dokument mit mehreren Tabs:

• Wenn angegeben, wird der Ersatz auf die angegebenen Tabs angewendet.

• Wird der Parameter weggelassen, gilt der Ersatz für alle Tabs.

object (SubstringMatchCriteria)

Sucht im Dokument nach Text, der mit diesem Teilstring übereinstimmt.

{
  "text": string,
  "matchCase": boolean
}

string

Der Text, nach dem im Dokument gesucht werden soll.

boolean

Gibt an, ob bei der Suche die Groß- und Kleinschreibung berücksichtigt werden soll:

• True : Bei der Suche wird zwischen Groß- und Kleinschreibung unterschieden.
• False : Bei der Suche wird die Groß-/Kleinschreibung nicht berücksichtigt.

{
  "tabIds": [
    string
  ]
}

string

Die Liste der Tab-IDs, in denen die Anfrage ausgeführt wird.

{
  "text": string,

  // Union field insertion_location can be only one of the following:
  "location": {
    object (Location)
  },
  "endOfSegmentLocation": {
    object (EndOfSegmentLocation)
  }
  // End of list of possible types for union field insertion_location.
}

string

Der Text, der eingefügt werden soll.

Durch das Einfügen eines Zeilenumbruchzeichens wird implizit ein neues Paragraph bei diesem Index. Der Absatzstil des neuen Absatzes wird aus dem Absatz am aktuellen Einfügeindex kopiert, einschließlich Listen und Aufzählungszeichen.

Textstile für eingefügten Text werden automatisch bestimmt. Dabei wird in der Regel der Stil des benachbarten Texts beibehalten. In den meisten Fällen entspricht der Textstil für den eingefügten Text dem Text direkt vor dem Einfügeindex.

Einige Steuerzeichen (U+0000-U+0008, U+000C-U+001F) und Zeichen aus dem Unicode Basic Multilingual Plane Private Use Area (U+E000-U+F8FF) werden aus dem eingefügten Text entfernt.

object (Location)

Fügt den Text bei einem bestimmten Index im Dokument ein.

Der Text muss innerhalb der Grenzen einer vorhandenen Paragraph eingefügt werden. Text kann beispielsweise nicht am Anfangsindex einer Tabelle eingefügt werden (d. h. zwischen der Tabelle und dem vorhergehenden Absatz). Der Text muss in den vorherigen Absatz eingefügt werden.

object (EndOfSegmentLocation)

Der Text wird am Ende einer Kopf- oder Fußzeile, einer Fußnote oder im Textkörper eingefügt.

{
  "segmentId": string,
  "index": integer,
  "tabId": string
}

string

Die ID der Kopf-, Fußzeile oder Fußnote, in der sich der Standort befindet. Eine leere Segment-ID steht für den Textkörper des Dokuments.

integer

Der nullbasierte Index in UTF-16-Codeeinheiten.

Der Index bezieht sich auf den Anfang des durch segmentId

string

Der Tab, auf dem sich der Standort befindet. Wird kein Wert angegeben, wird die Anfrage auf den ersten Tab angewendet.

In einem Dokument mit einem einzelnen Tab:

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

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

In einem Dokument mit mehreren Tabs:

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

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

{
  "segmentId": string,
  "tabId": string
}

string

Die ID der Kopf-, Fußzeile oder Fußnote, in der sich der Standort befindet. Eine leere Segment-ID kennzeichnet den Textkörper des Dokuments.

string

Der Tab, auf dem sich der Standort befindet. Wird kein Wert angegeben, wird die Anfrage auf den ersten Tab angewendet.

In einem Dokument mit einem einzelnen Tab:

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

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

In einem Dokument mit mehreren Tabs:

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

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

{
  "textStyle": {
    object (TextStyle)
  },
  "fields": string,

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

object (TextStyle)

Die Stile, die für den Text festgelegt werden sollen.

Wenn der Wert für einen bestimmten Stil mit dem des übergeordneten Stils übereinstimmt, wird dieser Stil übernommen.

Bestimmte Änderungen am Textstil können andere Änderungen zur Folge haben, um das Verhalten des Docs-Editors widerzuspiegeln. Weitere Informationen finden Sie in der Dokumentation zu TextStyle.

string (FieldMask format)

Die zu aktualisierenden Felder.

Es muss mindestens ein Feld angegeben werden. Der Stammknoten textStyle ist implizit und muss nicht angegeben werden. Ein einzelnes "*" kann als Kurzschreibweise für die Auflistung aller Felder verwendet werden.

Wenn Sie beispielsweise den Textstil fett formatieren möchten, setzen Sie fields auf "bold".

Wenn Sie eine Property auf den Standardwert zurücksetzen möchten, geben Sie den Feldnamen in die Feldmaske ein, lassen Sie das Feld aber leer.

object (Range)

Der Textbereich, der formatiert werden soll.

Der Bereich kann auf benachbarte Zeilenumbrüche erweitert werden.

Wenn der Bereich einen Absatz vollständig enthält, der zu einer Liste gehört, wird auch der Aufzählungspunkt des Absatzes mit dem entsprechenden Textstil aktualisiert.

Bereiche können nicht in eine relative UpdateTextStyleRequest eingefügt werden.

{
  "range": {
    object (Range)
  },
  "bulletPreset": enum (BulletGlyphPreset)
}

object (Range)

Der Bereich, auf den die Voreinstellung für Aufzählungszeichen angewendet werden soll.

enum (BulletGlyphPreset)

Die Art der zu verwendenden Aufzählungszeichen.

{
  "range": {
    object (Range)
  }
}

object (Range)

Bereich, aus dem Aufzählungszeichen gelöscht werden sollen

{
  "name": string,
  "range": {
    object (Range)
  }
}

string

Der Name des benannten Bereichs. Namen müssen nicht eindeutig sein.

Namen müssen mindestens ein und maximal 256 Zeichen lang sein, gemessen in UTF-16-Codeeinheiten.

object (Range)

Der Bereich, auf den der Name angewendet werden soll.

{
  "tabsCriteria": {
    object (TabsCriteria)
  },

  // Union field named_range_reference can be only one of the following:
  "namedRangeId": string,
  "name": string
  // End of list of possible types for union field named_range_reference.
}

object (TabsCriteria)

Optional. Die Kriterien, mit denen angegeben wird, auf welchem oder welchen Tabs der Bereich gelöscht werden soll. Wird der Bereich weggelassen, wird er auf alle Tabs angewendet.

In einem Dokument mit einem einzelnen Tab:

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

• Wenn nichts angegeben ist, wird der Bereich nur für den Singular gelöscht.

In einem Dokument mit mehreren Tabs:

• Falls angegeben, wird der Bereich auf die angegebenen Tabs gelöscht.

• Wenn nicht angegeben, wird der Bereich auf alle Tabs gelöscht.

string

Die ID des benannten Bereichs, der gelöscht werden soll.

string

Der Name der zu löschenden Bereiche. Alle benannten Bereiche mit diesem Namen werden gelöscht.

{
  "paragraphStyle": {
    object (ParagraphStyle)
  },
  "fields": string,

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

object (ParagraphStyle)

Die Stile, die für die Absätze festgelegt werden sollen.

Bestimmte Änderungen am Absatzstil können andere Änderungen zur Folge haben, die dem Verhalten des Docs-Editors entsprechen. Weitere Informationen finden Sie in der Dokumentation zu ParagraphStyle .

string (FieldMask format)

Die zu aktualisierenden Felder.

Es muss mindestens ein Feld angegeben werden. Der Stamm paragraphStyle ist impliziert und sollte nicht angegeben werden. Ein einzelnes "*" kann als Kurzschreibweise für die Auflistung aller Felder verwendet werden.

Wenn Sie beispielsweise die Ausrichtungseigenschaft des Absatzstils aktualisieren möchten, setzen Sie fields auf "alignment".

Wenn Sie eine Eigenschaft auf den Standardwert zurücksetzen möchten, fügen Sie ihren Feldnamen in die Feldmaske ein, lassen das Feld aber nicht.

object (Range)

Der Bereich, der die zu formatierenden Absätze überschneidet.

{
  "range": {
    object (Range)
  }
}

object (Range)

Der Bereich der zu löschenden Inhalte.

Das Löschen von Text, der eine Absatzgrenze überschreitet, kann beim Zusammenführen der beiden Absätze zu Änderungen an Absatzformaten, Listen, positionierten Objekten und Lesezeichen führen.

Wenn Sie versuchen, bestimmte Bereiche zu löschen, kann das zu einer ungültigen Dokumentstruktur führen. In diesem Fall wird der Fehler 400 (Ungültige Anfrage) zurückgegeben.

Beispiele für ungültige Löschanfragen:

• Löschen einer Codeeinheit eines Ersatzwertpaars.
• Löschen des letzten Zeichens für neue Zeile in einem Body-, Header-, Footer-, Footnote-, TableCell- oder TableOfContents-Element
• Start oder Ende eines Table-, TableOfContents- oder Equation-Elements löschen, ohne das gesamte Element zu löschen
• Löschen des Zeilenumbruchzeichens vor einem Table, TableOfContents oder SectionBreak ohne das Element zu löschen.
• Löschen einzelner Zeilen oder Zellen einer Tabelle Das Löschen des Inhalts in einer Tabellenzelle ist zulässig.

{
  "uri": string,
  "objectSize": {
    object (Size)
  },

  // Union field insertion_location can be only one of the following:
  "location": {
    object (Location)
  },
  "endOfSegmentLocation": {
    object (EndOfSegmentLocation)
  }
  // End of list of possible types for union field insertion_location.
}

string

Der Image-URI.

Das Bild wird beim Einfügen einmal abgerufen und eine Kopie wird zur Anzeige im Dokument gespeichert. Bilder dürfen nicht größer als 50 MB und nicht mehr als 25 Megapixel haben. Sie müssen im PNG-, JPEG- oder GIF-Format vorliegen.

Der angegebene URI muss öffentlich zugänglich sein und darf höchstens 2 KB lang sein. Der URI selbst wird mit dem Bild gespeichert und über den ImageProperties.content_uri ein.

object (Size)

Die Größe, in der das Bild im Dokument angezeigt werden soll. Diese Eigenschaft ist optional und die endgültige Größe des Bildes im Dokument wird durch die folgenden Regeln bestimmt: * Wenn weder Breite noch Höhe angegeben ist, wird eine Standardgröße des Bildes auf der Grundlage seiner Auflösung berechnet. * Wenn eine Dimension angegeben ist, wird die andere Dimension so berechnet, dass das Seitenverhältnis des Bildes erhalten bleibt. * Wenn sowohl Breite als auch Höhe angegeben sind, wird das Bild so skaliert, dass es den angegebenen Abmessungen entspricht. Das Seitenverhältnis wird dabei beibehalten.

object (Location)

Das Bild wird an einer bestimmten Stelle im Dokument eingefügt.

Das Bild muss innerhalb der Grenzen einer vorhandenen Paragraph eingefügt werden. Sie können sie beispielsweise nicht am Startindex einer Tabelle einfügen (d. h. zwischen der Tabelle und dem vorhergehenden Absatz).

Inline-Bilder können nicht innerhalb einer Fußnote oder Gleichung eingefügt werden.

object (EndOfSegmentLocation)

Der Text wird am Ende einer Kopf- oder Fußzeile oder im Textkörper eingefügt.

Inline-Bilder können nicht innerhalb einer Fußnote eingefügt werden.

{
  "rows": integer,
  "columns": integer,

  // Union field insertion_location can be only one of the following:
  "location": {
    object (Location)
  },
  "endOfSegmentLocation": {
    object (EndOfSegmentLocation)
  }
  // End of list of possible types for union field insertion_location.
}

integer

Die Anzahl der Zeilen in der Tabelle

integer

Die Anzahl der Spalten in der Tabelle.

object (Location)

Die Tabelle wird an einem bestimmten Modellindex eingefügt.

Ein Zeilenumbruchzeichen wird vor der eingefügten Tabelle eingefügt. Daher befindet sich der Startindex der Tabelle am angegebenen Positionsindex + 1.

Die Tabelle muss innerhalb der Grenzen einer vorhandenen Paragraph eingefügt werden. Sie kann beispielsweise nicht beim Startindex einer Tabelle (d.h. zwischen einer vorhandenen Tabelle und dem vorangegangenen Absatz) eingefügt werden.

Tabellen können nicht in Fußnoten oder Gleichungen eingefügt werden.

object (EndOfSegmentLocation)

Die Tabelle wird am Ende der angegebenen Kopf- oder Fußzeile oder im Dokumentkörper eingefügt. Ein Zeilenumbruchzeichen wird vor der eingefügten Tabelle eingefügt.

Tabellen können nicht in eine Fußnote eingefügt werden.

{
  "tableCellLocation": {
    object (TableCellLocation)
  },
  "insertBelow": boolean
}

object (TableCellLocation)

Die Position der Zellen der Referenztabelle, von der aus Zeilen eingefügt werden.

Über (oder unter) der Zeile, in der sich die Referenzzelle befindet, wird eine neue Zeile eingefügt. Wenn es sich bei der Referenzzelle um eine verbundene Zelle handelt, wird oberhalb (oder unterhalb) der verbundenen Zelle eine neue Zeile eingefügt.

boolean

Gibt an, ob eine neue Zeile unterhalb der Position der Referenzzelle eingefügt werden soll.

• True : Einfügen unter der Zelle.
• False : Einfügen über der Zelle.

{
  "tableStartLocation": {
    object (Location)
  },
  "rowIndex": integer,
  "columnIndex": integer
}

object (Location)

Die Stelle im Dokument, an der die Tabelle beginnt.

integer

Der nullbasierte Zeilenindex. Die zweite Zeile in der Tabelle hat beispielsweise den Zeilenindex 1.

integer

Der nullbasierte Spaltenindex. Die zweite Spalte der Tabelle hat beispielsweise einen Spaltenindex von 1.

{
  "tableCellLocation": {
    object (TableCellLocation)
  },
  "insertRight": boolean
}

object (TableCellLocation)

Die Position der Referenztabellenzelle, von der aus Spalten eingefügt werden.

Links (oder rechts) der Spalte, in der sich die Referenzzelle befindet, wird eine neue Spalte eingefügt. Wenn die Referenzzelle eine zusammengeführte Zelle ist, wird links (oder rechts) von der verbundenen Zelle eine neue Spalte eingefügt.

boolean

Gibt an, ob eine neue Spalte rechts neben der Referenzzelle eingefügt werden soll.

• True : Einfügen nach rechts.
• False : links einfügen.

{
  "tableCellLocation": {
    object (TableCellLocation)
  }
}

object (TableCellLocation)

Die Position der Referenztabellenzelle, aus der die Zeile gelöscht wird.

Die Zeile, über die sich diese Zelle erstreckt, wird gelöscht. Wenn es sich um eine zusammengeführte Zelle handelt, die sich über mehrere Zeilen erstreckt, werden alle Zeilen gelöscht, die die Zelle umfasst. Wenn nach dem Löschen keine Zeilen mehr in der Tabelle vorhanden sind, wird die gesamte Tabelle gelöscht.

{
  "tableCellLocation": {
    object (TableCellLocation)
  }
}

object (TableCellLocation)

Die Position der Referenztabellenzelle, aus der die Spalte gelöscht wird.

Die Spalte, die diese Zelle umfasst, wird gelöscht. Wenn es sich um eine zusammengeführte Zelle handelt, die sich über mehrere Spalten erstreckt, werden alle Spalten gelöscht, die die Zelle überspannt. Wenn nach dem Löschen keine Spalten mehr in der Tabelle vorhanden sind, wird die gesamte Tabelle gelöscht.

{

  // Union field insertion_location can be only one of the following:
  "location": {
    object (Location)
  },
  "endOfSegmentLocation": {
    object (EndOfSegmentLocation)
  }
  // End of list of possible types for union field insertion_location.
}

object (Location)

Fügt den Seitenumbruch an einer bestimmten Stelle im Dokument ein.

Der Seitenumbruch muss innerhalb der Grenzen eines vorhandenen Paragraph Sie kann beispielsweise nicht beim Startindex einer Tabelle eingefügt werden, also zwischen der Tabelle und ihrem vorangehenden Absatz.

Seitenumbrüche können nicht innerhalb einer Tabelle, einer Gleichung, einer Fußnote, einer Kopf- oder Fußzeile eingefügt werden. Da Seitenumbrüche nur innerhalb des Textkörpers eingefügt werden können, segment ID muss leer sein.

object (EndOfSegmentLocation)

Fügt einen Seitenumbruch am Ende des Textkörpers ein.

Seitenumbrüche können nicht in einer Fußnote, Kopf- oder Fußzeile eingefügt werden. Da Seitenumbrüche nur innerhalb des Textkörpers eingefügt werden können, segment ID muss leer sein.

{
  "objectId": string,
  "tabId": string
}

string

Die ID des zu löschenden Objekts.

string

Der Tab, auf dem sich das zu löschende Objekt befindet. Ohne Angabe wird die Anfrage auf den ersten Tab angewendet.

In einem Dokument mit einem einzelnen Tab:

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

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

In einem Dokument mit mehreren Tabs:

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

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

{
  "tableStartLocation": {
    object (Location)
  },
  "columnIndices": [
    integer
  ],
  "tableColumnProperties": {
    object (TableColumnProperties)
  },
  "fields": string
}

object (Location)

Die Stelle im Dokument, an der die Tabelle beginnt.

integer

Liste der nullbasierten Spaltenindizes, deren Eigenschaft aktualisiert werden soll. Wenn keine Indexe angegeben sind, werden alle Spalten aktualisiert.

object (TableColumnProperties)

Die Eigenschaften der Tabellenspalte, die aktualisiert werden sollen.

Wenn der Wert von tableColumnProperties#width kleiner als 5 Punkte ist, wird der Fehler "400 Bad Request" zurückgegeben.

string (FieldMask format)

Die Felder, die aktualisiert werden sollen.

Es muss mindestens ein Feld angegeben werden. Der Stammknoten tableColumnProperties ist implizit und muss nicht angegeben werden. Eine einzelne "*" kann als Kurzschreibweise für die Auflistung der einzelnen Felder verwendet werden.

Um beispielsweise die Spaltenbreite zu aktualisieren, fields bis "width".

{
  "tableCellStyle": {
    object (TableCellStyle)
  },
  "fields": string,

  // Union field cells can be only one of the following:
  "tableRange": {
    object (TableRange)
  },
  "tableStartLocation": {
    object (Location)
  }
  // End of list of possible types for union field cells.
}

object (TableCellStyle)

Der Stil, der für die Tabellenzellen festgelegt werden soll.

Wenn Sie Rahmen aktualisieren und eine Zelle einen Rahmen mit einer angrenzenden Zelle teilen, wird auch die entsprechende Rahmeneigenschaft der angrenzenden Zelle aktualisiert. Zusammengeführte und unsichtbare Grenzen werden nicht aktualisiert.

Da die Aktualisierung eines Rahmens, der von benachbarten Zellen in derselben Anfrage gemeinsam genutzt wird, Konflikte bei der Aktualisierung des Rahmens verursachen kann, werden die Rahmenaktualisierungen in der folgenden Reihenfolge angewendet:

• borderRight
• borderLeft
• borderBottom
• borderTop

string (FieldMask format)

Die Felder, die aktualisiert werden sollen.

Es muss mindestens ein Feld angegeben werden. Der Stammknoten tableCellStyle ist implizit und muss nicht angegeben werden. Eine einzelne "*" kann als Kurzschreibweise für die Auflistung der einzelnen Felder verwendet werden.

Wenn Sie beispielsweise die Hintergrundfarbe der Tabellenzelle aktualisieren möchten, legen Sie fields auf "backgroundColor" fest.

Wenn Sie eine Eigenschaft auf den Standardwert zurücksetzen möchten, fügen Sie ihren Feldnamen in die Feldmaske ein, lassen das Feld aber nicht.

object (TableRange)

Der Tabellenbereich, der die Teilmenge der Tabelle darstellt, auf die die Aktualisierungen angewendet werden.

object (Location)

Die Stelle im Dokument, an der die Tabelle beginnt. Wenn dieses Flag angegeben ist, werden die Aktualisierungen auf alle Zellen in der Tabelle angewendet.

{
  "tableCellLocation": {
    object (TableCellLocation)
  },
  "rowSpan": integer,
  "columnSpan": integer
}

object (TableCellLocation)

Die Zelle, in der der Tabellenbereich beginnt.

integer

Der Zeilenumfang des Tabellenbereichs.

integer

Die Spaltenspanne des Tabellenbereichs.

{
  "tableStartLocation": {
    object (Location)
  },
  "rowIndices": [
    integer
  ],
  "tableRowStyle": {
    object (TableRowStyle)
  },
  "fields": string
}

object (Location)

Die Stelle im Dokument, an der die Tabelle beginnt.

integer

Liste der nullbasierten Zeilenindizes, deren Stil aktualisiert werden soll. Wenn keine Indizes angegeben sind, werden alle Zeilen aktualisiert.

object (TableRowStyle)

Die Stile, die für die Zeilen festgelegt werden sollen.

string (FieldMask format)

Die Felder, die aktualisiert werden sollen.

Es muss mindestens ein Feld angegeben werden. Der Stamm tableRowStyle ist impliziert und sollte nicht angegeben werden. Eine einzelne "*" kann als Kurzschreibweise für die Auflistung der einzelnen Felder verwendet werden.

Wenn Sie beispielsweise die Mindestzeilenhöhe aktualisieren möchten, setzen Sie fields auf "minRowHeight".

{
  "imageObjectId": string,
  "uri": string,
  "imageReplaceMethod": enum (ImageReplaceMethod),
  "tabId": string
}

string

Die ID des vorhandenen Bildes, das ersetzt werden soll. Die ID kann aus der Antwort einer GET-Anfrage abgerufen werden.

string

Der URI des neuen Images.

Das Bild wird einmal beim Einfügen abgerufen und eine Kopie zur Anzeige im Dokument gespeichert. Bilder dürfen nicht größer als 50 MB und 25 Megapixel sein und müssen im PNG-, JPEG- oder GIF-Format vorliegen.

Der angegebene URI darf nicht länger als 2 KB sein. Der URI wird mit dem Bild gespeichert und über die ImageProperties.source_uri ein.

enum (ImageReplaceMethod)

Die Ersetzungsmethode.

string

Der Tab, auf dem sich das Bild befindet, das ersetzt werden soll. Ohne Angabe wird die Anfrage auf den ersten Tab angewendet.

In einem Dokument mit einem einzelnen Tab:

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

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

In einem Dokument mit mehreren Tabs:

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

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

{
  "documentStyle": {
    object (DocumentStyle)
  },
  "fields": string,
  "tabId": string
}

object (DocumentStyle)

Die Stile, die für das Dokument festgelegt werden sollen.

Bestimmte Änderungen am Dokumentstil können andere Änderungen zur Folge haben, um das Verhalten des Docs-Editors widerzuspiegeln. Weitere Informationen finden Sie in der Dokumentation zu DocumentStyle.

string (FieldMask format)

Die zu aktualisierenden Felder.

Es muss mindestens ein Feld angegeben werden. Der Stammknoten documentStyle ist implizit und muss nicht angegeben werden. Eine einzelne "*" kann als Kurzschreibweise für die Auflistung der einzelnen Felder verwendet werden.

Um beispielsweise den Hintergrund zu aktualisieren, fields bis "background".

string

Der Tab mit dem zu aktualisierenden Stil. Wenn keine Angabe gemacht wird, gilt die Anfrage für den ersten Tab.

In einem Dokument mit einem einzelnen Tab:

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

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

In einem Dokument mit mehreren Tabs:

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

• Wenn nicht angegeben, gilt der Antrag für den ersten Tab im Dokument.

{
  "tableRange": {
    object (TableRange)
  }
}

object (TableRange)

Der Tabellenbereich, der angibt, welche Zellen der Tabelle verbunden werden sollen.

Der Text in den zusammengeführten Zellen wird zusammengefügt und in der Kopfzelle des Bereichs gespeichert. Ist die Inhaltsrichtung von links nach rechts, ist dies die linke obere Zelle des Bereichs. Ist dies der Fall, ist dies die obere rechte Zelle des Bereichs.

Wenn der Bereich nicht rechteckig ist (was in einigen Fällen vorkommen kann, in denen der Bereich Zellen umfasst, die bereits verbunden sind oder die Tabelle nicht rechteckig ist), wird der Fehler 400 für die fehlerhafte Anforderung zurückgegeben.

{
  "tableRange": {
    object (TableRange)
  }
}

object (TableRange)

Der Tabellenbereich, der angibt, welche Zellen der Tabelle getrennt werden sollen.

Der Zellenverbund für alle Zellen in diesem Bereich wird aufgehoben. Bereits zusammengeführte Zellen sind davon nicht betroffen. Wenn der Bereich keine zusammengeführten Zellen enthält, geschieht durch die Anfrage nichts.

Wenn sich in einer der verbundenen Zellen Text befindet, bleibt der Text im Kopfbereich. Zelle des resultierenden Blocks von nicht verbundenen Zellen. Die Kopfzelle ist die linke obere Zelle, wenn die Inhaltsrichtung von links nach rechts ist, andernfalls die rechte obere Zelle.

{
  "type": enum (HeaderFooterType),
  "sectionBreakLocation": {
    object (Location)
  }
}

enum (HeaderFooterType)

Der zu erstellende Headertyp.

object (Location)

Der Standort des SectionBreak mit dem der Abschnitt beginnt, zu dem diese Kopfzeile gehören soll. Wenn „sectionBreakLocation“ nicht festgelegt ist oder auf den ersten Abschnittswechsel im Dokumenttext verweist, wird die Kopfzeile auf den DocumentStyle

{
  "type": enum (HeaderFooterType),
  "sectionBreakLocation": {
    object (Location)
  }
}

enum (HeaderFooterType)

Der zu erstellende Fußzeilentyp.

object (Location)

Der Speicherort der SectionBreak unmittelbar vor dem Abschnitt, zu dessen SectionStyle diese Fußzeile gehören soll. Wenn diese Richtlinie nicht konfiguriert ist oder sich auf den ersten Abschnittswechsel im Dokument bezieht, wird die Fußzeile auf den Dokumentstil angewendet.

{

  // Union field footnote_reference_location can be only one of the following:
  "location": {
    object (Location)
  },
  "endOfSegmentLocation": {
    object (EndOfSegmentLocation)
  }
  // End of list of possible types for union field footnote_reference_location.
}

object (Location)

Der Verweis auf die Fußnote wird an einer bestimmten Stelle im Dokument eingefügt.

Der Verweis auf die Fußnote muss innerhalb der Grenzen einer vorhandenen Paragraph eingefügt werden. Sie kann beispielsweise nicht beim Startindex einer Tabelle eingefügt werden, also zwischen der Tabelle und ihrem vorangehenden Absatz.

Fußnotenverweise können nicht in Gleichungen, Kopf- oder Fußzeilen oder Fußnoten eingefügt werden. Da Fußnoten nur im Textkörper eingefügt werden können, muss das Feld segment ID leer sein.

object (EndOfSegmentLocation)

Fügt den Fußnotenverweis am Ende des Dokumenttexts ein.

Fußnotenverweise können nicht in eine Kopf-, Fuß- oder Fußnote eingefügt werden. Da Fußnotenverweise nur in den Textkörper eingefügt werden können, segment ID muss leer sein.

{
  "tabsCriteria": {
    object (TabsCriteria)
  },

  // Union field replacement_content can be only one of the following:
  "text": string
  // End of list of possible types for union field replacement_content.

  // Union field named_range_reference can be only one of the following:
  "namedRangeId": string,
  "namedRangeName": string
  // End of list of possible types for union field named_range_reference.
}

object (TabsCriteria)

Optional. Die Kriterien, mit denen festgelegt wird, auf welchen Tabs die Ersetzung erfolgt. Wenn keine Angabe gemacht wird, wird die Ersetzung auf alle Tabs angewendet.

In einem Dokument mit einem einzelnen Tab:

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

• Wenn Sie diese Option weglassen, wird der Ersatz auf den einzelnen Tab angewendet.

In einem Dokument mit mehreren Tabs:

• Wenn angegeben, wird der Ersatz auf die angegebenen Tabs angewendet.

• Wenn keine Angabe gemacht wird, gilt die Ersetzung für alle Tabs.

string

Ersetzt den Inhalt der angegebenen benannten Bereiche durch den angegebenen Text.

string

Die ID des benannten Bereichs, dessen Inhalt ersetzt werden soll.

Wenn kein benannter Bereich mit der angegebenen ID vorhanden ist, wird der Fehler 400 ungültig.

string

Der Name der NamedRanges, deren Inhalt ersetzt werden soll.

Wenn es mehrere named ranges mit dem angegebenen Namen gibt, wird der Inhalt jedes Elements ersetzt. Wenn es keine benannten Bereiche mit dem angegebenen Namen gibt, wird die Anfrage nicht ausgeführt.

{
  "range": {
    object (Range)
  },
  "sectionStyle": {
    object (SectionStyle)
  },
  "fields": string
}

object (Range)

Der Bereich, der sich mit den zu formatierenden Abschnitten überschneidet.

Da Abschnittsübergänge nur im Textkörper eingefügt werden können, muss das Feld segment ID leer sein.

object (SectionStyle)

Die Stile, die für den Abschnitt festgelegt werden sollen.

Bestimmte Änderungen am Abschnittsstil können andere Änderungen zur Folge haben, die dem Verhalten des Docs-Editors entsprechen. Weitere Informationen finden Sie in der Dokumentation zu SectionStyle .

string (FieldMask format)

Die Felder, die aktualisiert werden sollen.

Es muss mindestens ein Feld angegeben werden. Der Stammknoten sectionStyle ist implizit und muss nicht angegeben werden. Ein einzelnes "*" kann als Kurzschreibweise für die Auflistung aller Felder verwendet werden.

Wenn Sie beispielsweise den linken Rand aktualisieren möchten, setzen Sie fields auf "marginLeft".

{
  "sectionType": enum (SectionType),

  // Union field insertion_location can be only one of the following:
  "location": {
    object (Location)
  },
  "endOfSegmentLocation": {
    object (EndOfSegmentLocation)
  }
  // End of list of possible types for union field insertion_location.
}

enum (SectionType)

Der Typ des einzufügenden Abschnitts.

object (Location)

Fügt bei einem bestimmten Index im Dokument einen Zeilenumbruch und einen Abschnittswechsel ein.

Der Abschnittswechsel muss innerhalb der Grenzen einer vorhandenen Paragraph eingefügt werden. Sie können sie beispielsweise nicht am Startindex einer Tabelle einfügen (d. h. zwischen der Tabelle und dem vorhergehenden Absatz).

Abschnittswechsel können nicht in Tabellen, Gleichungen, Fußnoten, Kopf- oder Fußzeilen eingefügt werden. Da Abschnittsübergänge nur im Textkörper eingefügt werden können, muss das Feld segment ID leer sein.

object (EndOfSegmentLocation)

Fügt am Ende des Dokumenttexts einen Zeilenumbruch und einen Abschnittswechsel ein.

Abschnittswechsel können nicht innerhalb einer Fußnote, Kopf- oder Fußzeile eingefügt werden. Da Abschnittswechsel nur innerhalb des Textkörpers eingefügt werden können, segment ID muss leer sein.

{
  "headerId": string,
  "tabId": string
}

string

Die ID des zu löschenden Headers. Wenn dieser Abschnitt auf DocumentStyle definiert ist, wird der Verweis auf diesen Abschnitt entfernt. Für den ersten Abschnitt des Dokuments gibt es dann keine Überschrift dieses Typs. Wenn dieser Header in einem SectionStyle, wird der Verweis auf diese Überschrift entfernt und die Überschrift dieses Typs wird jetzt aus dem vorherigen Abschnitt fortgesetzt.

string

Der Tab mit der zu löschenden Kopfzeile. Ohne Angabe wird die Anfrage auf den ersten Tab angewendet.

In einem Dokument mit einem einzelnen Tab:

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

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

In einem Dokument mit mehreren Tabs:

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

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

{
  "footerId": string,
  "tabId": string
}

string

Die ID der zu löschenden Fußzeile. Wenn diese Fußzeile in DocumentStyle – der Verweis auf diese Fußzeile wird entfernt, sodass für den ersten Abschnitt des Dokuments keine Fußzeile dieses Typs vorhanden ist. Wenn diese Fußzeile auf einer SectionStyle definiert ist, wird der Verweis auf diese Fußzeile entfernt und die Fußzeile dieses Typs wird jetzt im vorherigen Abschnitt fortgesetzt.

string

Der Tab mit der zu löschenden Fußzeile. Wird kein Wert angegeben, wird die Anfrage auf den ersten Tab angewendet.

In einem Dokument mit einem einzelnen Tab:

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

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

In einem Dokument mit mehreren Tabs:

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

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

{
  "tableStartLocation": {
    object (Location)
  },
  "pinnedHeaderRowsCount": integer
}

object (Location)

Die Stelle im Dokument, an der die Tabelle beginnt.

integer

Die Anzahl der anzupinnenden Tabellenzeilen. „0“ bedeutet, dass alle Zeilen nicht angepinnt sind.