Anfrage
Eine einzelne Aktualisierung, die auf ein Dokument angewendet werden soll.
JSON-Darstellung |
---|
{ // Union field |
Felder | |
---|---|
Union-Feld
request Die spezifische Anfrage, die angewendet werden soll. Es ist genau ein Feld erforderlich.
request
kann nur einer der folgenden Werte sein:
|
|
replaceAllText
|
Ersetzt alle Instanzen des angegebenen Textes. |
insertText
|
Fügt Text an der angegebenen Position ein. |
updateTextStyle
|
Aktualisiert den Textstil im angegebenen Bereich. |
createParagraphBullets
|
Erstellt Aufzählungszeichen für Absätze. |
deleteParagraphBullets
|
Löscht Aufzählungszeichen aus Absätzen. |
createNamedRange
|
Erstellt einen benannten Bereich. |
deleteNamedRange
|
Löscht einen benannten Bereich. |
updateParagraphStyle
|
Aktualisiert den Absatzstil im angegebenen Bereich. |
deleteContentRange
|
Löscht Inhalte aus dem Dokument. |
insertInlineImage
|
Fügt an der angegebenen Position ein Inline-Bild ein. |
insertTable
|
Fügt eine Tabelle an der angegebenen Position ein. |
insertTableRow
|
Fügt eine leere Zeile in eine Tabelle ein. |
insertTableColumn
|
Fügt eine leere Spalte in eine Tabelle ein. |
deleteTableRow
|
Löscht eine Zeile aus einer Tabelle. |
deleteTableColumn
|
Löscht eine Spalte aus einer Tabelle. |
insertPageBreak
|
Fügt an der angegebenen Stelle einen Seitenumbruch ein. |
deletePositionedObject
|
Löscht ein positioniertes Objekt aus dem Dokument. |
updateTableColumnProperties
|
Aktualisiert die Eigenschaften von Spalten in einer Tabelle. |
updateTableCellStyle
|
Aktualisiert den Stil von Tabellenzellen. |
updateTableRowStyle
|
Aktualisiert den Zeilenstil in einer Tabelle. |
replaceImage
|
Ersetzt ein Bild im Dokument. |
updateDocumentStyle
|
Aktualisiert den Stil des Dokuments. |
mergeTableCells
|
Verbindet Zellen in einer Tabelle. |
unmergeTableCells
|
Hebt den Zellenverbund in einer Tabelle auf. |
createHeader
|
Erstellt einen Header. |
createFooter
|
Erstellt eine Fußzeile. |
createFootnote
|
Erstellt eine Fußnote. |
replaceNamedRangeContent
|
Ersetzt den Inhalt in einem benannten Bereich. |
updateSectionStyle
|
Aktualisiert den Abschnittsstil des angegebenen Bereichs. |
insertSectionBreak
|
Fügt an der angegebenen Position einen Abschnittswechsel ein. |
deleteHeader
|
Löscht eine Kopfzeile aus dem Dokument. |
deleteFooter
|
Löscht eine Fußzeile aus dem Dokument. |
pinTableHeaderRows
|
Aktualisiert die Anzahl der angepinnten Kopfzeilen in einer Tabelle. |
ReplaceAllTextRequest
Ersetzt alle Instanzen von Text, der einem Kriterium entspricht durch
replace text
JSON-Darstellung |
---|
{ "replaceText": string, "tabsCriteria": { object ( |
Felder | |
---|---|
replaceText
|
Der Text, durch den der übereinstimmende Text ersetzt wird. |
tabsCriteria
|
Optional. Die Kriterien, mit denen angegeben wird, in welchen Tabs die Ersetzung erfolgt. Wenn keine Angabe gemacht wird, wird die Ersetzung auf alle Tabs angewendet. In einem Dokument mit einem einzelnen Tab:
In einem Dokument mit mehreren Tabs:
|
Union-Feld
criteria Das Kriterium, das zum Abgleich des zu ersetzenden Textes verwendet wird.
criteria
kann nur einer der folgenden Werte sein:
|
|
containsText
|
Findet Text im Dokument, der mit dieser Teilzeichenfolge übereinstimmt. |
SubstringMatchCriteria
Ein Kriterium, das mit einer bestimmten Textzeichenfolge im Dokument übereinstimmt.
JSON-Darstellung |
---|
{ "text": string, "matchCase": boolean } |
Felder | |
---|---|
text
|
Text, nach dem im Dokument gesucht werden soll |
matchCase
|
Gibt an, ob bei der Suche die Groß-/Kleinschreibung berücksichtigt werden soll:
|
TabsCriteria
Ein Kriterium, das angibt, in welchen Tabs eine Anfrage ausgeführt wird.
JSON-Darstellung |
---|
{ "tabIds": [ string ] } |
Felder | |
---|---|
tabIds[]
|
Die Liste der Tab-IDs, in denen die Anfrage ausgeführt wird. |
InsertTextRequest
Fügt Text an der angegebenen Position ein.
JSON-Darstellung |
---|
{ "text": string, // Union field |
Felder | |
---|---|
text
|
Der Text, der eingefügt werden soll.
Durch das Einfügen eines Zeilenumbruchzeichens wird implizit ein neues
Textstile für eingefügten Text werden automatisch ermittelt, wobei im Allgemeinen der Stil des angrenzenden Textes beibehalten wird. In den meisten Fällen entspricht der Textstil für den eingefügten Text dem Text unmittelbar vor dem Einfügungsindex. 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. |
Union-Feld
insertion_location Die Position, an der der Text eingefügt wird.
insertion_location
kann nur einer der folgenden Werte sein:
|
|
location
|
Fügt den Text bei einem bestimmten Index im Dokument ein.
Text muss innerhalb der Grenzen einer vorhandenen
|
endOfSegmentLocation
|
Der Text wird am Ende einer Kopfzeile, Fußzeile, Fußnote oder des Dokumenttexts eingefügt. |
Standort
Eine bestimmte Stelle im Dokument.
JSON-Darstellung |
---|
{ "segmentId": string, "index": integer, "tabId": string } |
Felder | |
---|---|
segmentId
|
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. |
index
|
Der nullbasierte Index in UTF-16-Codeeinheiten.
Der Index bezieht sich auf den Anfang des durch
|
tabId
|
Der Tab, auf dem sich der Standort befindet. Ohne Angabe wird die Anfrage auf den ersten Tab angewendet. In einem Dokument mit einem einzelnen Tab:
In einem Dokument mit mehreren Tabs:
|
EndOfSegmentLocation
Position am Ende eines Textkörpers, einer Kopf-, Fußzeile oder einer Fußnote. Die Position befindet sich unmittelbar vor der letzten Zeilenvorschubzeile im Dokumentsegment.
JSON-Darstellung |
---|
{ "segmentId": string, "tabId": string } |
Felder | |
---|---|
segmentId
|
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. |
tabId
|
Der Tab, auf dem sich der Standort befindet. Ohne Angabe wird die Anfrage auf den ersten Tab angewendet. In einem Dokument mit einem einzelnen Tab:
In einem Dokument mit mehreren Tabs:
|
UpdateTextStyleRequest
Den Stil des Textes aktualisieren.
JSON-Darstellung |
---|
{ "textStyle": { object ( |
Felder | |
---|---|
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 auf die Übernahme festgelegt.
Bestimmte Textstiländerungen können andere Änderungen zur Folge haben, die dem Verhalten des Docs-Editors entsprechen. Weitere Informationen finden Sie in der Dokumentation zu
|
fields
|
Die Felder, die aktualisiert werden sollen.
Es muss mindestens ein Feld angegeben werden. Der Stamm
Um den Textstil beispielsweise in Fettdruck zu ändern, setzen Sie
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. |
Union-Feld
insertion_location Der Bereichstyp, in dem der Textstil aktualisiert wird.
insertion_location
kann nur einer der folgenden Werte sein:
|
|
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 innerhalb einer relativen UpdateTextStyleRequest eingefügt werden. |
CreateParagraphBulletsRequest
Erstellt Aufzählungszeichen für alle Absätze, die sich mit dem angegebenen Bereich überschneiden.
Die Verschachtelungsebene jedes Absatzes wird ermittelt, indem die vor jedem Absatz vorangehenden Tabulatoren gezählt werden. Um unnötigen Abstand zwischen dem Aufzählungszeichen und dem entsprechenden Absatz zu vermeiden, werden diese führenden Tabulatoren im Rahmen dieser Anfrage entfernt. Dadurch können sich die Indizes der Teile des Textes ändern.
Wenn sich der Absatz unmittelbar vor dem zu aktualisierenden Absatz in einer Liste mit einer übereinstimmenden Voreinstellung befindet, werden die zu aktualisierenden Absätze der vorherigen Liste hinzugefügt.
JSON-Darstellung |
---|
{ "range": { object ( |
Felder | |
---|---|
range
|
Der Bereich, auf den die Voreinstellung für Aufzählungszeichen angewendet werden soll. |
bulletPreset
|
Die Art der zu verwendenden Aufzählungszeichen. |
BulletGlyphPreset
Voreingestellte Muster von Aufzählungszeichen-Glyphen für Listen.
In diesen Mustern werden folgende Arten von Aufzählungspunkten verwendet:
-
ARROW
: Ein Pfeil, der einem Unicode-U+2794-Codepunkt entspricht -
ARROW3D
: ein Pfeil mit 3D-Schattierung, der einem Unicode U+27a2-Codepunkt entspricht -
CHECKBOX
: Ein leeres Quadrat, das einem Unicode-Codepunkt U+274f entspricht -
CIRCLE
: Ein hohler Kreis, der einem Unicode-Codepunkt U+25cb entspricht -
DIAMOND
: Eine durchgehende Raute, die einem Unicode-U+25c6-Codepunkt entspricht -
DIAMONDX
: Eine Raute mit einem "x", die einem Unicode U+2756-Codepunkt entspricht -
HOLLOWDIAMOND
: Eine leere Raute, die einem Unicode-U+25c7-Codepunkt entspricht -
DISC
: Ein ausgefüllter Kreis, der einem Unicode-U+25cf-Codepunkt entspricht -
SQUARE
: Ein ausgefülltes Quadrat, das einem Codepunkt in Unicode U+25a0 entspricht -
STAR
: ein Stern, der einem Unicode-U+2605-Codepunkt entspricht -
ALPHA
: Ein Kleinbuchstabe wie „a“, „b“ oder „c“. -
UPPERALPHA
: Ein Großbuchstaben wie "A", "B" oder "C". -
DECIMAL
: Eine Zahl wie "1", "2" oder "3". -
ZERODECIMAL
: Eine Zahl, bei der einstellige Zahlen mit einer Null vorangestellt werden, z. B. „01“, „02“ oder „03“. Zahlen mit mehr als einer Ziffer wird keine Null vorangestellt. -
ROMAN
: Eine kleine römische Zahl wie „i“, „ii“ oder „iii“. -
UPPERROMAN
: Eine große römische Zahl wie „I“, „II“ oder „III“. -
LEFTTRIANGLE
: Ein nach links zeigendes Dreieck, das einem Unicode-U+25c4-Codepunkt entspricht
Enums | |
---|---|
BULLET_GLYPH_PRESET_UNSPECIFIED
|
Die Voreinstellung für das Symbol für Aufzählungszeichen ist nicht angegeben. |
BULLET_DISC_CIRCLE_SQUARE
|
Eine Aufzählungsliste mit einem
DISC ,
CIRCLE
und
SQUARE
Aufzählungszeichen für die ersten drei Verschachtelungsebenen der Liste.
|
BULLET_DIAMONDX_ARROW3D_SQUARE
|
Eine Aufzählungsliste mit einem
DIAMONDX ,
ARROW3D
und
SQUARE
Aufzählungszeichen für die ersten drei Verschachtelungsebenen der Liste.
|
BULLET_CHECKBOX
|
Eine Aufzählungsliste mit
CHECKBOX
Aufzählungszeichen Glyphen für alle Verschachtelungsebenen einer Liste.
|
BULLET_ARROW_DIAMOND_DISC
|
Eine Aufzählungsliste mit einem
ARROW ,
DIAMOND
und
DISC
Aufzählungszeichen für die ersten drei Verschachtelungsebenen der Liste.
|
BULLET_STAR_CIRCLE_SQUARE
|
Eine Aufzählungsliste mit einem
STAR ,
CIRCLE
und
SQUARE
Aufzählungszeichen für die ersten drei Verschachtelungsebenen der Liste.
|
BULLET_ARROW3D_CIRCLE_SQUARE
|
Eine Aufzählungsliste mit einem
ARROW3D ,
CIRCLE
und
SQUARE
Aufzählungszeichen für die ersten drei Verschachtelungsebenen der Liste.
|
BULLET_LEFTTRIANGLE_DIAMOND_DISC
|
Eine Aufzählungsliste mit einem
LEFTTRIANGLE ,
DIAMOND
und
DISC
Aufzählungszeichen für die ersten drei Verschachtelungsebenen der Liste.
|
BULLET_DIAMONDX_HOLLOWDIAMOND_SQUARE
|
Eine Aufzählungsliste mit einem
DIAMONDX ,
HOLLOWDIAMOND
und
SQUARE
Aufzählungszeichen für die ersten drei Verschachtelungsebenen der Liste.
|
BULLET_DIAMOND_CIRCLE_SQUARE
|
Eine Aufzählungsliste mit einem
DIAMOND ,
CIRCLE
und
SQUARE
Aufzählungszeichen für die ersten drei Verschachtelungsebenen der Liste.
|
NUMBERED_DECIMAL_ALPHA_ROMAN
|
Eine nummerierte Liste mit
DECIMAL ,
ALPHA
und
ROMAN
numerische Glyphen für die ersten drei Listenverschachtelungsebenen, gefolgt von Punkten.
|
NUMBERED_DECIMAL_ALPHA_ROMAN_PARENS
|
Eine nummerierte Liste mit
DECIMAL ,
ALPHA
und
ROMAN
numerische Glyphen für die ersten drei Listenverschachtelungsebenen, gefolgt von Klammern.
|
NUMBERED_DECIMAL_NESTED
|
Eine nummerierte Liste mit
DECIMAL
numerische Glyphen, die durch Punkte getrennt sind, wobei für jede Verschachtelungsebene das Glyphe der vorherigen Verschachtelungsebene als Präfix verwendet wird. Beispiel: '1.', "1.1.", „2.“, „2.2.“.
|
NUMBERED_UPPERALPHA_ALPHA_ROMAN
|
Eine nummerierte Liste mit
UPPERALPHA ,
ALPHA
und
ROMAN
numerische Glyphen für die ersten drei Listenverschachtelungsebenen, gefolgt von Punkten.
|
NUMBERED_UPPERROMAN_UPPERALPHA_DECIMAL
|
Eine nummerierte Liste mit
UPPERROMAN ,
UPPERALPHA
und
DECIMAL
numerische Glyphen für die ersten drei Listenverschachtelungsebenen, gefolgt von Punkten.
|
NUMBERED_ZERODECIMAL_ALPHA_ROMAN
|
Eine nummerierte Liste mit
ZERODECIMAL ,
ALPHA
und
ROMAN
numerische Glyphen für die ersten drei Listenverschachtelungsebenen, 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 (
|
Felder | |
---|---|
range
|
Bereich, aus dem Aufzählungszeichen gelöscht werden sollen |
CreateNamedRangeRequest
Erstellt ein
NamedRange
, der auf den angegebenen Bereich verweist.
JSON-Darstellung |
---|
{
"name": string,
"range": {
object (
|
Felder | |
---|---|
name
|
Der Name des NamedRange. Namen müssen nicht eindeutig sein. Namen müssen mindestens 1 Zeichen und dürfen maximal 256 Zeichen lang sein (in UTF-16-Codeeinheiten). |
range
|
Bereich, auf den der Name angewendet werden soll. |
DeleteNamedRangeRequest
Löscht ein
NamedRange
JSON-Darstellung |
---|
{ "tabsCriteria": { object ( |
Felder | |
---|---|
tabsCriteria
|
Optional. Die Kriterien, mit denen angegeben wird, in welchen Tabs der Bereich gelöscht werden soll. Wenn Sie ihn nicht angeben, wird der Bereich auf alle Tabs gelöscht. In einem Dokument mit einem einzelnen Tab:
In einem Dokument mit mehreren Tabs:
|
Union-Feld
named_range_reference Der Wert, der bestimmt, welcher Bereich bzw. welche Bereiche gelöscht werden sollen. Es muss genau ein Wert festgelegt werden.
named_range_reference
kann nur einer der folgenden Werte sein:
|
|
namedRangeId
|
Die ID des benannten Bereichs, der gelöscht werden soll. |
name
|
Der Name des zu löschenden Bereichs. Alle benannten Bereiche mit diesem Namen werden gelöscht. |
UpdateParagraphStyleRequest
Aktualisieren Sie den Stil aller Absätze, die sich mit dem angegebenen Bereich überschneiden.
JSON-Darstellung |
---|
{ "paragraphStyle": { object ( |
Felder | |
---|---|
paragraphStyle
|
Die für die Absätze festzulegenden Stile.
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
|
fields
|
Die Felder, die aktualisiert werden sollen.
Es muss mindestens ein Feld angegeben werden. Der Stamm
Um beispielsweise die Ausrichtungseigenschaft des Absatzformats zu aktualisieren, setzen Sie
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. |
Union-Feld
insertion_location Der Bereichstyp, in dem der Absatzstil aktualisiert wird.
insertion_location
kann nur einer der folgenden Werte sein:
|
|
range
|
Der Bereich, der die zu formatierenden Absätze überschneidet. |
DeleteContentRangeRequest
Löscht Inhalte aus dem Dokument.
JSON-Darstellung |
---|
{
"range": {
object (
|
Felder | |
---|---|
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. Der Versuch, bestimmte Bereiche zu löschen, kann zu einer ungültigen Dokumentstruktur führen. In diesem Fall wird der Fehler 400 ungültig. Hier einige Beispiele für ungültige Löschanfragen:
|
InsertInlineImageRequest
Fügt ein
InlineObject
mit einem Bild an einem bestimmten Ort.
JSON-Darstellung |
---|
{ "uri": string, "objectSize": { object ( |
Felder | |
---|---|
uri
|
Der Image-URI. Das Bild wird einmal beim Einfügen abgerufen und eine Kopie zur Anzeige im Dokument gespeichert. Bilder müssen kleiner als 50 MB und nicht größer als 25 Megapixel sein. Außerdem müssen sie 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
|
objectSize
|
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. |
Union-Feld
insertion_location Der Ort, an dem das Bild eingefügt wird.
insertion_location
kann nur einer der folgenden Werte sein:
|
|
location
|
Das Bild wird bei einem bestimmten Index im Dokument eingefügt.
Das Bild muss innerhalb der Grenzen eines vorhandenen
Inline-Bilder können nicht innerhalb einer Fußnote oder Gleichung eingefügt werden. |
endOfSegmentLocation
|
Der Text wird am Ende einer Kopfzeile, Fußzeile oder des Dokumenttexts eingefügt. Inline-Bilder können nicht innerhalb einer Fußnote eingefügt werden. |
InsertTableRequest
Fügt eine Tabelle an der angegebenen Position ein.
Ein Zeilenumbruchzeichen wird vor der eingefügten Tabelle eingefügt.
JSON-Darstellung |
---|
{ "rows": integer, "columns": integer, // Union field |
Felder | |
---|---|
rows
|
Die Anzahl der Zeilen in der Tabelle |
columns
|
Die Anzahl der Spalten in der Tabelle. |
Union-Feld
insertion_location Der Ort, an dem die Tabelle eingefügt wird.
insertion_location
kann nur einer der folgenden Werte sein:
|
|
location
|
Fügt die Tabelle in einen bestimmten Modellindex ein. 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
Tabellen können nicht innerhalb einer Fußnote oder Gleichung eingefügt werden. |
endOfSegmentLocation
|
Fügt die Tabelle am Ende der angegebenen Kopf-, Fußzeile oder des Dokumenttexts ein. Ein Zeilenumbruchzeichen wird vor der eingefügten Tabelle eingefügt. Tabellen können nicht innerhalb einer Fußnote eingefügt werden. |
InsertTableRowRequest
Fügt eine leere Zeile in eine Tabelle ein.
JSON-Darstellung |
---|
{
"tableCellLocation": {
object (
|
Felder | |
---|---|
tableCellLocation
|
Die Zellenposition 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. |
insertBelow
|
Gibt an, ob eine neue Zeile unterhalb der Position der Referenzzelle eingefügt werden soll.
|
TableCellLocation
Position einer einzelnen Zelle in einer Tabelle.
JSON-Darstellung |
---|
{
"tableStartLocation": {
object (
|
Felder | |
---|---|
tableStartLocation
|
Der Anfang der Tabelle im Dokument. |
rowIndex
|
Der nullbasierte Zeilenindex. Die zweite Zeile in der Tabelle hat beispielsweise einen Zeilenindex von 1. |
columnIndex
|
Der nullbasierte Spaltenindex. Die zweite Spalte der Tabelle hat beispielsweise einen Spaltenindex von 1. |
InsertTableColumnRequest
Fügt eine leere Spalte in eine Tabelle ein.
JSON-Darstellung |
---|
{
"tableCellLocation": {
object (
|
Felder | |
---|---|
tableCellLocation
|
Die Zellenposition der Referenztabelle, 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. |
insertRight
|
Gibt an, ob eine neue Spalte rechts neben der Position der Referenzzelle eingefügt werden soll.
|
DeleteTableRowRequest
Löscht eine Zeile aus einer Tabelle.
JSON-Darstellung |
---|
{
"tableCellLocation": {
object (
|
Felder | |
---|---|
tableCellLocation
|
Die Position der Referenztabelle, von der aus 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. |
DeleteTableColumnRequest
Löscht eine Spalte aus einer Tabelle.
JSON-Darstellung |
---|
{
"tableCellLocation": {
object (
|
Felder | |
---|---|
tableCellLocation
|
Die Position der Referenztabelle, von der aus 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, die die Zelle überspannt. 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 Position einen Seitenumbruch gefolgt von einem Zeilenumbruch ein.
JSON-Darstellung |
---|
{ // Union field |
Felder | |
---|---|
Union-Feld
insertion_location Die Stelle, an der der Seitenumbruch eingefügt wird.
insertion_location
kann nur einer der folgenden Werte sein:
|
|
location
|
Fügt den Seitenumbruch bei einem bestimmten Index im Dokument ein.
Der Seitenumbruch muss innerhalb der Grenzen eines vorhandenen
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,
|
endOfSegmentLocation
|
Fügt den Seitenumbruch am Ende des Dokumenttexts ein.
Seitenumbrüche können nicht innerhalb einer Fußnote, Kopf- oder Fußzeile eingefügt werden. Da Seitenumbrüche nur innerhalb des Textkörpers eingefügt werden können,
|
DeletePositionedObjectRequest
Löscht ein
PositionedObject
aus dem Dokument.
JSON-Darstellung |
---|
{ "objectId": string, "tabId": string } |
Felder | |
---|---|
objectId
|
Die ID des positionierten Objekts, das gelöscht werden soll. |
tabId
|
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:
In einem Dokument mit mehreren Tabs:
|
UpdateTableColumnPropertiesRequest
Aktualisiert die
TableColumnProperties
Spalten in einer Tabelle.
JSON-Darstellung |
---|
{ "tableStartLocation": { object ( |
Felder | |
---|---|
tableStartLocation
|
Der Anfang der Tabelle im Dokument. |
columnIndices[]
|
Die Liste der nullbasierten Spaltenindexe, deren Attribut aktualisiert werden soll. Wenn keine Indizes angegeben sind, werden alle Spalten aktualisiert. |
tableColumnProperties
|
Die Eigenschaften der Tabellenspalte, die aktualisiert werden sollen.
Wenn der Wert von
|
fields
|
Die Felder, die aktualisiert werden sollen.
Es muss mindestens ein Feld angegeben werden. Der Stamm
Um beispielsweise die Spaltenbreite zu aktualisieren,
|
UpdateTableCellStyleRequest
Aktualisiert den Stil eines Tabellenzellenbereichs.
JSON-Darstellung |
---|
{ "tableCellStyle": { object ( |
Felder | |
---|---|
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:
|
fields
|
Die Felder, die aktualisiert werden sollen.
Es muss mindestens ein Feld angegeben werden. Der Stamm
Um beispielsweise die Hintergrundfarbe der Tabellenzelle zu aktualisieren,
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. |
Union-Feld
cells Die Zellen, die aktualisiert werden sollen.
cells
kann nur einer der folgenden Werte sein:
|
|
tableRange
|
Der Tabellenbereich, der die Teilmenge der Tabelle darstellt, auf die die Aktualisierungen angewendet werden. |
tableStartLocation
|
Der Anfang der Tabelle im Dokument. Wenn dieses Flag angegeben ist, werden die Aktualisierungen auf alle Zellen in der Tabelle angewendet. |
TableRange
Ein Tabellenbereich stellt einen Verweis auf eine Teilmenge einer Tabelle dar.
Beachten Sie, dass die durch einen Tabellenbereich angegebenen Zellen nicht unbedingt ein Rechteck bilden. Nehmen wir beispielsweise an, wir haben eine 3 x 3-Tabelle, in der alle Zellen der letzten Zeile zusammengeführt sind. Die Tabelle sieht so aus:
[ ][ ][ ]
[ ][ ][ ]
[ ]
Ein Tabellenbereich mit Tabellenzellenposition = (tableStartLocation, Zeile = 0, Spalte = 0), Zeilenspanne = 3 und Spaltenspanne = 2 gibt die folgenden Zellen an:
[ x ][ x ][ ]
[ x ][ x ][ ]
[ x x x ]
JSON-Darstellung |
---|
{
"tableCellLocation": {
object (
|
Felder | |
---|---|
tableCellLocation
|
Die Zelle, an der der Tabellenbereich beginnt. |
rowSpan
|
Der Zeilenumfang des Tabellenbereichs. |
columnSpan
|
Der Spaltenumfang des Tabellenbereichs. |
UpdateTableRowStyleRequest
Aktualisiert die
TableRowStyle
Zeilen in einer Tabelle.
JSON-Darstellung |
---|
{ "tableStartLocation": { object ( |
Felder | |
---|---|
tableStartLocation
|
Der Anfang der Tabelle im Dokument. |
rowIndices[]
|
Die Liste der nullbasierten Zeilenindexe, deren Stil aktualisiert werden soll. Wenn keine Indizes angegeben sind, werden alle Zeilen aktualisiert. |
tableRowStyle
|
Die Stile, die für die Zeilen festgelegt werden sollen. |
fields
|
Die Felder, die aktualisiert werden sollen.
Es muss mindestens ein Feld angegeben werden. Der Stamm
Um beispielsweise die minimale Zeilenhöhe zu aktualisieren,
|
ReplaceImageRequest
Ersetzt ein vorhandenes Image durch ein neues.
Beim Ersetzen eines Bildes werden einige
image effects
aus dem vorhandenen Bild, um das Verhalten des Docs-Editors widerzuspiegeln.
JSON-Darstellung |
---|
{
"imageObjectId": string,
"uri": string,
"imageReplaceMethod": enum (
|
Felder | |
---|---|
imageObjectId
|
Die ID des vorhandenen Images, das ersetzt wird. Die ID kann der Antwort auf eine get -Anfrage entnommen werden. |
uri
|
Der URI des neuen Images. Das Bild wird einmal beim Einfügen abgerufen und eine Kopie zur Anzeige im Dokument gespeichert. Bilder müssen kleiner als 50 MB und nicht größer als 25 Megapixel sein und 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
|
imageReplaceMethod
|
Die Ersetzungsmethode. |
tabId
|
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:
In einem Dokument mit mehreren Tabs:
|
ImageReplaceMethod
Die Methode zum Ersetzen von Bildern.
Enums | |
---|---|
IMAGE_REPLACE_METHOD_UNSPECIFIED
|
Nicht angegebene Methode zum Ersetzen von Bildern. Dieser Wert darf nicht verwendet werden. |
CENTER_CROP
|
Skaliert und zentriert das Bild, damit es die Grenzen des Originalbilds ausfüllt. Das Bild wird möglicherweise zugeschnitten, damit es die Grenzen des Originalbilds ausfüllt. Das Bild wird genauso groß wie das Originalbild gerendert. |
UpdateDocumentStyleRequest
Aktualisiert die
DocumentStyle
JSON-Darstellung |
---|
{
"documentStyle": {
object (
|
Felder | |
---|---|
documentStyle
|
Die Stile, die für das Dokument festgelegt werden sollen.
Bestimmte Änderungen am Dokumentstil können andere Änderungen zur Folge haben, die dem Verhalten des Docs-Editors entsprechen. Weitere Informationen finden Sie in der Dokumentation zu
|
fields
|
Die Felder, die aktualisiert werden sollen.
Es muss mindestens ein Feld angegeben werden. Der Stamm
Um beispielsweise den Hintergrund zu aktualisieren,
|
tabId
|
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:
In einem Dokument mit mehreren Tabs:
|
MergeTableCellsRequest
Verbindet Zellen in einem
Table
JSON-Darstellung |
---|
{
"tableRange": {
object (
|
Felder | |
---|---|
tableRange
|
Der Tabellenbereich, der angibt, welche Zellen der Tabelle verbunden werden sollen. Der gesamte Text in den Zellen, die zusammengeführt werden, wird verkettet und im <head>-Bereich gespeichert. Zelle des Bereichs. Bei einer 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. |
UnmergeTableCellsRequest
Hebt den Zellenverbund in einem auf
Table
JSON-Darstellung |
---|
{
"tableRange": {
object (
|
Felder | |
---|---|
tableRange
|
Der Tabellenbereich, der angibt, für welche Zellen der Tabelle der Zellenverbund aufgehoben werden soll. Für alle verbundenen Zellen in diesem Bereich wird die Verbindung aufgehoben. Bereits zusammengeführte Zellen sind davon nicht betroffen. Wenn der Bereich keine verbundenen Zellen enthält, führt die Anfrage nichts aus. Wenn sich in einer der verbundenen Zellen Text befindet, bleibt der Text im Kopfbereich. Zelle des resultierenden Blocks von nicht verbundenen Zellen. Der „Kopf“ Die Zelle ist die linke obere Zelle, wenn die Inhaltsrichtung von links nach rechts ist. Andernfalls ist die Zelle die Zelle oben rechts. |
CreateHeaderRequest
Erstellt ein
Header
Der neue Header wird auf die
SectionStyle
am Standort des
SectionBreak
falls angegeben. Andernfalls wird sie auf den
DocumentStyle
Wenn bereits ein Header des angegebenen Typs vorhanden ist, wird ein Fehler vom Typ „400 Bad Request“ zurückgegeben.
JSON-Darstellung |
---|
{ "type": enum ( |
Felder | |
---|---|
type
|
Der zu erstellende Header-Typ. |
sectionBreakLocation
|
Der Standort des
|
CreateFootnoteRequest
Erstellt ein
Footnote
Segment und fügt ein neues
FootnoteReference
an einem bestimmten Ort hinzufügen.
Das neue
Footnote
enthält ein Leerzeichen, gefolgt von einem Zeilenumbruchzeichen.
JSON-Darstellung |
---|
{ // Union field |
Felder | |
---|---|
Union-Feld
footnote_reference_location Die Stelle, an der der Fußnotenverweis eingefügt wird.
footnote_reference_location
kann nur einer der folgenden Werte sein:
|
|
location
|
Fügt den Fußnotenverweis bei einem bestimmten Index im Dokument ein.
Der Fußnotenverweis muss innerhalb der Grenzen eines vorhandenen
Fußnotenverweise können nicht innerhalb einer Gleichung, einer Kopfzeile, einer Fußzeile oder einer Fußnote eingefügt werden. Da Fußnotenverweise nur in den Textkörper eingefügt werden können,
|
endOfSegmentLocation
|
Fügt den Fußnotenverweis am Ende des Dokumenttexts ein.
Fußnotenverweise können nicht innerhalb einer Kopf-, Fußzeile oder Fußnote eingefügt werden. Da Fußnotenverweise nur in den Textkörper eingefügt werden können,
|
ReplaceNamedRangeContentRequest
Ersetzt den Inhalt des angegebenen
NamedRange
oder
NamedRanges
mit dem angegebenen Ersatzinhalt.
Beachten Sie, dass eine Person
NamedRange
kann aus mehreren uneinheitlichen
ranges
. In diesem Fall wird nur der Inhalt im ersten Bereich ersetzt. Die anderen Bereiche und deren Inhalte werden gelöscht.
In Fällen, in denen 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 ( |
Felder | |
---|---|
tabsCriteria
|
Optional. Die Kriterien, mit denen angegeben wird, in welchen Tabs die Ersetzung erfolgt. Wenn keine Angabe gemacht wird, wird die Ersetzung auf alle Tabs angewendet. In einem Dokument mit einem einzelnen Tab:
In einem Dokument mit mehreren Tabs:
|
Union-Feld
replacement_content Der Inhalt, durch den der vorhandene Inhalt des benannten Bereichs ersetzt werden soll.
replacement_content
kann nur einer der folgenden Werte sein:
|
|
text
|
Ersetzt den Inhalt des angegebenen benannten Bereichs durch den angegebenen Text. |
Union-Feld
named_range_reference Ein Verweis auf die benannten Bereiche, deren Inhalt ersetzt werden soll.
named_range_reference
kann nur einer der folgenden Werte sein:
|
|
namedRangeId
|
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. |
namedRangeName
|
Der Name des
Wenn es mehrere
|
UpdateSectionStyleRequest
Aktualisiert die
SectionStyle
JSON-Darstellung |
---|
{ "range": { object ( |
Felder | |
---|---|
range
|
Der Bereich, der sich mit den zu gestaltenden Abschnitten überschneidet.
Da Abschnittswechsel nur innerhalb des Textkörpers eingefügt werden können,
|
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
|
fields
|
Die Felder, die aktualisiert werden sollen.
Es muss mindestens ein Feld angegeben werden. Der Stamm
Um beispielsweise den linken Rand zu aktualisieren,
|
InsertSectionBreakRequest
Fügt an der angegebenen Position einen Abschnittswechsel ein.
Vor dem Abschnittswechsel wird ein Zeilenumbruchzeichen eingefügt.
JSON-Darstellung |
---|
{ "sectionType": enum ( |
Felder | |
---|---|
sectionType
|
Der Typ des einzufügenden Abschnitts. |
Union-Feld
insertion_location Die Stelle, an der die Unterbrechung eingefügt wird.
insertion_location
kann nur einer der folgenden Werte sein:
|
|
location
|
Fügt bei einem bestimmten Index im Dokument einen Zeilenumbruch und einen Abschnittswechsel ein.
Der Abschnittswechsel muss innerhalb der Grenzen eines vorhandenen
Abschnittswechsel können nicht innerhalb einer Tabelle, einer Gleichung, einer Fußnote, einer Kopf- oder Fußzeile eingefügt werden. Da Abschnittswechsel nur innerhalb des Textkörpers eingefügt werden können,
|
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,
|
DeleteHeaderRequest
Löscht ein
Header
aus dem Dokument.
JSON-Darstellung |
---|
{ "headerId": string, "tabId": string } |
Felder | |
---|---|
headerId
|
Die ID des zu löschenden Headers. Wenn dieser Header in
|
tabId
|
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:
In einem Dokument mit mehreren Tabs:
|
PinTableHeaderRowsRequest
Aktualisiert die Anzahl der angepinnten Kopfzeilen von Tabellen in einer Tabelle.
JSON-Darstellung |
---|
{
"tableStartLocation": {
object (
|
Felder | |
---|---|
tableStartLocation
|
Der Anfang der Tabelle im Dokument. |
pinnedHeaderRowsCount
|
Die Anzahl der anzupinnenden Tabellenzeilen, wobei 0 bedeutet, dass alle Zeilen losgelöst sind. |