Method: spreadsheets.batchUpdate

Wendet eine oder mehrere Aktualisierungen auf die Tabelle an.

Jede request muss vor der Anwendung validiert werden. Wenn eine Anfrage ungültig ist, schlägt die gesamte Anfrage fehl und es wird nichts angewendet.

Bei einigen Anfragen gibt es replies, um Ihnen Informationen zur Anwendung zu geben. Die Antworten spiegeln die Anfragen wider. Wenn Sie beispielsweise vier Aktualisierungen angewendet haben und beim dritten eine Antwort gab, wurden in der Antwort zwei leere Antworten, die tatsächliche Antwort und eine weitere leere Antwort in dieser Reihenfolge angezeigt.

Da die Tabellen gemeinsam bearbeitet werden, ist nicht garantiert, dass die Tabelle Ihre Änderungen nach der Fertigstellung enthält. Die Aktualisierungen in der Anfrage werden jedoch atomar angewendet. Ihre Änderungen können im Hinblick auf Änderungen der Mitbearbeiter geändert werden. Wenn keine Mitbearbeiter vorhanden sind, sollten Ihre Änderungen in der Tabelle angezeigt werden.

HTTP-Anfrage

POST https://sheets.googleapis.com/v4/spreadsheets/{spreadsheetId}:batchUpdate

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
spreadsheetId

string

Die Tabelle, auf die die Aktualisierungen angewendet werden sollen.

Anfragetext

Der Anfragetext enthält Daten mit folgender Struktur:

JSON-Darstellung 
{
  "requests": [
    {
      object (Request)
    }
  ],
  "includeSpreadsheetInResponse": boolean,
  "responseRanges": [
    string
  ],
  "responseIncludeGridData": boolean
}
Felder
requests[]

object (Request)

Eine Liste der Aktualisierungen, die auf die Tabelle angewendet werden sollen. Anfragen werden in der angegebenen Reihenfolge angewendet. Wenn eine Anfrage ungültig ist, werden keine Anfragen angewendet.
includeSpreadsheetInResponse

boolean

Legt fest, ob die Updateantwort die Tabellenressource enthalten soll.
responseRanges[]

string

Beschränkt die in der Antworttabelle enthaltenen Bereiche. Dies ist nur sinnvoll, wenn includeSpreadsheetInResponse auf „true“ gesetzt ist.
responseIncludeGridData

boolean

Dieser Wert ist „true“, wenn Rasterdaten zurückgegeben werden sollen. Dies ist nur sinnvoll, wenn includeSpreadsheetInResponse auf „true“ gesetzt ist. Dieser Parameter wird ignoriert, wenn in der Anfrage eine Feldmaske festgelegt wurde.

Antworttext

Die Antwort auf die Batch-Aktualisierung einer Tabelle.

Bei Erfolg enthält der Antworttext Daten mit der folgenden Struktur:

JSON-Darstellung 
{
  "spreadsheetId": string,
  "replies": [
    {
      object (Response)
    }
  ],
  "updatedSpreadsheet": {
    object (Spreadsheet)
  }
}
Felder
spreadsheetId

string

Die Tabelle, auf die die Aktualisierungen angewendet wurden.
replies[]

object (Response)

Die Antwort zu den Updates. Diese Karte wird zu 1:1 zugeordnet und die Antworten können leer sein.
updatedSpreadsheet

object (Spreadsheet)

Die Tabelle, nachdem Aktualisierungen angewendet wurden. Dies ist nur festgelegt, wenn BatchUpdateSpreadsheetRequest.include_spreadsheet_in_response den Wert true hat.

Autorisierungsbereiche

Erfordert einen der folgenden OAuth-Bereiche:

  • https://www.googleapis.com/auth/drive
  • https://www.googleapis.com/auth/drive.file
  • https://www.googleapis.com/auth/spreadsheets

Weitere Informationen finden Sie im Leitfaden zur Autorisierung.