Method: spreadsheets.batchUpdate

Wendet mindestens eine Aktualisierung auf die Tabelle an.

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

Für einige Anfragen sind replies erforderlich, um Informationen zu ihrer Anwendung zu erhalten. Die Antworten spiegeln die Anfragen wider. Wenn Sie beispielsweise vier Änderungen vorgenommen haben und die dritte eine Antwort hatte, enthält die Antwort zwei leere Antworten, die eigentliche Antwort und eine weitere leere Antwort in dieser Reihenfolge.

Aufgrund des kollaborativen Charakters von Tabellen ist nicht garantiert, dass die Tabelle Ihre Änderungen nach Abschluss dieses Vorgangs genau widerspiegelt. Es ist jedoch garantiert, dass die Aktualisierungen in der Anfrage gemeinsam atomar angewendet werden. Ihre Änderungen werden möglicherweise im Hinblick auf Änderungen von Mitbearbeitern geändert. Wenn es keine Mitbearbeiter gibt, 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

Bestimmt, ob die Aktualisierungsantwort die Tabellenressource enthalten soll.
responseRanges[]

string

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

boolean

"True", wenn Rasterdaten zurückgegeben werden sollen. Dies ist nur sinnvoll, wenn includeSpreadsheetInResponse „true“ 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 auf die Aktualisierungen. Dies entspricht 1:1 den Aktualisierungen, wobei auf einige Anfragen möglicherweise leer ist.
updatedSpreadsheet

object (Spreadsheet)

Die Tabelle nach den Aktualisierungen. Dieses Feld wird 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.