Interfejs API Prezentacji Google umożliwia tworzenie i edytowanie tabel na stronach. Przykłady na tej stronie pokazują niektóre typowe operacje na tabelach wykonywane z użyciem metody presentations.batchUpdate.
W poniższych przykładach używane są te zmienne:
- PRESENTATION_ID – wskazuje, gdzie podajesz identyfikator prezentacji. Wartość tego identyfikatora można poznać w adresie URL prezentacji.
- PAGE_ID – wskazuje miejsce, w którym podajesz identyfikatory obiektów strony. Wartość tę można pobrać z adresu URL lub za pomocą żądania odczytu interfejsu API.
- TABLE_ID – wskazuje, gdzie podajesz identyfikator obiektu elementu strony używanej przez Ciebie tabeli. Możesz określić ten identyfikator dla tworzonych elementów (z pewnymi ograniczeniami) lub zezwolić interfejsowi Prezentacji API na jego automatyczne tworzenie. Identyfikatory elementów można pobierać za pomocą żądania odczytu interfejsu API.
Te przykłady są prezentowane jako żądania HTTP bez względu na język. Aby dowiedzieć się, jak wdrożyć aktualizację zbiorczą w różnych językach za pomocą bibliotek klienta interfejsu API Google, przeczytaj sekcję Dodawanie kształtów i tekstu.
Tworzenie tabeli
Poniższy przykładowy kod presentations.batchUpdate pokazuje, jak za pomocą metody CreateTableRequest dodać tabelę do slajdu określonego przez PAGE_ID.
Ta tabela ma osiem wierszy i pięć kolumn. Pamiętaj, że interfejs Prezentacji API ignoruje pola size i transform podane w elementProperties.
Zamiast tego interfejs API tworzy tabelę, która jest mniej więcej wyśrodkowana na slajdzie i ma wymiary odpowiadające określonej liczbie wierszy i kolumn, jeśli to możliwe.
Aby utworzyć tabelę, użyj protokołu żądania:
POST https://slides.googleapis.com/v1/presentations/PRESENTATION_ID:batchUpdate
{
"requests": [
{
"createTable": {
"objectId": TABLE_ID,
"elementProperties": {
"pageObjectId": PAGE_ID,
},
"rows": 8,
"columns": 5
}
}
]
}
Usuwanie wierszy i kolumn tabeli
Z przykładowego kodu presentations.batchUpdate dowiesz się, jak za pomocą metody DeleteTableRowRequest usunąć 6 wiersz. Następnie za pomocą metody DeleteTableColumnRequest usuwa czwartą kolumnę. Tabelę określa parametr TABLE_ID. Zarówno rowIndex, jak i columnIndex w cellLocation są liczone od zera.
Protokół żądania usuwania wierszy i kolumn tabeli wygląda tak:
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
}
}
}
]
}
Edytuj dane w tabeli
Poniższy przykładowy kod presentations.batchUpdate pokazuje, jak za pomocą metody DeleteTextRequest usunąć cały tekst z komórki wewnątrz textRange. Następnie za pomocą metody InsertTextRequest zastępuje go nowym tekstem: „Kangaroo”.
Tabelę określa parametr TABLE_ID. Komórka, której dotyczy problem, znajduje się
w piątym wierszu i trzeciej kolumnie. Zarówno rowIndex, jak i columnIndex w cellLocation są liczone od zera.
Protokół żądania do edycji danych w tabeli:
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
}
}
]
}
Formatowanie wiersza nagłówka tabeli
Poniższy przykładowy kod presentations.batchUpdate pokazuje, jak użyć metody UpdateTableCellPropertiesRequest do formatowania wiersza nagłówka elementu tabeli w sekcji tableRange określonej przez TABLE_ID. Następnie za pomocą metody TableCellProperties ustawia czarny kolor tła wiersza nagłówka.
Każde poniższe żądanie używa metody UpdateTextStyleRequest, aby ustawić format tekstu w jednej komórce wiersza nagłówka na pogrubioną, białą czcionkę o wielkości 18 punktów w textRange. Musisz powtórzyć to żądanie dla każdej dodatkowej komórki nagłówka.
Zarówno rowIndex, jak i columnIndex w location i cellLocation mają wartość zerową.
Oto protokół żądania do formatowania wiersza nagłówka tabeli:
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....
]
}
Tak wygląda sformatowany wiersz nagłówka po aktualizacji:
Wstawianie wierszy lub kolumn tabeli
Z przykładowego kodu presentations.batchUpdate dowiesz się, jak za pomocą metody InsertTableRowsRequest dodać 3 wiersze poniżej szóstego wiersza. Następnie za pomocą metody InsertTableColumnsRequest dodaje 2 kolumny po lewej stronie czwartej kolumny w tej samej tabeli.
Tabelę określa parametr TABLE_ID. Zarówno rowIndex, jak i columnIndex w cellLocation są liczone od zera.
Protokół żądania wstawia wiersze lub kolumny tabeli:
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
}
}
]
}