Operazioni tabella

L'API Google Slides consente di creare e modificare tabelle nelle pagine. Gli esempi in questa pagina mostrano alcune operazioni comuni sulle tabelle che utilizzano il metodo presentations.batchUpdate.

Questi esempi utilizzano le seguenti variabili:

  • PRESENTATION_ID: indica dove fornire l'ID presentazione. Puoi scoprire il valore di questo ID dall'URL della presentazione.
  • PAGE_ID: indica dove specificare gli ID oggetto pagina. Puoi recuperare il valore dall'URL o utilizzando una richiesta di lettura dell'API.
  • TABLE_ID: indica dove fornire l'ID oggetto elemento pagina per una tabella con cui stai lavorando. Puoi specificare questo ID per gli elementi che crei (con alcune limitazioni) o consentire all'API Slides di crearne uno automaticamente. Gli ID elemento possono essere recuperati tramite una richiesta di lettura dell'API.

Questi esempi sono presentati come richieste HTTP per essere indipendenti dalla lingua. Per scoprire come implementare un aggiornamento collettivo in lingue diverse utilizzando le librerie client dell'API Google, consulta Aggiungere forme e testo.

Creare una tabella

Il seguente presentations.batchUpdate esempio di codice mostra come utilizzare il metodo CreateTableRequest per aggiungere una tabella a una diapositiva specificata da PAGE_ID.

Questa tabella contiene otto righe e cinque colonne. Tieni presente che l'API Slides ignora i campi size o transform forniti nell'ambito di elementProperties. L'API crea invece una tabella approssimativamente centrata sulla diapositiva e le dimensioni vengono adattate in base al 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 presentations.batchUpdate esempio di codice mostra come utilizzare il metodo DeleteTableRowRequest per rimuovere la sesta riga. Poi utilizza il metodo DeleteTableColumnRequest per rimuovere la quarta colonna. La tabella è specificata da TABLE_ID. Sia rowIndex che columnIndex all'interno di cellLocation hanno come base zero.

Di seguito è riportato il protocollo di richiesta per eliminare righe o colonne di tabelle:

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
        }
      }
    }
  ]
}

Modificare i dati della tabella

Il seguente presentations.batchUpdate esempio di codice mostra come utilizzare il metodo DeleteTextRequest per rimuovere tutto il testo in una cella all'interno del textRange. Quindi utilizza il metodo InsertTextRequest per sostituirlo con il nuovo testo "Canguro".

La tabella è specificata da TABLE_ID. La cella interessata si trova nella quinta riga e nella terza colonna. Sia rowIndex che columnIndex all'interno di cellLocation hanno come 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 una riga di intestazione della tabella

Il seguente presentations.batchUpdate esempio di codice mostra come utilizzare il metodo UpdateTableCellPropertiesRequest per formattare la riga di intestazione di un elemento della tabella, all'interno del tableRange, specificato da TABLE_ID. Quindi utilizza il metodo TableCellProperties per impostare il colore di sfondo della riga di intestazione su nero.

Ogni richiesta successiva utilizza il metodo UpdateTextStyleRequest per impostare il formato del testo in una cella della riga di intestazione su carattere Cambria in grassetto, bianco e 18 punti all'interno di textRange. Poi devi ripetere questa richiesta per ogni cella aggiuntiva nell'intestazione.

Sia rowIndex che columnIndex all'interno di location e cellLocation hanno come 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 si presenta la riga di intestazione formattata dopo questi aggiornamenti:

Formatta il risultato della ricetta della riga di intestazione.

Inserire righe o colonne di tabelle

Il seguente presentations.batchUpdate esempio di codice 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 da TABLE_ID. Sia rowIndex che columnIndex all'interno di cellLocation hanno come base zero.

Di seguito è riportato il protocollo di richiesta per inserire righe o colonne di tabelle:

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
      }
    }
  ]
}