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 werden keine Änderungen vorgenommen.

Einige Anfragen haben replies, um Ihnen Informationen zur Anwendung zu geben. Die Antworten spiegeln die Anfragen wider. Wenn Sie beispielsweise vier Updates angewendet haben und die dritte Antwort enthält, enthält die Antwort in dieser Reihenfolge zwei leere Antworten, die eigentliche Antwort und eine weitere leere Antwort.

Da es sich bei Tabellen um Gruppendokumente handelt, ist nicht garantiert, dass die Tabelle nach Abschluss der Änderungen genau Ihre Änderungen widerspiegelt. Es ist jedoch garantiert, dass die Aktualisierungen in der Anfrage gemeinsam und atomar angewendet werden. Ihre Änderungen können sich aufgrund von Änderungen an Mitbearbeitern ändern. Wenn es keine Mitbearbeiter gibt, sollten Ihre Änderungen in der Tabelle zu sehen sein.

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 Änderungen 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 Änderungen, die auf die Tabelle angewendet werden sollen. Anfragen werden in der Reihenfolge angewendet, in der sie angegeben sind. Wenn eine Anfrage ungültig ist, werden keine Anfragen angewendet.
includeSpreadsheetInResponse

boolean

Bestimmt, ob die Antwort auf die Aktualisierung die Tabellenressource enthalten soll.
responseRanges[]

string

Begrenzt die Bereiche, die in der Antworttabelle enthalten sind. Nur sinnvoll, wenn includeSpreadsheetInResponse „wahr“ ist.
responseIncludeGridData

boolean

„True“, wenn Rasterdaten zurückgegeben werden sollen. Nur sinnvoll, wenn includeSpreadsheetInResponse „wahr“ ist. Dieser Parameter wird ignoriert, wenn in der Anfrage eine Feldmaske festgelegt wurde.

Antworttext

Die Antwort für die Batchaktualisierung 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 Änderungen angewendet wurden.
replies[]

object (Response)

Die Antwort auf die Aktualisierungen. Die Zuordnung erfolgt 1:1 mit den Updates, auch wenn die Antworten auf einige Anfragen leer sein können.
updatedSpreadsheet

object (Spreadsheet)

Die Tabelle nach der Anwendung der Updates. Dieser Wert wird nur festgelegt, wenn BatchUpdateSpreadsheetRequest.include_spreadsheet_in_response true ist.

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.