L'API Presentazioni Google consente di creare e modificare tabelle nelle pagine. Gli esempi su
questa pagina mostra alcune operazioni di tabella comuni utilizzando
presentations.batchUpdate
.
In questi esempi vengono utilizzate le seguenti variabili:
- PRESENTATION_ID: indica dove fornisci presentazione ID. Puoi il valore per questo ID dall'URL della presentazione.
- PAGE_ID: indica dove fornisci l'oggetto pagina ID. Puoi recuperare il valore dall'URL o utilizzando una richiesta di lettura API.
- TABLE_ID: indica dove fornisci la pagina ID oggetto Element per tabella con cui stai lavorando. Puoi specificare questo ID per gli elementi che crei (con alcune limitazioni) o consentire all'API Presentazioni di crearne una automaticamente. ID elemento può essere recuperato tramite una richiesta di lettura API.
Questi esempi vengono presentati come richieste HTTP per essere indipendenti dal linguaggio. Per apprendere come implementare un aggiornamento batch in lingue diverse utilizzando l'API di Google librerie client, consulta l'articolo Aggiungere forme testo.
Creare una tabella
Le seguenti
presentations.batchUpdate
l'esempio di codice mostra come utilizzare
CreateTableRequest
per aggiungere una tabella a una slide specificata dal PAGE_ID.
Questa tabella contiene otto righe e cinque colonne. Tieni presente che l'API Presentazioni
ignora eventuali campi size o transform forniti nell'ambito della
elementProperties
L'API crea invece una tabella che è più o meno centrata sulla slide e
e, se possibile, in base al numero specificato di righe e colonne.
Di seguito è riportato il protocollo di richiesta per creare una tabella:
POST https://slides.googleapis.com/v1/presentations/PRESENTATION_ID:batchUpdate
{
"requests": [
{
"createTable": {
"objectId": TABLE_ID,
"elementProperties": {
"pageObjectId": PAGE_ID,
},
"rows": 8,
"columns": 5
}
}
]
}
Eliminare righe o colonne di una tabella
Le seguenti
presentations.batchUpdate
l'esempio di codice mostra come utilizzare
DeleteTableRowRequest
per rimuovere la sesta riga. Utilizza quindi
DeleteTableColumnRequest
per rimuovere la quarta colonna. La tabella viene specificata dal
TABLE_ID. Sia il rowIndex che il columnIndex all'interno
cellLocation sono su base zero.
Di seguito è riportato il protocollo di richiesta per eliminare le righe o le colonne della tabella:
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
}
}
}
]
}
Modifica dati tabella
Le seguenti
presentations.batchUpdate
l'esempio di codice mostra come utilizzare
DeleteTextRequest
per rimuovere tutto il testo in una cella all'interno
textRange it
utilizza
InsertTextRequest
per sostituirlo con il nuovo testo "Kangaroo".
La tabella è specificata dal valore TABLE_ID. La cella interessata si trova in
la quinta riga e la terza colonna. Sia il rowIndex che il columnIndex all'interno
i cellLocation sono su base zero.
Di seguito è riportato il protocollo di richiesta per modificare i dati della tabella:
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
}
}
]
}
Formattare la riga di intestazione di una tabella
Le seguenti
presentations.batchUpdate
l'esempio di codice mostra come utilizzare
UpdateTableCellPropertiesRequest
per formattare la riga di intestazione di un elemento della tabella, all'interno del
tableRange,
specificato dal TABLE_ID. Utilizza quindi
TableCellProperties
per impostare su nero il colore di sfondo della riga di intestazione.
Ogni richiesta seguente utilizza
UpdateTextStyleRequest
per impostare il formato del testo di una cella della riga di intestazione su grassetto, bianco 18 pt
Cambria all'interno del
textRange. Tu
poi ripetere la richiesta per ogni cella aggiuntiva nell'intestazione.
Sia il rowIndex che il columnIndex all'interno dei location e
cellLocation sono su base zero.
Di seguito è riportato il protocollo di richiesta per formattare una riga di intestazione della tabella:
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....
]
}
Ecco come appare la riga di intestazione formattata dopo questi aggiornamenti:
Inserisci righe o colonne di tabella
Le seguenti
presentations.batchUpdate
l'esempio di codice mostra come utilizzare
InsertTableRowsRequest
per aggiungere tre righe sotto la sesta riga. Utilizza quindi
InsertTableColumnsRequest
per aggiungere due colonne a sinistra della quarta colonna nella stessa tabella.
La tabella è specificata dal valore TABLE_ID. Sia rowIndex che
i columnIndex all'interno di cellLocation sono basati su zero.
Di seguito è riportato il protocollo di richiesta per inserire righe o colonne di tabella:
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
}
}
]
}