Mit der Google Slides API können Sie Tabellen auf Seiten erstellen und bearbeiten. Die Beispiele auf dieser Seite zeigen einige gängige Tabellenvorgänge, für die die Methode presentations.batchUpdate verwendet wird.
In diesen Beispielen werden die folgenden Variablen verwendet:
- PRESENTATION_ID gibt an, wo Sie die Präsentations-ID angeben. Sie können den Wert für diese ID der Präsentations-URL entnehmen.
- PAGE_ID gibt an, wo Sie die Seitenobjekt-IDs angeben. Sie können den Wert dafür aus der URL oder mithilfe einer API-Leseanfrage abrufen.
- TABLE_ID gibt an, wo Sie die Objekt-ID des Seitenelements 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 zulassen, dass die Slides API automatisch eine ID erstellt. Element-IDs können über eine API-Leseanfrage abgerufen werden.
Diese Beispiele werden als HTTP-Anfragen dargestellt, um sprachneutral zu sein. Informationen zum Implementieren einer Batchaktualisierung in verschiedenen Sprachen mithilfe der Google API-Clientbibliotheken finden Sie unter Formen und Text hinzufügen.
Tabelle erstellen
Das folgende Codebeispiel presentations.batchUpdate zeigt, wie Sie mit der Methode CreateTableRequest einer durch PAGE_ID angegebenen Folie eine Tabelle hinzufügen können.
Diese Tabelle hat acht Zeilen und fünf Spalten. Die Slides API ignoriert alle size- oder transform-Felder, die als Teil von elementProperties bereitgestellt werden.
Stattdessen erstellt die API eine Tabelle, die ungefähr auf der Folie zentriert ist und nach Möglichkeit die angegebene Anzahl von Zeilen und Spalten aufnehmen kann.
Im Folgenden finden Sie das Anfrageprotokoll 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
Das folgende Codebeispiel presentations.batchUpdate zeigt, wie Sie mit der Methode DeleteTableRowRequest die sechste Zeile entfernen. Anschließend wird mit der Methode DeleteTableColumnRequest die vierte Spalte entfernt. Die Tabelle wird durch TABLE_ID angegeben. Sowohl rowIndex als auch columnIndex innerhalb der cellLocation basieren auf null.
Mit dem folgenden Anfrageprotokoll werden Tabellenzeilen oder -spalten gelöscht:
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
Das folgende Codebeispiel presentations.batchUpdate zeigt, wie Sie mit der Methode DeleteTextRequest den gesamten Text in einer Zelle innerhalb von textRange entfernen. Anschließend wird sie mithilfe der Methode InsertTextRequest durch den neuen Text von „Kangaroo“ ersetzt.
Die Tabelle wird durch TABLE_ID angegeben. Die betroffene Zelle befindet sich
in der fünften und dritten Spalte. Sowohl rowIndex als auch columnIndex innerhalb von cellLocation basieren auf null.
Im Folgenden finden Sie das Anfrageprotokoll 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
}
}
]
}
Kopfzeile einer Tabelle formatieren
Das folgende Codebeispiel presentations.batchUpdate zeigt, wie Sie mit der Methode UpdateTableCellPropertiesRequest die Kopfzeile eines Tabellenelements innerhalb der tableRange formatieren, die durch die TABLE_ID angegeben wird. Anschließend wird mit der Methode TableCellProperties die Hintergrundfarbe der Kopfzeile auf Schwarz festgelegt.
In jeder der folgenden Anfragen wird die Methode UpdateTextStyleRequest verwendet, um das Textformat in einer Zelle der Kopfzeile auf eine weiße 18-pt-Cambria-Schriftart in textRange zu setzen. Sie müssen diese Anfrage dann für jede weitere Zelle im Header wiederholen.
Sowohl rowIndex als auch columnIndex innerhalb von location und cellLocation basieren auf null.
Im Folgenden finden Sie das Anfrageprotokoll zur Formatierung 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
Das folgende Codebeispiel presentations.batchUpdate zeigt, wie Sie mit der Methode InsertTableRowsRequest drei Zeilen unterhalb der sechsten Zeile einfügen können. Anschließend werden mit der Methode InsertTableColumnsRequest zwei Spalten links neben der vierten Spalte derselben Tabelle hinzugefügt.
Die Tabelle wird durch TABLE_ID angegeben. Sowohl rowIndex als auch columnIndex innerhalb von cellLocation basieren auf null.
Im Folgenden finden Sie das Anfrageprotokoll für das 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
}
}
]
}