Mit der Google Slides API können Sie Tabellen auf Seiten erstellen und bearbeiten. Die Beispiele auf
werden auf dieser Seite einige gängige Tabellenvorgänge
presentations.batchUpdate
.
In diesen Beispielen werden die folgenden Variablen verwendet:
- PRESENTATION_ID: Gibt an, wo Sie die Präsentation ID fest. Sie können finden Sie den Wert für diese ID in der Präsentations-URL.
- PAGE_ID: Gibt an, wo Sie das Seitenobjekt bereitstellen. IDs: Sie können die Daten abrufen, den Wert hierfür aus der URL oder mithilfe einer API-Leseanfrage.
- TABLE_ID: Gibt an, wo Sie die Seite bereitstellen. Objekt-ID des Elements für ein Tabelle, mit der Sie arbeiten. Sie können diese ID für Elemente angeben, die Sie erstellen (mit einigen Einschränkungen) oder über die Slides API automatisch eine erstellen lassen. Element-IDs kann über eine API-Leseanfrage abgerufen werden.
Diese Beispiele werden als HTTP-Anfragen dargestellt, damit sie sprachneutral sind. Weitere Informationen Wie eine Batch-Aktualisierung in verschiedenen Sprachen mithilfe der Google API implementiert wird finden Sie unter Formen und Text.
Tabelle erstellen
Die folgenden
presentations.batchUpdate
wird gezeigt, wie Sie mit der
CreateTableRequest
, um einer Folie, die durch PAGE_ID angegeben wird, eine Tabelle hinzuzufügen.
Diese Tabelle hat acht Zeilen und fünf Spalten. Beachten Sie, dass die Slides API
ignoriert alle size
- oder transform
-Felder, die als Teil des
elementProperties
Stattdessen erstellt die API eine Tabelle, die in etwa zentriert auf der Folie steht und
, um die angegebene Anzahl von Zeilen und Spalten aufzunehmen.
Das folgende Anfrageprotokoll dient zum Erstellen einer Tabelle:
POST https://slides.googleapis.com/v1/presentations/PRESENTATION_ID:batchUpdate
{ "requests": [ { "createTable": { "objectId": TABLE_ID, "elementProperties": { "pageObjectId": PAGE_ID, }, "rows": 8, "columns": 5 } } ] }
Tabellenzeilen oder -spalten löschen
Die folgenden
presentations.batchUpdate
wird gezeigt, wie Sie mit der
DeleteTableRowRequest
um die sechste Zeile zu entfernen. Dann wird die Methode
DeleteTableColumnRequest
um die vierte Spalte zu entfernen. Die Tabelle wird durch den
TABLE_ID Sowohl rowIndex
als auch columnIndex
innerhalb der
cellLocation
sind nullbasiert.
Folgendes ist das Anfrageprotokoll zum Löschen von Tabellenzeilen oder -spalten:
POST https://slides.googleapis.com/v1/presentations/PRESENTATION_ID:batchUpdate
{ "requests": [ { "deleteTableRow": { "tableObjectId": TABLE_ID, "cellLocation": { "rowIndex": 5 } } }, { "deleteTableColumn": { "tableObjectId": TABLE_ID, "cellLocation": { "columnIndex": 3 } } } ] }
Tabellendaten bearbeiten
Die folgenden
presentations.batchUpdate
wird gezeigt, wie Sie mit der
DeleteTextRequest
den gesamten Text aus einer Zelle innerhalb der
textRange
Es
verwendet dann die Methode
InsertTextRequest
, um ihn durch den neuen Text "Känguru" zu ersetzen.
Die Tabelle wird durch TABLE_ID angegeben. Die betroffene Zelle befindet sich in
in der fünften Zeile
und in der dritten Spalte. Sowohl der rowIndex
als auch der columnIndex
innerhalb
cellLocation
sind nullbasiert.
Das folgende Anfrageprotokoll dient zum Bearbeiten von Tabellendaten:
POST https://slides.googleapis.com/v1/presentations/PRESENTATION_ID:batchUpdate
{ "requests": [ { "deleteText": { "objectId": TABLE_ID, "cellLocation": { "rowIndex": 4, "columnIndex": 2 }, "textRange": { "type": "ALL", } } }, { "insertText": { "objectId": TABLE_ID, "cellLocation": { "rowIndex": 4, "columnIndex": 2 }, "text": "Kangaroo", "insertionIndex": 0 } } ] }
Kopfzeilen von Tabellen formatieren
Die folgenden
presentations.batchUpdate
wird gezeigt, wie Sie mit der
UpdateTableCellPropertiesRequest
zur Formatierung der Kopfzeile eines Tabellenelements innerhalb der
tableRange
die durch TABLE_ID angegeben werden. Dann wird die Methode
TableCellProperties
, um die Hintergrundfarbe der Kopfzeile auf Schwarz zu setzen.
Jede folgende Anfrage verwendet den Parameter
UpdateTextStyleRequest
-Methode, um das Textformat in einer Zelle der Kopfzeile in Fettdruck, weiß 18-pt, festzulegen
Cambria-Schriftart innerhalb der
textRange
Ich
diese Anfrage für jede weitere Zelle im Header wiederholen.
Sowohl rowIndex
als auch columnIndex
innerhalb von location
und
cellLocation
sind nullbasiert.
Das folgende Anfrageprotokoll dient zum Formatieren einer Kopfzeile einer Tabelle:
POST https://slides.googleapis.com/v1/presentations/PRESENTATION_ID:batchUpdate
{ "requests": [ { "updateTableCellProperties": { "objectId": TABLE_ID, "tableRange": { "location": { "rowIndex": 0, "columnIndex": 0 }, "rowSpan": 1, "columnSpan": 3 }, "tableCellProperties": { "tableCellBackgroundFill": { "solidFill": { "color": { "rgbColor": { "red": 0.0, "green": 0.0, "blue": 0.0 } } } } }, "fields": "tableCellBackgroundFill.solidFill.color" } }, { "updateTextStyle": { "objectId": TABLE_ID, "cellLocation": { "rowIndex": 0, "columnIndex": 0 }, "style": { "foregroundColor": { "opaqueColor": { "rgbColor": { "red": 1.0, "green": 1.0, "blue": 1.0 } } }, "bold": true, "fontFamily": "Cambria", "fontSize": { "magnitude": 18, "unit": "PT" } }, "textRange": { "type": "ALL" }, "fields": "foregroundColor,bold,fontFamily,fontSize" } }, // Repeat the above request for each additional cell in the header row.... ] }
So sieht die formatierte Kopfzeile nach diesen Aktualisierungen aus:
Tabellenzeilen oder -spalten einfügen
Die folgenden
presentations.batchUpdate
wird gezeigt, wie Sie mit der
InsertTableRowsRequest
um drei Zeilen unterhalb der sechsten Zeile hinzuzufügen. Dann wird die Methode
InsertTableColumnsRequest
, um zwei Spalten links von der vierten Spalte in derselben Tabelle hinzuzufügen.
Die Tabelle wird durch TABLE_ID angegeben. Sowohl rowIndex
als auch
Die columnIndex
innerhalb der cellLocation
sind nullbasiert.
Folgendes ist das Anfrageprotokoll zum Einfügen von Tabellenzeilen oder -spalten:
POST https://slides.googleapis.com/v1/presentations/PRESENTATION_ID:batchUpdate
{ "requests": [ { "insertTableRows": { "tableObjectId": TABLE_ID, "cellLocation": { "rowIndex": 5 }, "insertBelow": true, "number": 3 } }, { "insertTableColumns": { "tableObjectId": TABLE_ID, "cellLocation": { "columnIndex": 3 }, "insertRight": false, "number": 2 } } ] }