Requests

Anfrage

Eine einzelne Aktualisierung, die auf ein Dokument angewendet werden soll.

JSON-Darstellung 
{

  "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)
  },
  "addDocumentTab": {
    object (AddDocumentTabRequest)
  },
  "deleteTab": {
    object (DeleteTabRequest)
  },
  "updateDocumentTabProperties": {
    object (UpdateDocumentTabPropertiesRequest)
  },
  "insertPerson": {
    object (InsertPersonRequest)
  },
  "updateNamedStyle": {
    object (UpdateNamedStyleRequest)
  },
  "insertRichLink": {
    object (InsertRichLinkRequest)
  },
  "insertDate": {
    object (InsertDateRequest)
  },
  "insertComment": {
    object (InsertCommentRequest)
  },
  "addCommentReply": {
    object (AddCommentReplyRequest)
  },
  "updateCommentPost": {
    object (UpdateCommentPostRequest)
  },
  "deleteComment": {
    object (DeleteCommentRequest)
  },
  "deleteCommentReply": {
    object (DeleteCommentReplyRequest)
  },
  "acceptSuggestion": {
    object (AcceptSuggestionRequest)
  },
  "rejectSuggestion": {
    object (RejectSuggestionRequest)
  },
  "deleteSuggestion": {
    object (DeleteSuggestionRequest)
  }
}
Felder
Die spezifische Anfrage, die angewendet werden soll. Genau ein Feld ist erforderlich. Im Folgenden finden Sie eine Liste von sich gegenseitig ausschließenden Feldern. In einer Antwort wird höchstens eines der Felder festgelegt:
replaceAllText

object (ReplaceAllTextRequest)

Ersetzt alle Vorkommen des angegebenen Texts.

insertText

object (InsertTextRequest)

Fügt Text an der angegebenen Stelle ein.

updateTextStyle

object (UpdateTextStyleRequest)

Aktualisiert den Textstil im angegebenen Bereich.

createParagraphBullets

object (CreateParagraphBulletsRequest)

Erstellt Aufzählungszeichen für Absätze.

deleteParagraphBullets

object (DeleteParagraphBulletsRequest)

Entfernt Aufzählungszeichen aus Absätzen.

createNamedRange

object (CreateNamedRangeRequest)

Erstellt einen benannten Bereich.

deleteNamedRange

object (DeleteNamedRangeRequest)

Löscht einen benannten Bereich.

updateParagraphStyle

object (UpdateParagraphStyleRequest)

Aktualisiert den Absatzstil im angegebenen Bereich.

deleteContentRange

object (DeleteContentRangeRequest)

Löscht Inhalte aus dem Dokument.

insertInlineImage

object (InsertInlineImageRequest)

Fügt ein Inlinebild an der angegebenen Stelle ein.

insertTable

object (InsertTableRequest)

Fügt eine Tabelle an der angegebenen Stelle ein.

insertTableRow

object (InsertTableRowRequest)

Fügt eine leere Zeile in eine Tabelle ein.

insertTableColumn

object (InsertTableColumnRequest)

Fügt eine leere Spalte in eine Tabelle ein.

deleteTableRow

object (DeleteTableRowRequest)

Löscht eine Zeile aus einer Tabelle.

deleteTableColumn

object (DeleteTableColumnRequest)

Löscht eine Spalte aus einer Tabelle.

insertPageBreak

object (InsertPageBreakRequest)

Fügt an der angegebenen Stelle einen Seitenumbruch ein.

deletePositionedObject

object (DeletePositionedObjectRequest)

Löscht ein positioniertes Objekt aus dem Dokument.

updateTableColumnProperties

object (UpdateTableColumnPropertiesRequest)

Aktualisiert die Eigenschaften von Spalten in einer Tabelle.

updateTableCellStyle

object (UpdateTableCellStyleRequest)

Aktualisiert den Stil von Tabellenzellen.

updateTableRowStyle

object (UpdateTableRowStyleRequest)

Aktualisiert den Zeilenstil in einer Tabelle.

replaceImage

object (ReplaceImageRequest)

Ersetzt ein Bild im Dokument.

updateDocumentStyle

object (UpdateDocumentStyleRequest)

Aktualisiert den Stil des Dokuments.

mergeTableCells

object (MergeTableCellsRequest)

Zellen in einer Tabelle werden zusammengeführt.

unmergeTableCells

object (UnmergeTableCellsRequest)

Hebt die Zusammenführung von Zellen in einer Tabelle auf.

createHeader

object (CreateHeaderRequest)

Erstellt eine Kopfzeile.

createFootnote

object (CreateFootnoteRequest)

Erstellt eine Fußnote.

replaceNamedRangeContent

object (ReplaceNamedRangeContentRequest)

Ersetzt den Inhalt eines benannten Bereichs.

updateSectionStyle

object (UpdateSectionStyleRequest)

Aktualisiert den Abschnittsstil des angegebenen Bereichs.

insertSectionBreak

object (InsertSectionBreakRequest)

Fügt an der angegebenen Stelle einen Abschnittsumbruch ein.

deleteHeader

object (DeleteHeaderRequest)

Löscht eine Kopfzeile aus dem Dokument.

pinTableHeaderRows

object (PinTableHeaderRowsRequest)

Aktualisiert die Anzahl der fixierten Kopfzeilen in einer Tabelle.

addDocumentTab

object (AddDocumentTabRequest)

Fügt einen Dokument-Tab hinzu.

deleteTab

object (DeleteTabRequest)

Löscht einen Dokument-Tab.

updateDocumentTabProperties

object (UpdateDocumentTabPropertiesRequest)

Aktualisiert die Attribute eines Dokument-Tabs.

insertPerson

object (InsertPersonRequest)

Fügt eine Erwähnung einer Person ein.

updateNamedStyle

object (UpdateNamedStyleRequest)

Aktualisiert einen benannten Stil.

insertDate

object (InsertDateRequest)

Fügt ein Datum ein.

insertComment

object (InsertCommentRequest)

Fügt eine CommentThread in das Dokument ein.

addCommentReply

object (AddCommentReplyRequest)

Fügt eine Antwort auf eine CommentThread oder SuggestionThread hinzu.

updateCommentPost

object (UpdateCommentPostRequest)

Aktualisiert einen vorhandenen Beitrag (Hauptbeitrag oder Antwort) einer CommentThread oder SuggestionThread.

deleteComment

object (DeleteCommentRequest)

Löscht eine CommentThread.

deleteCommentReply

object (DeleteCommentReplyRequest)

Löscht eine Antwort Post aus einem CommentThread oder SuggestionThread.

acceptSuggestion

object (AcceptSuggestionRequest)

Nimmt einen Vorschlag an.

rejectSuggestion

object (RejectSuggestionRequest)

Lehnt einen Vorschlag ab.

deleteSuggestion

object (DeleteSuggestionRequest)

Löscht einen Vorschlag.

Ende der sich gegenseitig ausschließenden Felder.

ReplaceAllTextRequest

Ersetzt alle Textinstanzen, die einem Kriterium entsprechen, durch replace text.

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

  "containsText": {
    object (SubstringMatchCriteria)
  }
}
Felder
replaceText

string

Der Text, der den übereinstimmenden Text ersetzt.

tabsCriteria

object (TabsCriteria)

Optional. Die Kriterien, mit denen angegeben wird, auf welchen Tabs der Ersatz erfolgt.

Wenn nichts angegeben ist, gilt der Ersatz für alle Tabs.

In einem Dokument mit nur einem Tab:

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

  • Wenn nichts angegeben ist, wird der Platzhalter auf dem Tab „Singular“ ersetzt.

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

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

  • Wenn nichts angegeben ist, gilt der Ersatz für alle Tabs.

Die Kriterien, die zum Abgleichen des zu ersetzenden Texts verwendet wurden. Im Folgenden finden Sie eine Liste von sich gegenseitig ausschließenden Feldern. In einer Antwort wird höchstens eines der Felder festgelegt:
containsText

object (SubstringMatchCriteria)

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

Ende der sich gegenseitig ausschließenden Felder.

SubstringMatchCriteria

Ein Kriterium, das mit einem bestimmten Textstring im Dokument übereinstimmt.

JSON-Darstellung 
{
  "text": string,
  "matchCase": boolean,
  "searchByRegex": boolean
}
Felder
text

string

Der Text, nach dem im Dokument gesucht werden soll.

matchCase

boolean

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

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

boolean

Optional. „Wahr“, wenn der Suchwert als regulärer Ausdruck behandelt werden soll. Alle umgekehrten Schrägstriche im Muster müssen maskiert werden.

  • True : Der Suchtext wird als regulärer Ausdruck behandelt.
  • False : Der Suchtext wird als Teilstring für den Abgleich behandelt.

TabsCriteria

Ein Kriterium, das angibt, auf welchen Tabs eine Anfrage ausgeführt wird.

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

string

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

InsertTextRequest

Fügt Text an der angegebenen Stelle ein.

JSON-Darstellung 
{
  "text": string,

  "location": {
    object (Location)
  },
  "endOfSegmentLocation": {
    object (EndOfSegmentLocation)
  }
}
Felder
text

string

Der einzufügende Text.

Wenn Sie ein Zeilenumbruchzeichen einfügen, wird implizit ein neues Paragraph an dieser Stelle erstellt. 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 festgelegt. Dabei wird in der Regel der Stil des benachbarten Textes beibehalten. In den meisten Fällen entspricht die Textformatierung des eingefügten Texts dem Text unmittelbar 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.

Die Stelle, an der der Text eingefügt wird. Im Folgenden finden Sie eine Liste von sich gegenseitig ausschließenden Feldern. In einer Antwort wird höchstens eines der Felder festgelegt:
location

object (Location)

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

Der Text muss innerhalb der Grenzen eines vorhandenen Paragraph eingefügt werden. So kann beispielsweise kein Text am Startindex einer Tabelle eingefügt werden, also zwischen der Tabelle und dem vorherigen Absatz. Der Text muss in den vorhergehenden Absatz eingefügt werden.

endOfSegmentLocation

object (EndOfSegmentLocation)

Fügt den Text am Ende einer Kopf- oder Fußzeile, einer Fußnote oder des Dokumenttexts ein.

Ende der sich gegenseitig ausschließenden Felder.

Standort

Eine bestimmte Stelle im Dokument.

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

string

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

index

integer

Der nullbasierte Index in UTF-16-Codeeinheiten.

Der Index bezieht sich auf den Anfang des Segments, das durch segmentId angegeben wird.

tabId

string

Der Tab, auf dem sich der Standort befindet. Wird dieser Parameter weggelassen, wird die Anfrage auf den ersten Tab angewendet.

In einem Dokument mit nur einem Tab:

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

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

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

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

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

EndOfSegmentLocation

Am Ende eines Textkörpers, einer Kopfzeile, einer Fußzeile oder einer Fußnote. Die Position befindet sich unmittelbar vor dem letzten Zeilenumbruch im Dokumentsegment.

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

string

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

tabId

string

Der Tab, auf dem sich der Standort befindet. Wird dieser Parameter weggelassen, wird die Anfrage auf den ersten Tab angewendet.

In einem Dokument mit nur einem Tab:

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

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

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

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

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

UpdateTextStyleRequest

Aktualisieren Sie die Formatierung von Text.

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

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

object (TextStyle)

Die auf den Text anzuwendenden Formatierungen.

Wenn der Wert für einen bestimmten Stil mit dem des übergeordneten Elements übereinstimmt, wird der Stil auf „inherit“ (erben) gesetzt.

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.

fields

string (FieldMask format)

Die Felder, die aktualisiert werden sollen.

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

Wenn Sie beispielsweise den Textstil auf „fett“ aktualisieren möchten, legen Sie fields auf "bold" fest.

Wenn Sie ein Attribut auf den Standardwert zurücksetzen möchten, nehmen Sie seinen Feldnamen in die Feldmaske auf, lassen Sie das Feld selbst aber nicht festgelegt.

Der Typ des Bereichs, in dem der Textstil aktualisiert wird. Im Folgenden finden Sie eine Liste von sich gegenseitig ausschließenden Feldern. In einer Antwort wird höchstens eines der Felder festgelegt:
range

object (Range)

Der Bereich des zu formatierenden Texts.

Der Bereich kann erweitert werden, um angrenzende Zeilenumbrüche einzuschließen.

Wenn der Bereich einen Absatz einer Liste vollständig enthält, wird auch das Aufzählungszeichen des Absatzes mit dem entsprechenden Textstil aktualisiert.

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

Ende der sich gegenseitig ausschließenden Felder.

CreateParagraphBulletsRequest

Erstellt Aufzählungszeichen für alle Absätze, die sich mit dem angegebenen Bereich überschneiden.

Die Verschachtelungsebene jedes Absatzes wird durch Zählen der führenden Tabulatoren vor dem jeweiligen Absatz bestimmt. Um überflüssige Leerzeichen zwischen dem Aufzählungszeichen und dem entsprechenden Absatz zu vermeiden, werden diese führenden Tabulatoren durch diese Anfrage entfernt. Dadurch können sich die Indexe von Teilen des Texts ändern.

Wenn der Absatz unmittelbar vor den aktualisierten Absätzen in einer Liste mit einer passenden Voreinstellung steht, werden die aktualisierten Absätze dieser Liste hinzugefügt.

JSON-Darstellung 
{
  "range": {
    object (Range)
  },
  "bulletPreset": enum (BulletGlyphPreset)
}
Felder
range

object (Range)

Der Bereich, auf den die Aufzählungszeichen-Voreinstellung angewendet werden soll.

bulletPreset

enum (BulletGlyphPreset)

Die Arten von Aufzählungszeichen, die verwendet werden sollen.

BulletGlyphPreset

Voreingestellte Muster für Aufzählungszeichen in Listen.

Für diese Muster werden die folgenden Arten von Aufzählungszeichen verwendet:

  • ARROW : Ein Pfeil, der dem Unicode-Codepunkt U+2794 entspricht
  • ARROW3D : Ein Pfeil mit 3D-Schattierung, der dem Unicode-Codepunkt U+27a2 entspricht
  • CHECKBOX : Ein leeres Quadrat, das dem Unicode-Codepunkt U+274f entspricht
  • CIRCLE : Ein leerer Kreis, der dem Unicode-Codepunkt U+25cb entspricht
  • DIAMOND : Eine ausgefüllte Raute, die dem Unicode-Codepunkt U+25c6 entspricht
  • DIAMONDX : Eine Raute mit einem „x“, entsprechend dem Unicode-Codepunkt U+2756
  • HOLLOWDIAMOND : Eine leere Raute, die dem Unicode-Codepunkt U+25c7 entspricht
  • DISC : Ein ausgefüllter Kreis, der dem Unicode-Codepunkt U+25cf entspricht
  • SQUARE : Ein ausgefülltes Quadrat, das dem Unicode-Codepunkt U+25a0 entspricht
  • STAR : Ein Stern, der dem Unicode-Codepunkt U+2605 entspricht
  • ALPHA : Ein Kleinbuchstabe wie „a“, „b“ oder „c“.
  • UPPERALPHA : Ein Großbuchstabe, z. B. „A“, „B“ oder „C“.
  • DECIMAL : Eine Zahl wie „1“, „2“ oder „3“.
  • ZERODECIMAL : Eine Zahl, bei der einstellige Zahlen mit einer Null beginnen, z. B. „01“, „02“ oder „03“. Zahlen mit mehr als einer Ziffer wird keine Null vorangestellt.
  • ROMAN : Eine römische Ziffer in Kleinbuchstaben, z. B. „i“, „ii“ oder „iii“.
  • UPPERROMAN : Eine römische Ziffer in Großbuchstaben, z. B. „I“, „II“ oder „III“.
  • LEFTTRIANGLE : Ein Dreieck, das nach links zeigt und dem Unicode-Codepunkt U+25c4 entspricht
Enums
BULLET_GLYPH_PRESET_UNSPECIFIED Die Voreinstellung für das Aufzählungszeichen ist nicht angegeben.
BULLET_DISC_CIRCLE_SQUARE Eine Aufzählungsliste mit den Aufzählungszeichen DISC, CIRCLE und SQUARE für die ersten drei Verschachtelungsebenen.
BULLET_DIAMONDX_ARROW3D_SQUARE Eine Aufzählungsliste mit den Aufzählungszeichen DIAMONDX, ARROW3D und SQUARE für die ersten drei Verschachtelungsebenen.
BULLET_CHECKBOX Eine Aufzählungsliste mit CHECKBOX Aufzählungszeichen für alle Verschachtelungsebenen der Liste.
BULLET_ARROW_DIAMOND_DISC Eine Aufzählungsliste mit den Aufzählungszeichen ARROW, DIAMOND und DISC für die ersten drei Verschachtelungsebenen.
BULLET_STAR_CIRCLE_SQUARE Eine Aufzählungsliste mit den Aufzählungszeichen STAR, CIRCLE und SQUARE für die ersten drei Verschachtelungsebenen.
BULLET_ARROW3D_CIRCLE_SQUARE Eine Aufzählungsliste mit den Aufzählungszeichen ARROW3D, CIRCLE und SQUARE für die ersten drei Verschachtelungsebenen.
BULLET_LEFTTRIANGLE_DIAMOND_DISC Eine Aufzählungsliste mit den Aufzählungszeichen LEFTTRIANGLE, DIAMOND und DISC für die ersten drei Verschachtelungsebenen.
BULLET_DIAMONDX_HOLLOWDIAMOND_SQUARE Eine Aufzählungsliste mit den Aufzählungszeichen DIAMONDX, HOLLOWDIAMOND und SQUARE für die ersten drei Verschachtelungsebenen.
BULLET_DIAMOND_CIRCLE_SQUARE Eine Aufzählungsliste mit den Aufzählungszeichen DIAMOND, CIRCLE und SQUARE für die ersten drei Verschachtelungsebenen.
NUMBERED_DECIMAL_ALPHA_ROMAN Eine nummerierte Liste mit den numerischen Glyphen DECIMAL, ALPHA und ROMAN für die ersten drei Verschachtelungsebenen der Liste, gefolgt von Punkten.
NUMBERED_DECIMAL_ALPHA_ROMAN_PARENS Eine nummerierte Liste mit den numerischen Glyphen DECIMAL, ALPHA und ROMAN für die ersten drei Verschachtelungsebenen der Liste, gefolgt von einer schließenden Klammer.
NUMBERED_DECIMAL_NESTED Eine nummerierte Liste mit DECIMAL numerischen Glyphen, die durch Punkte getrennt sind. Jede Verschachtelungsebene verwendet die Glyphe der vorherigen Verschachtelungsebene als Präfix. Beispiel: „1.“ '1.1.', '2.', „2.2“.
NUMBERED_UPPERALPHA_ALPHA_ROMAN Eine nummerierte Liste mit den numerischen Glyphen UPPERALPHA, ALPHA und ROMAN für die ersten drei Verschachtelungsebenen der Liste, gefolgt von Punkten.
NUMBERED_UPPERROMAN_UPPERALPHA_DECIMAL Eine nummerierte Liste mit den numerischen Glyphen UPPERROMAN, UPPERALPHA und DECIMAL für die ersten drei Verschachtelungsebenen der Liste, gefolgt von Punkten.
NUMBERED_ZERODECIMAL_ALPHA_ROMAN Eine nummerierte Liste mit den numerischen Glyphen ZERODECIMAL, ALPHA und ROMAN für die ersten drei Verschachtelungsebenen der Liste, gefolgt von Punkten.

DeleteParagraphBulletsRequest

Löscht Aufzählungszeichen aus allen Absätzen, die sich mit dem angegebenen Bereich überschneiden.

Die Verschachtelungsebene jedes Absatzes wird visuell beibehalten, indem am Anfang des entsprechenden Absatzes ein Einzug hinzugefügt wird.

JSON-Darstellung 
{
  "range": {
    object (Range)
  }
}
Felder
range

object (Range)

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

CreateNamedRangeRequest

Erstellt einen NamedRange, der auf den angegebenen Bereich verweist.

JSON-Darstellung 
{
  "name": string,
  "range": {
    object (Range)
  }
}
Felder
name

string

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

Namen müssen mindestens 1 Zeichen und dürfen höchstens 256 Zeichen lang sein (gemessen in UTF-16-Codeeinheiten).

range

object (Range)

Der Bereich, auf den der Name angewendet werden soll.

DeleteNamedRangeRequest

Löscht eine NamedRange.

JSON-Darstellung 
{
  "tabsCriteria": {
    object (TabsCriteria)
  },

  "namedRangeId": string,
  "name": string
}
Felder
tabsCriteria

object (TabsCriteria)

Optional. Die Kriterien, mit denen angegeben wird, auf welchen Tabellenblättern der Bereich gelöscht werden soll. Wenn es weggelassen wird, wird der Bereich in allen Tabs gelöscht.

In einem Dokument mit nur einem Tab:

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

  • Wenn nichts angegeben ist, wird der Bereich im einzelnen Tab gelöscht.

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

  • Wenn angegeben, wird der Bereich in den angegebenen Tabs gelöscht.

  • Wenn nichts angegeben ist, wird der Bereich auf allen Tabs gelöscht.

Der Wert, der bestimmt, welcher Bereich oder welche Bereiche gelöscht werden sollen. Genau eines muss festgelegt werden. Im Folgenden finden Sie eine Liste von sich gegenseitig ausschließenden Feldern. In einer Antwort wird höchstens eines der Felder festgelegt:
namedRangeId

string

Die ID des zu löschenden benannten Bereichs.

name

string

Der Name des oder der zu löschenden Bereiche. Alle benannten Bereiche mit dem angegebenen Namen werden gelöscht.

Ende der sich gegenseitig ausschließenden Felder.

UpdateParagraphStyleRequest

Aktualisiert die Formatierung aller Absätze, die sich mit dem angegebenen Bereich überschneiden.

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

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

object (ParagraphStyle)

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

Bestimmte Änderungen am Absatzstil können andere Änderungen nach sich ziehen, um das Verhalten des Docs-Editors widerzuspiegeln. Weitere Informationen finden Sie in der Dokumentation zu ParagraphStyle.

fields

string (FieldMask format)

Die Felder, die aktualisiert werden sollen.

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

Wenn Sie beispielsweise die Ausrichtungseigenschaft des Absatzformats aktualisieren möchten, legen Sie fields auf "alignment" fest.

Wenn Sie ein Attribut auf den Standardwert zurücksetzen möchten, nehmen Sie seinen Feldnamen in die Feldmaske auf, lassen Sie das Feld selbst aber nicht festgelegt.

Der Typ des Bereichs, in dem der Absatzstil aktualisiert wird. Im Folgenden finden Sie eine Liste von sich gegenseitig ausschließenden Feldern. In einer Antwort wird höchstens eines der Felder festgelegt:
range

object (Range)

Der Bereich, der sich mit den zu formatierenden Absätzen überschneidet.

Ende der sich gegenseitig ausschließenden Felder.

DeleteContentRangeRequest

Löscht Inhalte aus dem Dokument.

JSON-Darstellung 
{
  "range": {
    object (Range)
  }
}
Felder
range

object (Range)

Der Bereich der zu löschenden Inhalte.

Wenn Sie Text löschen, der über eine Absatzgrenze hinausgeht, kann dies zu Änderungen an Absatzformatierungen, Listen, positionierten Objekten und Lesezeichen führen, da die beiden Absätze zusammengeführt werden.

Wenn Sie versuchen, bestimmte Bereiche zu löschen, kann dies zu einer ungültigen Dokumentstruktur führen. In diesem Fall wird der Fehler „400 Falsche Anfrage“ zurückgegeben.

Beispiele für ungültige Löschanfragen:

InsertInlineImageRequest

Fügt ein InlineObject mit einem Bild an der angegebenen Position ein.

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

  "location": {
    object (Location)
  },
  "endOfSegmentLocation": {
    object (EndOfSegmentLocation)
  }
}
Felder
uri

string

Der Bild-URI.

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

Der angegebene URI muss öffentlich zugänglich sein und darf maximal 2 KB lang sein. Der URI selbst wird mit dem Bild gespeichert und über das Feld ImageProperties.content_uri verfügbar gemacht.

objectSize

object (Size)

Die Größe, in der das Bild im Dokument angezeigt werden soll. Dieses Attribut ist optional. Die endgültige Größe des Bildes im Dokument wird anhand der folgenden Regeln bestimmt: * Wenn weder Breite noch Höhe angegeben sind, wird eine Standardgröße des Bildes basierend auf seiner Auflösung berechnet. * Wenn eine Dimension angegeben ist, wird die andere berechnet, um das Seitenverhältnis des Bildes beizubehalten. * Wenn sowohl Breite als auch Höhe angegeben sind, wird das Bild so skaliert, dass es in die angegebenen Abmessungen passt, wobei das Seitenverhältnis beibehalten wird.

Der Ort, an dem das Bild eingefügt wird. Im Folgenden finden Sie eine Liste von sich gegenseitig ausschließenden Feldern. In einer Antwort wird höchstens eines der Felder festgelegt:
location

object (Location)

Fügt das Bild an einer bestimmten Stelle im Dokument ein.

Das Bild muss innerhalb der Grenzen eines vorhandenen Paragraph eingefügt werden. Sie kann beispielsweise nicht am Startindex einer Tabelle eingefügt werden, also zwischen der Tabelle und dem vorherigen Absatz.

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

endOfSegmentLocation

object (EndOfSegmentLocation)

Fügt den Text am Ende einer Kopf- oder Fußzeile oder des Dokumentinhalts ein.

Inline-Bilder können nicht in eine Fußnote eingefügt werden.

Ende der sich gegenseitig ausschließenden Felder.

InsertTableRequest

Fügt eine Tabelle an der angegebenen Stelle ein.

Vor der eingefügten Tabelle wird ein Zeilenumbruch eingefügt.

JSON-Darstellung 
{
  "rows": integer,
  "columns": integer,

  "location": {
    object (Location)
  },
  "endOfSegmentLocation": {
    object (EndOfSegmentLocation)
  }
}
Felder
rows

integer

Die Anzahl der Zeilen in der Tabelle

columns

integer

Die Anzahl der Spalten in der Tabelle.

Die Position, an der die Tabelle eingefügt wird. Im Folgenden finden Sie eine Liste von sich gegenseitig ausschließenden Feldern. In einer Antwort wird höchstens eines der Felder festgelegt:
location

object (Location)

Fügt die Tabelle an einem bestimmten Modellindex ein.

Vor der eingefügten Tabelle wird ein Zeilenumbruchzeichen eingefügt. Der Startindex der Tabelle befindet sich daher am angegebenen Index des Speicherorts + 1.

Die Tabelle muss innerhalb der Grenzen eines vorhandenen Paragraph eingefügt werden. Sie kann beispielsweise nicht am Startindex einer Tabelle eingefügt werden, also zwischen einer vorhandenen Tabelle und dem vorherigen Absatz.

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

endOfSegmentLocation

object (EndOfSegmentLocation)

Fügt die Tabelle am Ende der angegebenen Kopf- oder Fußzeile oder des Dokumentinhalts ein. Vor der eingefügten Tabelle wird ein Zeilenumbruch eingefügt.

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

Ende der sich gegenseitig ausschließenden Felder.

InsertTableRowRequest

Fügt eine leere Zeile in eine Tabelle ein.

JSON-Darstellung 
{
  "tableCellLocation": {
    object (TableCellLocation)
  },
  "insertBelow": boolean
}
Felder
tableCellLocation

object (TableCellLocation)

Die Position der Referenztabellenzelle, ab der Zeilen eingefügt werden.

Eine neue Zeile wird über (oder unter) der Zeile eingefügt, in der sich die Referenzzelle befindet. Wenn die Referenzzelle eine zusammengeführte Zelle ist, wird eine neue Zeile über (oder unter) der zusammengeführten Zelle eingefügt.

insertBelow

boolean

Gibt an, ob eine neue Zeile unter der Referenzzellenposition eingefügt werden soll.

  • True : unter der Zelle einfügen.
  • False : Über der Zelle einfügen.

TableCellLocation

Position einer einzelnen Zelle in einer Tabelle.

JSON-Darstellung 
{
  "tableStartLocation": {
    object (Location)
  },
  "rowIndex": integer,
  "columnIndex": integer
}
Felder
tableStartLocation

object (Location)

Die Position, an der die Tabelle im Dokument beginnt.

rowIndex

integer

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

columnIndex

integer

Der nullbasierte Spaltenindex. Die zweite Spalte in der Tabelle hat beispielsweise den Spaltenindex 1.

InsertTableColumnRequest

Fügt eine leere Spalte in eine Tabelle ein.

JSON-Darstellung 
{
  "tableCellLocation": {
    object (TableCellLocation)
  },
  "insertRight": boolean
}
Felder
tableCellLocation

object (TableCellLocation)

Die Position der Referenztabellenzelle, ab der Spalten eingefügt werden.

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

insertRight

boolean

Gibt an, ob die neue Spalte rechts von der Referenzzelle eingefügt werden soll.

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

DeleteTableRowRequest

Löscht eine Zeile aus einer Tabelle.

JSON-Darstellung 
{
  "tableCellLocation": {
    object (TableCellLocation)
  }
}
Felder
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, über die sich die Zelle erstreckt. Wenn nach dem Löschen keine Zeilen mehr in der Tabelle vorhanden sind, wird die gesamte Tabelle gelöscht.

DeleteTableColumnRequest

Löscht eine Spalte aus einer Tabelle.

JSON-Darstellung 
{
  "tableCellLocation": {
    object (TableCellLocation)
  }
}
Felder
tableCellLocation

object (TableCellLocation)

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

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

InsertPageBreakRequest

Fügt an der angegebenen Stelle einen Seitenumbruch und dann eine neue Zeile ein.

JSON-Darstellung 
{

  "location": {
    object (Location)
  },
  "endOfSegmentLocation": {
    object (EndOfSegmentLocation)
  }
}
Felder
Die Stelle, an der der Seitenumbruch eingefügt wird. Im Folgenden finden Sie eine Liste von sich gegenseitig ausschließenden Feldern. In einer Antwort wird höchstens eines der Felder festgelegt:
location

object (Location)

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

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

Seitenumbrüche können nicht in eine Tabelle, Gleichung, Fußnote, Kopf- oder Fußzeile eingefügt werden. Da Seitenumbrüche nur im Textkörper eingefügt werden können, muss das Feld segment ID leer sein.

endOfSegmentLocation

object (EndOfSegmentLocation)

Fügt den Seitenumbruch am Ende des Dokumentinhalts ein.

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

Ende der sich gegenseitig ausschließenden Felder.

DeletePositionedObjectRequest

Löscht ein PositionedObject aus dem Dokument.

JSON-Darstellung 
{
  "objectId": string,
  "tabId": string
}
Felder
objectId

string

Die ID des zu löschenden positionierten Objekts.

tabId

string

Die Registerkarte, auf der sich das zu löschende positionierte Objekt befindet. Wird dieser Parameter weggelassen, wird die Anfrage auf den ersten Tab angewendet.

In einem Dokument mit nur einem Tab:

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

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

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

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

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

UpdateTableColumnPropertiesRequest

Aktualisiert die TableColumnProperties von Spalten in einer Tabelle.

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

object (Location)

Die Position, an der die Tabelle im Dokument beginnt.

columnIndices[]

integer

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

tableColumnProperties

object (TableColumnProperties)

Die zu aktualisierenden Tabellenspalteneigenschaften.

Wenn der Wert von tableColumnProperties#width weniger als 5 Punkt (5/72 Zoll) beträgt, wird der Fehler „400 Bad Request“ zurückgegeben.

fields

string (FieldMask format)

Die Felder, die aktualisiert werden sollen.

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

Wenn Sie beispielsweise die Spaltenbreite aktualisieren möchten, legen Sie fields auf "width" fest.

UpdateTableCellStyleRequest

Aktualisiert den Stil eines Bereichs von Tabellenzellen.

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

  "tableRange": {
    object (TableRange)
  },
  "tableStartLocation": {
    object (Location)
  }
}
Felder
tableCellStyle

object (TableCellStyle)

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

Wenn Sie Rahmenlinien aktualisieren und eine Zelle eine Rahmenlinie mit einer angrenzenden Zelle gemeinsam nutzt, wird auch die entsprechende Rahmenlinien-Property der angrenzenden Zelle aktualisiert. Zusammengeführte und unsichtbare Rahmen werden nicht aktualisiert.

Da das Aktualisieren einer Rahmenlinie, die von benachbarten Zellen gemeinsam genutzt wird, in derselben Anfrage zu widersprüchlichen Rahmenlinienaktualisierungen führen kann, werden Rahmenlinienaktualisierungen in der folgenden Reihenfolge angewendet:

  • borderRight
  • borderLeft
  • borderBottom
  • borderTop
fields

string (FieldMask format)

Die Felder, die aktualisiert werden sollen.

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

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

Wenn Sie ein Attribut auf den Standardwert zurücksetzen möchten, nehmen Sie seinen Feldnamen in die Feldmaske auf, lassen Sie das Feld selbst aber nicht festgelegt.

Die Zellen, die aktualisiert werden. Im Folgenden finden Sie eine Liste von sich gegenseitig ausschließenden Feldern. In einer Antwort wird höchstens eines der Felder festgelegt:
tableRange

object (TableRange)

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

tableStartLocation

object (Location)

Die Position, an der die Tabelle im Dokument beginnt. Wenn angegeben, werden die Aktualisierungen auf alle Zellen in der Tabelle angewendet.

Ende der sich gegenseitig ausschließenden Felder.

TableRange

Ein Tabellenbereich ist ein Verweis auf eine Teilmenge einer Tabelle.

Die durch einen Tabellenbereich angegebenen Zellen müssen nicht unbedingt ein Rechteck bilden. Angenommen, wir haben eine 3 × 3-Tabelle, in der alle Zellen der letzten Zeile zusammengeführt sind. Die Tabelle sieht so aus: 

 [   ][   ][   ]
 [   ][   ][   ]
 [             ]

Ein Tabellenbereich mit dem Tabellenzellenort = (tableStartLocation, row = 0, column = 0), rowSpan = 3 und columnSpan = 2 gibt die folgenden Zellen an: 

 [ x ][ x ][   ]
 [ x ][ x ][   ]
 [ x    x    x ]
JSON-Darstellung 
{
  "tableCellLocation": {
    object (TableCellLocation)
  },
  "rowSpan": integer,
  "columnSpan": integer
}
Felder
tableCellLocation

object (TableCellLocation)

Die Zellposition, an der der Tabellenbereich beginnt.

rowSpan

integer

Die Anzahl der Zeilen des Tabellenbereichs.

columnSpan

integer

Die Spaltenbreite des Tabellenbereichs.

UpdateTableRowStyleRequest

Aktualisiert die TableRowStyle von Zeilen in einer Tabelle.

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

object (Location)

Die Position, an der die Tabelle im Dokument beginnt.

rowIndices[]

integer

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

tableRowStyle

object (TableRowStyle)

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

fields

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. Ein einzelnes "*" kann als Kurzform für die Auflistung aller Felder verwendet werden.

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

ReplaceImageRequest

Ersetzt ein vorhandenes Bild durch ein neues Bild.

Wenn Sie ein Bild ersetzen, werden einige image effects aus dem vorhandenen Bild entfernt, um das Verhalten des Docs-Editors zu spiegeln.

JSON-Darstellung 
{
  "imageObjectId": string,
  "uri": string,
  "imageReplaceMethod": enum (ImageReplaceMethod),
  "tabId": string
}
Felder
imageObjectId

string

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

uri

string

Der URI des neuen Bildes.

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

Die angegebene URI darf nicht länger als 2 KB sein. Der URI wird mit dem Bild gespeichert und über das Feld ImageProperties.source_uri verfügbar gemacht.

imageReplaceMethod

enum (ImageReplaceMethod)

Die Ersetzungsmethode.

tabId

string

Der Tab, auf dem sich das zu ersetzende Bild befindet. Wird dieser Parameter weggelassen, wird die Anfrage auf den ersten Tab angewendet.

In einem Dokument mit nur einem Tab:

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

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

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

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

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

ImageReplaceMethod

Die Methode zum Ersetzen von Bildern.

Enums
IMAGE_REPLACE_METHOD_UNSPECIFIED Die Methode zum Ersetzen von Bildern wurde nicht angegeben. Dieser Wert darf nicht verwendet werden.
CENTER_CROP Das Bild wird skaliert und zentriert, um die Grenzen des Originalbilds auszufüllen. Das Bild wird möglicherweise zugeschnitten, damit es die Grenzen des Originalbilds ausfüllt. Die gerenderte Größe des Bildes entspricht der des Originalbildes.

UpdateDocumentStyleRequest

Aktualisiert die DocumentStyle.

JSON-Darstellung 
{
  "documentStyle": {
    object (DocumentStyle)
  },
  "fields": string,
  "tabId": string
}
Felder
documentStyle

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.

fields

string (FieldMask format)

Die Felder, die aktualisiert werden sollen.

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

Wenn Sie beispielsweise den Hintergrund aktualisieren möchten, legen Sie fields auf "background" fest.

tabId

string

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

In einem Dokument mit nur einem Tab:

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

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

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

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

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

MergeTableCellsRequest

Führt Zellen in einem Table zusammen.

JSON-Darstellung 
{
  "tableRange": {
    object (TableRange)
  }
}
Felder
tableRange

object (TableRange)

Der Tabellenbereich, der angibt, welche Zellen der Tabelle zusammengeführt werden sollen.

Der Text in den zusammenzuführenden Zellen wird verkettet und in der „Kopfzelle“ des Bereichs gespeichert. Dies ist die Zelle oben links im Bereich, wenn die Inhaltsrichtung von links nach rechts verläuft, und die Zelle oben rechts im Bereich, wenn die Inhaltsrichtung von rechts nach links verläuft.

Wenn der Bereich nicht rechteckig ist (was in einigen Fällen vorkommen kann, wenn der Bereich Zellen umfasst, die bereits zusammengeführt wurden, oder wenn die Tabelle nicht rechteckig ist), wird ein 400-Fehler (Ungültige Anfrage) zurückgegeben.

UnmergeTableCellsRequest

Hebt den Zellenverbund in einem Table auf.

JSON-Darstellung 
{
  "tableRange": {
    object (TableRange)
  }
}
Felder
tableRange

object (TableRange)

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

Alle zusammengeführten Zellen in diesem Bereich werden wieder getrennt. Zellen, die bereits getrennt sind, sind davon nicht betroffen. Wenn der Bereich keine zusammengeführten Zellen enthält, wird durch die Anfrage nichts bewirkt.

Wenn in einer der zusammengeführten Zellen Text vorhanden ist, bleibt dieser in der „Kopfzelle“ des resultierenden Blocks nicht zusammengeführter Zellen erhalten. Die Kopfzelle ist die Zelle oben links, wenn die Inhaltsrichtung von links nach rechts verläuft, und ansonsten die Zelle oben rechts.

CreateHeaderRequest

Erstellt ein Header. Der neue Header wird auf SectionStyle angewendet, und zwar an der Stelle von SectionBreak, falls angegeben. Andernfalls wird er auf DocumentStyle angewendet.

Wenn bereits ein Header des angegebenen Typs vorhanden ist, wird der Fehler „400 Bad Request“ zurückgegeben.

JSON-Darstellung 
{
  "type": enum (HeaderFooterType),
  "sectionBreakLocation": {
    object (Location)
  }
}
Felder
type

enum (HeaderFooterType)

Der Typ der zu erstellenden Kopfzeile.

sectionBreakLocation

object (Location)

Die Position von SectionBreak, mit der der Abschnitt beginnt, zu dem diese Kopfzeile gehören soll. Wenn „sectionBreakLocation“ nicht festgelegt ist oder sich auf den ersten Abschnittsumbruch im Dokumentkörper bezieht, gilt der Header für die DocumentStyle.

HeaderFooterType

Die Arten von Kopf- und Fußzeilen, die erstellt werden können.

Enums
DEFAULT Eine Standardkopf- und ‑fußzeile.

CreateFooterRequest

Erstellt ein Footer. Die neue Fußzeile wird auf die SectionStyle angewendet, sofern die SectionBreak angegeben ist. Andernfalls wird sie auf die DocumentStyle angewendet.

Wenn bereits eine Fußzeile des angegebenen Typs vorhanden ist, wird ein 400-Fehler („Bad Request“) zurückgegeben.

JSON-Darstellung 
{
  "type": enum (HeaderFooterType),
  "sectionBreakLocation": {
    object (Location)
  }
}
Felder
type

enum (HeaderFooterType)

Der Typ der zu erstellenden Fußzeile.

sectionBreakLocation

object (Location)

Der Speicherort des SectionBreak, der dem Abschnitt unmittelbar vorangeht, dessen SectionStyle diese Fußzeile zugeordnet werden soll. Wenn diese Option nicht festgelegt ist oder sich auf den ersten Abschnittsumbruch im Dokument bezieht, wird die Fußzeile auf den Dokumentstil angewendet.

CreateFootnoteRequest

Erstellt ein Footnote-Segment und fügt an der angegebenen Stelle ein neues FootnoteReference ein.

Das neue Segment Footnote enthält ein Leerzeichen, gefolgt von einem Zeilenumbruch.

JSON-Darstellung 
{

  "location": {
    object (Location)
  },
  "endOfSegmentLocation": {
    object (EndOfSegmentLocation)
  }
}
Felder
Die Stelle, an der der Fußnotenverweis eingefügt werden soll. Im Folgenden finden Sie eine Liste von sich gegenseitig ausschließenden Feldern. In einer Antwort wird höchstens eines der Felder festgelegt:
location

object (Location)

Fügt den Fußnotenverweis an einer bestimmten Stelle im Dokument ein.

Die Fußnotenreferenz muss innerhalb der Grenzen eines vorhandenen Paragraph eingefügt werden. Sie kann beispielsweise nicht am Startindex einer Tabelle eingefügt werden, also zwischen der Tabelle und dem vorherigen Absatz.

Fußnotenverweise können nicht in eine Gleichung, Kopfzeile, Fußzeile oder Fußnote eingefügt werden. Da Fußnotenverweise nur im Textkörper eingefügt werden können, muss das Feld segment ID leer sein.

endOfSegmentLocation

object (EndOfSegmentLocation)

Fügt die Fußnotenreferenz am Ende des Dokumenttexts ein.

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

Ende der sich gegenseitig ausschließenden Felder.

ReplaceNamedRangeContentRequest

Ersetzt den Inhalt des angegebenen NamedRange oder NamedRanges durch den angegebenen Ersatzinhalt.

Ein einzelnes NamedRange kann aus mehreren diskontinuierlichen ranges bestehen. In diesem Fall wird nur der Inhalt im ersten Bereich ersetzt. Die anderen Bereiche und deren Inhalt werden gelöscht.

Wenn das Ersetzen oder Löschen von Bereichen zu einer ungültigen Dokumentstruktur führen würde, wird der Fehler „400 Bad Request“ zurückgegeben.

JSON-Darstellung 
{
  "tabsCriteria": {
    object (TabsCriteria)
  },

  "text": string

  "namedRangeId": string,
  "namedRangeName": string
}
Felder
tabsCriteria

object (TabsCriteria)

Optional. Die Kriterien, mit denen angegeben wird, auf welchen Tabs der Ersatz erfolgt. Wenn nichts angegeben ist, gilt der Ersatz für alle Tabs.

In einem Dokument mit nur einem Tab:

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

  • Wenn nichts angegeben ist, wird der Platzhalter auf dem Tab „Singular“ ersetzt.

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

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

  • Wenn nichts angegeben ist, gilt der Ersatz für alle Tabs.

Der Inhalt, mit dem der vorhandene Inhalt des benannten Bereichs ersetzt werden soll. Im Folgenden finden Sie eine Liste von sich gegenseitig ausschließenden Feldern. In einer Antwort wird höchstens eines der Felder festgelegt:
text

string

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

Ende der sich gegenseitig ausschließenden Felder.
Eine Referenz auf die benannten Bereiche, deren Inhalt ersetzt wird. Im Folgenden finden Sie eine Liste von sich gegenseitig ausschließenden Feldern. In einer Antwort wird höchstens eines der Felder festgelegt:
namedRangeId

string

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

Wenn kein benannter Bereich mit der angegebenen ID vorhanden ist, wird ein 400-Fehler („Bad Request“) zurückgegeben.

namedRangeName

string

Der Name des NamedRanges, dessen Inhalt ersetzt wird.

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

Ende der sich gegenseitig ausschließenden Felder.

UpdateSectionStyleRequest

Aktualisiert die SectionStyle.

JSON-Darstellung 
{
  "range": {
    object (Range)
  },
  "sectionStyle": {
    object (SectionStyle)
  },
  "fields": string
}
Felder
range

object (Range)

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

Da Abschnittsumbrüche nur im Textkörper eingefügt werden können, muss das Feld segment ID leer sein.

sectionStyle

object (SectionStyle)

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

Bestimmte Änderungen am Abschnittsstil können andere Änderungen nach sich ziehen, um das Verhalten des Docs-Editors widerzuspiegeln. Weitere Informationen finden Sie in der Dokumentation zu SectionStyle.

fields

string (FieldMask format)

Die Felder, die aktualisiert werden sollen.

Es muss mindestens ein Feld angegeben werden. Das Stammverzeichnis sectionStyle ist impliziert und darf nicht angegeben werden. Ein einzelnes "*" kann als Kurzform für die Auflistung aller Felder verwendet werden.

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

InsertSectionBreakRequest

Fügt an der angegebenen Stelle einen Abschnittswechsel ein.

Vor dem Abschnittsumbruch wird ein Zeilenumbruchzeichen eingefügt.

JSON-Darstellung 
{
  "sectionType": enum (SectionType),

  "location": {
    object (Location)
  },
  "endOfSegmentLocation": {
    object (EndOfSegmentLocation)
  }
}
Felder
sectionType

enum (SectionType)

Der Typ des einzufügenden Abschnitts.

Die Stelle, an der die Pause eingefügt wird. Im Folgenden finden Sie eine Liste von sich gegenseitig ausschließenden Feldern. In einer Antwort wird höchstens eines der Felder festgelegt:
location

object (Location)

Fügt an einer bestimmten Stelle im Dokument eine neue Zeile und einen Abschnittsumbruch ein.

Der Abschnittsumbruch muss innerhalb der Grenzen eines vorhandenen Paragraph eingefügt werden. Sie kann beispielsweise nicht am Startindex einer Tabelle eingefügt werden, also zwischen der Tabelle und dem vorherigen Absatz.

Abschnittsumbrüche können nicht in eine Tabelle, Gleichung, Fußnote, Kopf- oder Fußzeile eingefügt werden. Da Abschnittsumbrüche nur im Textkörper eingefügt werden können, muss das Feld segment ID leer sein.

endOfSegmentLocation

object (EndOfSegmentLocation)

Fügt am Ende des Dokumentinhalts einen Zeilenumbruch und einen Abschnittsumbruch ein.

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

Ende der sich gegenseitig ausschließenden Felder.

DeleteHeaderRequest

Löscht ein Header aus dem Dokument.

JSON-Darstellung 
{
  "headerId": string,
  "tabId": string
}
Felder
headerId

string

Die ID des zu löschenden Headers. Wenn dieser Header auf DocumentStyle definiert ist, wird der Verweis auf diesen Header entfernt, sodass für den ersten Abschnitt des Dokuments kein Header dieses Typs vorhanden ist. Wenn dieser Header in einem SectionStyle definiert ist, wird der Verweis auf diesen Header entfernt und der Header dieses Typs wird im vorherigen Abschnitt fortgesetzt.

tabId

string

Der Tab mit dem zu löschenden Header. Wird dieser Parameter weggelassen, wird die Anfrage auf den ersten Tab angewendet.

In einem Dokument mit nur einem Tab:

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

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

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

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

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

DeleteFooterRequest

Löscht ein Footer aus dem Dokument.

JSON-Darstellung 
{
  "footerId": string,
  "tabId": string
}
Felder
footerId

string

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

tabId

string

Der Tab, der die zu löschende Fußzeile enthält. Wird dieser Parameter weggelassen, wird die Anfrage auf den ersten Tab angewendet.

In einem Dokument mit nur einem Tab:

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

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

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

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

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

PinTableHeaderRowsRequest

Aktualisiert die Anzahl der angepinnten Tabellenkopfzeilen in einer Tabelle.

JSON-Darstellung 
{
  "tableStartLocation": {
    object (Location)
  },
  "pinnedHeaderRowsCount": integer
}
Felder
tableStartLocation

object (Location)

Die Position, an der die Tabelle im Dokument beginnt.

pinnedHeaderRowsCount

integer

Die Anzahl der anzupinnenden Tabellenzeilen. Bei 0 sind alle Zeilen nicht angepinnt.

AddDocumentTabRequest

Fügt einen Dokument-Tab hinzu. Wenn ein Tab an einem bestimmten Index hinzugefügt wird, werden die Indexe aller nachfolgenden Tabs erhöht.

JSON-Darstellung 
{
  "tabProperties": {
    object (TabProperties)
  }
}
Felder
tabProperties

object (TabProperties)

Die Eigenschaften des hinzuzufügenden Tabs. Alle Attribute sind optional.

DeleteTabRequest

Löscht einen Tab. Wenn der Tab untergeordnete Tabs hat, werden diese ebenfalls gelöscht.

JSON-Darstellung 
{
  "tabId": string
}
Felder
tabId

string

Die ID des zu löschenden Tabs.

UpdateDocumentTabPropertiesRequest

Aktualisieren Sie die Eigenschaften eines Dokument-Tabs.

JSON-Darstellung 
{
  "tabProperties": {
    object (TabProperties)
  },
  "fields": string
}
Felder
tabProperties

object (TabProperties)

Die zu aktualisierenden Tab-Attribute.

fields

string (FieldMask format)

Die Felder, die aktualisiert werden sollen.

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

InsertPersonRequest

Fügt eine Erwähnung einer Person ein.

JSON-Darstellung 
{
  "personProperties": {
    object (PersonProperties)
  },

  "location": {
    object (Location)
  },
  "endOfSegmentLocation": {
    object (EndOfSegmentLocation)
  }
}
Felder
personProperties

object (PersonProperties)

Die Eigenschaften der einzufügenden Personenerwähnung.

Der Ort, an dem die Erwähnung der Person eingefügt wird. Im Folgenden finden Sie eine Liste von sich gegenseitig ausschließenden Feldern. In einer Antwort wird höchstens eines der Felder festgelegt:
location

object (Location)

Fügt die Erwähnung der Person an einer bestimmten Stelle im Dokument ein.

Die Erwähnung der Person muss innerhalb der Grenzen eines vorhandenen Paragraph eingefügt werden. Sie kann beispielsweise nicht am Startindex einer Tabelle eingefügt werden, also zwischen der Tabelle und dem vorherigen Absatz.

Personenerwähnungen können nicht in eine Gleichung eingefügt werden.

endOfSegmentLocation

object (EndOfSegmentLocation)

Die Erwähnung der Person wird am Ende einer Kopf- oder Fußzeile, einer Fußnote oder des Dokumenttexts eingefügt.

Ende der sich gegenseitig ausschließenden Felder.

UpdateNamedStyleRequest

Aktualisiert einen benannten Stil.

JSON-Darstellung 
{
  "namedStyle": {
    object (NamedStyle)
  },
  "fields": string,
  "tabId": string
}
Felder
namedStyle

object (NamedStyle)

Der zu aktualisierende Dokumentstil.

fields

string (FieldMask format)

Die NamedStyle-Felder, die aktualisiert werden sollen.

Es muss mindestens namedStyleType angegeben werden. Der Stamm namedStyle ist impliziert und sollte nicht angegeben werden. Ein einzelnes "*" kann als Kurzform für die Auflistung aller Felder verwendet werden.

Wenn Sie beispielsweise den Textstil auf „fett“ aktualisieren möchten, legen Sie fields so fest, dass "textStyle" und "textStyle.bold" enthalten sind. Wenn Sie die Ausrichtungseigenschaft des Absatzformats aktualisieren möchten, legen Sie fields so fest, dass "paragraphStyle" und "paragraphStyle.alignment" enthalten sind.

Wenn Sie ein Attribut auf den Standardwert zurücksetzen möchten, nehmen Sie seinen Feldnamen in die Feldmaske auf, lassen Sie das Feld selbst aber nicht festgelegt. Wenn Sie "textStyle" oder "paragraphStyle" mit einem leeren TextStyle oder ParagraphStyle angeben, werden alle zugehörigen untergeordneten Felder zurückgesetzt.

tabId

string

Der Dokument-Tab, der aktualisiert werden soll. Standardmäßig wird das Update auf den ersten Tab angewendet.

InsertRichLinkRequest

Fügt an der angegebenen Stelle ein RichLink ein.

JSON-Darstellung 
{
  "richLinkProperties": {
    object (RichLinkProperties)
  },

  "location": {
    object (Location)
  },
  "endOfSegmentLocation": {
    object (EndOfSegmentLocation)
  }
}
Felder
Der Ort, an dem der Rich-Link eingefügt wird. Im Folgenden finden Sie eine Liste von sich gegenseitig ausschließenden Feldern. In einer Antwort wird höchstens eines der Felder festgelegt:
location

object (Location)

Fügt den Rich-Link an einer bestimmten Stelle im Dokument ein.

Der Rich-Link muss innerhalb der Grenzen eines vorhandenen Paragraph eingefügt werden. Sie kann beispielsweise nicht am Startindex einer Tabelle eingefügt werden, also zwischen der Tabelle und dem vorherigen Absatz.

Der Rich-Link kann nicht in eine Gleichung eingefügt werden.

endOfSegmentLocation

object (EndOfSegmentLocation)

Fügt den Rich-Link am Ende einer Kopf- oder Fußzeile, einer Fußnote oder des Dokumenttexts ein.

Ende der sich gegenseitig ausschließenden Felder.

InsertDateRequest

Fügt an der angegebenen Stelle ein Datum ein.

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

  "location": {
    object (Location)
  },
  "endOfSegmentLocation": {
    object (EndOfSegmentLocation)
  }
}
Felder
dateElementProperties

object (DateElementProperties)

Die Eigenschaften des einzufügenden Datums.

Der Ort, an dem das Datum eingefügt wird. Im Folgenden finden Sie eine Liste von sich gegenseitig ausschließenden Feldern. In einer Antwort wird höchstens eines der Felder festgelegt:
location

object (Location)

Fügt das Datum an einer bestimmten Stelle im Dokument ein.

Das Datum muss innerhalb der Grenzen eines vorhandenen Paragraph eingefügt werden. Sie kann beispielsweise nicht am Startindex einer Tabelle eingefügt werden, also zwischen einer vorhandenen Tabelle und dem vorherigen Absatz.

endOfSegmentLocation

object (EndOfSegmentLocation)

Fügt das Datum am Ende der angegebenen Kopf- oder Fußzeile oder des Dokumentinhalts ein.

Ende der sich gegenseitig ausschließenden Felder.

InsertCommentRequest

Fügt eine CommentThread in das Dokument ein.

JSON-Darstellung 
{
  "content": string,
  "assigneeEmailAddress": string,

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

string

Der Text des Kommentars als Nur-Text.

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

Dieses Feld darf nicht leer sein und darf 2.048 UTF‑8-Codeeinheiten nicht überschreiten.

assigneeEmailAddress

string

Optional. Die E‑Mail-Adresse des Nutzers, dem der Kommentar zugewiesen ist.

Lassen Sie das Feld leer, wenn der Kommentar nicht zugewiesen werden soll.

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

Die Stelle im Dokument, die mit diesem Kommentar verknüpft ist. Im Folgenden finden Sie eine Liste von sich gegenseitig ausschließenden Feldern. In einer Antwort wird höchstens eines der Felder festgelegt:
range

object (Range)

Die Range im Dokument, das mit diesem Kommentar verknüpft ist.

Ende der sich gegenseitig ausschließenden Felder.

AddCommentReplyRequest

Fügt eine Antwort Post in eine CommentThread oder SuggestionThread ein.

JSON-Darstellung 
{
  "post": {
    object (Post)
  },

  "commentId": string,
  "suggestionId": string
}
Felder
post

object (Post)

Die Post, die die Antwort darstellt.

Die ID des Threads, dem die Antwort hinzugefügt werden soll. Im Folgenden finden Sie eine Liste von sich gegenseitig ausschließenden Feldern. In einer Antwort wird höchstens eines der Felder festgelegt:
commentId

string

Die ID der CommentThread, der die Antwort hinzugefügt werden soll.

suggestionId

string

Die ID der SuggestionThread, der die Antwort hinzugefügt werden soll.

Ende der sich gegenseitig ausschließenden Felder.

UpdateCommentPostRequest

Aktualisiert eine Post in einer CommentThread oder SuggestionThread.

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

  • Der Beitrag ist der headPost eines SuggestionThread.

  • Der anfragende Nutzer ist nicht der Autor des Beitrags.

JSON-Darstellung 
{
  "postId": string,
  "content": string,

  "commentId": string,
  "suggestionId": string
}
Felder
postId

string

Die ID des Beitrags, der aktualisiert wird.

content

string

Der neue Text des Kommentars im Nur-Text-Format.

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

Dieses Feld darf nicht leer sein und darf 2.048 UTF‑8-Codeeinheiten nicht überschreiten.

Die ID des Threads, zu dem der Beitrag gehört. Im Folgenden finden Sie eine Liste von sich gegenseitig ausschließenden Feldern. In einer Antwort wird höchstens eines der Felder festgelegt:
commentId

string

Die ID des CommentThread, zu dem der Beitrag gehört.

suggestionId

string

Die ID des SuggestionThread, zu dem der Beitrag gehört.

Ende der sich gegenseitig ausschließenden Felder.

DeleteCommentRequest

Löscht eine CommentThread.

Gibt einen 400-Fehler zurück, wenn der anfragende Nutzer nicht der Autor von headPost ist.

JSON-Darstellung 
{
  "commentId": string
}
Felder
commentId

string

Die ID des CommentThread, der gelöscht wird.

DeleteCommentReplyRequest

Löscht eine Antwort Post aus einem CommentThread oder SuggestionThread.

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

  • Der anfragende Nutzer ist nicht der Autor des Beitrags.

  • Der Antwortbeitrag enthält eine [Aktion][google.apps.docs.v1.Post.action].

  • Der Antwortbeitrag enthält ein assignee.

JSON-Darstellung 
{
  "postId": string,

  "commentId": string,
  "suggestionId": string
}
Felder
postId

string

Die ID der Antwort Post , die gelöscht wird.

Die ID des Threads, zu dem der Beitrag gehört. Im Folgenden finden Sie eine Liste von sich gegenseitig ausschließenden Feldern. In einer Antwort wird höchstens eines der Felder festgelegt:
commentId

string

Die ID des CommentThread, zu dem der Beitrag gehört.

suggestionId

string

Die ID des SuggestionThread, zu dem der Beitrag gehört.

Ende der sich gegenseitig ausschließenden Felder.

AcceptSuggestionRequest

Nimmt einen Vorschlag an.

Gibt den Fehler „403 (Unzulässig)“ zurück, wenn der anfragende Nutzer keinen Bearbeitungszugriff auf das Dokument hat.

JSON-Darstellung 
{
  "suggestionId": string
}
Felder
suggestionId

string

Die ID des Vorschlags.

RejectSuggestionRequest

Lehnt einen Vorschlag ab.

Gibt den Fehler „403 Forbidden“ zurück, wenn der anfragende Nutzer keinen Bearbeitungszugriff auf das Dokument hat und nicht der Autor des Vorschlags ist.

JSON-Darstellung 
{
  "suggestionId": string
}
Felder
suggestionId

string

Die ID des Vorschlags.

DeleteSuggestionRequest

Löscht einen Vorschlag.

Gibt den Fehler „403 Forbidden“ zurück, wenn der anfragende Nutzer nicht der Autor des Vorschlags ist.

JSON-Darstellung 
{
  "suggestionId": string
}
Felder
suggestionId

string

Die ID des Vorschlags.