L'API Presentazioni Google consente di creare e modificare tabelle sulle pagine. Gli esempi in questa pagina mostrano alcune operazioni delle tabelle comuni utilizzando il metodo presentations.batchUpdate.
Questi esempi utilizzano le seguenti variabili:
- PRESENTATION_ID: indica dove fornisci l'ID presentazione. Puoi scoprire il valore di questo ID dall'URL della presentazione.
- PAGE_ID: indica dove fornisci gli ID oggetto della pagina. Puoi recuperare il relativo valore dall'URL o utilizzando una richiesta di lettura dell'API.
- TABLE_ID: indica dove fornisci l'ID oggetto dell'elemento di pagina per una tabella in uso. Puoi specificare questo ID per gli elementi che crei (con alcune limitazioni) o consentire all'API Presentazioni di crearne uno automaticamente. Gli ID degli elementi possono essere recuperati tramite una richiesta di lettura dell'API.
Questi esempi sono presentati come richieste HTTP per essere neutrali di lingua. Per informazioni su come implementare un aggiornamento batch in lingue diverse utilizzando le librerie client dell'API di Google, consulta Aggiungere forme e testo.
Creare una tabella
Il seguente esempio di codice di presentations.batchUpdate mostra come utilizzare il metodo CreateTableRequest per aggiungere una tabella a una slide specificata dal PAGE_ID.
Questa tabella ha 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 centrata approssimativamente sulla slide e dimensionata in modo da 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
}
}
]
}
Elimina righe o colonne di una tabella
Il seguente esempio di codice di 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 da TABLE_ID. Sia rowIndex che columnIndex all'interno di
cellLocation sono in base zero.
Di seguito è riportato il protocollo di richiesta per eliminare righe o colonne di una 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 di presentations.batchUpdate mostra come utilizzare il metodo DeleteTextRequest per rimuovere tutto il testo in una cella all'interno di textRange. Poi 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 in 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
Il seguente esempio di codice di presentations.batchUpdate mostra come utilizzare il metodo UpdateTableCellPropertiesRequest per formattare la riga di intestazione di un elemento della tabella, all'interno del campo tableRange specificato dal TABLE_ID. Successivamente, 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 in una cella della riga di intestazione sul carattere Cambria in grassetto bianco da 18 pt all'interno di textRange. Devi quindi ripetere questa richiesta per ogni cella aggiuntiva dell'intestazione.
Sia rowIndex che columnIndex all'interno di location e
cellLocation sono in 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 l'aspetto della riga di intestazione formattata dopo questi aggiornamenti:
Inserisci righe o colonne di tabella
Il seguente esempio di codice di presentations.batchUpdate mostra come utilizzare il metodo InsertTableRowsRequest per aggiungere tre righe sotto la sesta riga. Poi 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 in base 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
}
}
]
}