Operazioni tabella

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 ulteriori informazioni 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. Quindi utilizza 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. Quindi utilizza 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:

Formatta il risultato della formula della riga di intestazione.

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. Quindi utilizza 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
      }
    }
  ]
}