L'API Presentazioni Google consente di creare e modificare tabelle nelle pagine. Gli esempi in questa pagina mostrano alcune operazioni di tabella comuni che utilizzano il metodo presentations.batchUpdate.
In questi esempi vengono utilizzate le seguenti variabili:
- PRESENTATION_ID: indica dove fornisci l'ID presentazione. Puoi trovare il valore di questo ID nell'URL della presentazione.
- PAGE_ID: indica dove fornisci gli ID degli oggetti di pagina. Puoi recuperare il valore dall'URL o utilizzando una richiesta di lettura API.
- TABLE_ID: indica dove fornisci l'ID oggetto elemento della pagina per una tabella su cui stai lavorando. Puoi specificare questo ID per gli elementi che crei (con alcune limitazioni) o consentire all'API Presentazioni di crearne uno automaticamente. Gli ID elemento possono essere recuperati tramite una richiesta di lettura dell'API.
Questi esempi vengono presentati come richieste HTTP per essere indipendenti dal linguaggio. Per scoprire come implementare un aggiornamento batch in diversi linguaggi utilizzando le librerie client dell'API di Google, consulta Aggiungere forme e testo.
Creare una tabella
Il seguente esempio di codice presentations.batchUpdate mostra come utilizzare il metodo CreateTableRequest per aggiungere una tabella a una slide specificata da PAGE_ID.
Questa tabella contiene otto righe e cinque colonne. Tieni presente che l'API Presentazioni ignora eventuali campi size o transform forniti come parte di elementProperties.
L'API crea invece una tabella che è più o meno centrata sulla slide e che è dimensionata per contenere il numero specificato di righe e colonne, se possibile.
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
Il seguente esempio di codice per presentations.batchUpdate mostra come utilizzare il metodo DeleteTableRowRequest per rimuovere la sesta riga. Quindi utilizza il metodo DeleteTableColumnRequest per rimuovere la quarta colonna. La tabella è specificata dal
TABLE_ID. Sia rowIndex che columnIndex all'interno di
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
Il seguente esempio di codice per presentations.batchUpdate mostra come utilizzare il metodo DeleteTextRequest per rimuovere tutto il testo in una cella all'interno di textRange. Dopodiché utilizza il metodo InsertTextRequest per sostituirlo con il nuovo testo "Kangaroo".
La tabella è specificata dal valore TABLE_ID. La cella interessata si trova
nella quinta riga e nella terza colonna. Sia rowIndex che columnIndex all'interno
di cellLocation sono basati su 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
Il seguente esempio di codice presentations.batchUpdate mostra come utilizzare il metodo UpdateTableCellPropertiesRequest per formattare la riga di intestazione di un elemento della tabella, all'interno di tableRange, specificata dal TABLE_ID. Dopodiché utilizza il metodo TableCellProperties per impostare su nero il colore di sfondo della riga di intestazione.
Ogni richiesta seguente utilizza il metodo UpdateTextStyleRequest per impostare il formato del testo di una cella della riga di intestazione sul carattere Cambria in grassetto bianco da 18 pt all'interno di textRange. Devi
ripetere questa richiesta per ogni cella aggiuntiva nell'intestazione.
Sia rowIndex che columnIndex all'interno di location e
cellLocation sono basati su 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
Il seguente esempio di codice per presentations.batchUpdate mostra come utilizzare il metodo InsertTableRowsRequest per aggiungere tre righe sotto la sesta riga. Quindi utilizza il metodo InsertTableColumnsRequest per aggiungere due colonne a sinistra della quarta colonna nella stessa tabella.
La tabella è specificata dal valore TABLE_ID. Sia rowIndex che
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
}
}
]
}