Interfejs API Prezentacji Google umożliwia tworzenie i edytowanie tabel na stronach. Przykłady w
na tej stronie znajdziesz kilka typowych operacji na tabeli za pomocą
presentations.batchUpdate
.
W poniższych przykładach używane są te zmienne:
- PRESENTATION_ID – wskazuje, gdzie podajesz atrybuty prezentacja Identyfikator. Dostępne opcje wartość tego identyfikatora można znaleźć w adresie URL prezentacji.
- PAGE_ID – wskazuje miejsce, w którym podajesz obiekt strony. Identyfikatory. Możesz pobrać tę wartość z adresu URL lub za pomocą żądania odczytu interfejsu API.
- TABLE_ID – wskazuje, gdzie udostępniasz stronę identyfikator obiektu elementu nad tabelą, nad którą pracujesz. Możesz podać ten identyfikator dla tworzonych elementów (z kilkoma ograniczenia) lub pozwolić interfejsowi API Prezentacji na ich automatyczne utworzenie. 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 się uczyć Jak wdrożyć aktualizację zbiorczą w różnych językach przy użyciu interfejsu API Google? Więcej informacji znajdziesz w sekcji Dodawanie kształtów tekst.
Tworzenie tabeli
Poniżej
presentations.batchUpdate
przykładowy kod pokazuje, jak używać parametru
CreateTableRequest
aby dodać tabelę do slajdu określonego przez PAGE_ID.
Ta tabela ma osiem wierszy i pięć kolumn. Pamiętaj, że w interfejsie Prezentacji API
ignoruje wszystkie pola size i transform podane w argumencie
elementProperties.
Zamiast tego interfejs API tworzy tabelę wyśrodkowaną mniej więcej na slajdzie
dostosowane pod kątem określonej liczby 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
Poniżej
presentations.batchUpdate
przykładowy kod pokazuje, jak używać parametru
DeleteTableRowRequest
metody usuwania szóstego wiersza. Następnie korzysta z funkcji
DeleteTableColumnRequest
usuwania czwartej kolumny. Tabelę określa parametr
TABLE_ID Zarówno rowIndex, jak i columnIndex w sekcji
Liczby 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żej
presentations.batchUpdate
przykładowy kod pokazuje, jak używać parametru
DeleteTextRequest
metody usuwania całego tekstu z komórki w
textRange. it
korzysta z funkcji
InsertTextRequest
, aby zastąpić go nowym tekstem „Kangaroo”.
Tabelę określa parametr TABLE_ID. Komórka, której dotyczy problem, znajduje się w:
piąty wiersz i trzecia kolumna. Zarówno rowIndex, jak i columnIndex w obrębie
Liczby 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żej
presentations.batchUpdate
przykładowy kod pokazuje, jak używać parametru
UpdateTableCellPropertiesRequest
do formatowania wiersza nagłówka elementu tabeli w obrębie
tableRange,
określone przez TABLE_ID. Następnie korzysta z funkcji
TableCellProperties
aby ustawić czarny kolor tła wiersza nagłówka.
Każde poniższe żądanie używa parametru
UpdateTextStyleRequest
metoda ustawiania formatu tekstu w jednej komórce wiersza nagłówka na pogrubienie, biały 18-punktowy
Czcionka Cambria w
textRange Ty
musisz powtórzyć tę czynność dla każdej kolejnej komórki nagłówka.
Zarówno rowIndex, jak i columnIndex w: location oraz
Wartości cellLocation są liczone od zera.
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
Poniżej
presentations.batchUpdate
przykładowy kod pokazuje, jak używać parametru
InsertTableRowsRequest
dodawania 3 wierszy poniżej szóstego wiersza. Wykorzystuje ona wtedy
InsertTableColumnsRequest
dodaj dwie kolumny po lewej stronie czwartej kolumny w tej samej tabeli.
Tabelę określa parametr TABLE_ID. Zarówno rowIndex, jak i
Argument columnIndex w kolumnie cellLocation jest liczony 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
}
}
]
}