Mit der Google Präsentationen API können Sie Tabellen auf Seiten erstellen und bearbeiten. Die Beispiele auf dieser Seite zeigen einige gängige Tabellenvorgänge mit der Methode presentations.batchUpdate.
In diesen Beispielen werden die folgenden Variablen verwendet:
- PRESENTATION_ID: Gibt an, wo Sie die Präsentations-ID angeben. Sie finden den Wert für diese ID in der URL der Präsentation.
- PAGE_ID: Gibt an, wo Sie die IDs der Seitenobjekte angeben. Sie können den Wert dafür über die URL oder mithilfe einer API-Leseanfrage abrufen.
- TABLE_ID: Gibt an, wo Sie die Seitenelement-Objekt-ID für eine Tabelle angeben, mit der Sie arbeiten. Sie können diese ID für von Ihnen erstellte Elemente angeben (mit einigen Einschränkungen) oder die automatische Erstellung durch die Google Präsentationen API zulassen. Element-IDs können über eine API-Leseanfrage abgerufen werden.
Diese Beispiele werden als HTTP-Anfragen dargestellt, um sprachenunabhängig zu sein. Informationen zum Implementieren einer Batch-Aktualisierung in verschiedenen Sprachen mithilfe der Google API-Clientbibliotheken finden Sie unter Formen und Text hinzufügen.
Tabelle erstellen
Im folgenden Codebeispiel für presentations.batchUpdate wird gezeigt, wie Sie mit der Methode CreateTableRequest einer Folie, die durch PAGE_ID angegeben ist, eine Tabelle hinzufügen.
Diese Tabelle hat acht Zeilen und fünf Spalten. Die Google Präsentationen API ignoriert alle size- oder transform-Felder, die im Rahmen von elementProperties angegeben werden.
Stattdessen erstellt die API eine Tabelle, die in etwa auf der Folie zentriert ist und nach Möglichkeit die angegebene Anzahl von Zeilen und Spalten aufnehmen kann.
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
Im folgenden Codebeispiel presentations.batchUpdate wird gezeigt, wie Sie mit der Methode DeleteTableRowRequest die sechste Zeile entfernen. Dann wird mit der Methode DeleteTableColumnRequest die vierte Spalte entfernt. Die Tabelle wird durch TABLE_ID angegeben. Sowohl rowIndex als auch columnIndex in cellLocation beginnen bei null.
Im Folgenden finden Sie 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
Im folgenden Codebeispiel für presentations.batchUpdate wird gezeigt, wie Sie mit der Methode DeleteTextRequest den gesamten Text in einer Zelle innerhalb der textRange entfernen. Anschließend wird er mit der Methode InsertTextRequest durch den neuen Text „Känguru“ ersetzt.
Die Tabelle wird durch TABLE_ID angegeben. Die betroffene Zelle befindet sich in der fünften Zeile und dritten Spalte. Sowohl rowIndex als auch columnIndex innerhalb von cellLocation sind nullbasiert.
Im Folgenden ist das Anfrageprotokoll zum Bearbeiten von Tabellendaten aufgeführt:
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 } } ] }
Tabellenüberschriftszeilen formatieren
Im folgenden Codebeispiel für presentations.batchUpdate wird gezeigt, wie Sie mit der Methode UpdateTableCellPropertiesRequest die Kopfzeile eines Tabellenelements innerhalb des durch TABLE_ID angegebenen tableRange formatieren. Anschließend wird mit der Methode TableCellProperties die Hintergrundfarbe der Kopfzeile auf Schwarz festgelegt.
In jeder folgenden Anfrage wird die Methode UpdateTextStyleRequest verwendet, um das Textformat in einer Zelle der Kopfzeile in fett formatierter, weißer Cammbria-Schriftart (18 pt) in textRange festzulegen. Sie müssen diese Anfrage dann für jede weitere Zelle im Header wiederholen.
Sowohl rowIndex als auch columnIndex in location und cellLocation beginnen bei null.
Im Folgenden finden Sie das Anfrageprotokoll zum Formatieren einer Tabellenüberschriftenzeile:
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 Änderungen aus:
Tabellenzeilen oder ‑spalten einfügen
Das folgende Codebeispiel für presentations.batchUpdate zeigt, wie Sie mit der Methode InsertTableRowsRequest drei Zeilen unter der sechsten Zeile hinzufügen. Anschließend werden mit der Methode InsertTableColumnsRequest zwei Spalten links neben der vierten Spalte in derselben Tabelle hinzugefügt.
Die Tabelle wird durch die TABLE_ID angegeben. Sowohl rowIndex als auch columnIndex innerhalb von cellLocation sind nullbasiert.
Im Folgenden finden Sie 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
}
}
]
}