Method: spreadsheets.batchUpdate

Wendet eine oder mehrere Aktualisierungen auf die Tabelle an.

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

Einige Anfragen enthalten replies, damit Sie wissen, wie sie angewendet werden. Die Antworten spiegeln die Anfragen wider. Wenn Sie beispielsweise vier Aktualisierungen angewendet haben und die dritte eine Antwort hatte, enthält die Antwort zwei leere Antworten, die tatsächliche Antwort und eine weitere leere Antwort in dieser Reihenfolge.

Aufgrund der Zusammenarbeit bei Tabellen kann nicht garantiert werden, dass die Tabelle nach Abschluss des Vorgangs exakt Ihre Änderungen wiedergibt. Es ist jedoch garantiert, dass die Aktualisierungen in der Anfrage in kleinstmöglichen Schritten zusammen angewendet werden. Ihre Änderungen können auch von Mitbearbeitern berücksichtigt werden. Wenn es keine Mitbearbeiter gibt, sollten die Änderungen in der Tabelle widergespiegelt werden.

HTTP-Anfrage

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

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
spreadsheetId

string

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 in der 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 Updateantwort die Tabellenkalkulationsressource enthalten soll.
responseRanges[]

string

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

boolean

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

Antworttext

Die Antwort für die Batch-Aktualisierung einer Tabelle.

Wenn der Vorgang erfolgreich ist, enthält der Antworttext Daten mit folgender Struktur:

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

string

Tabelle, auf die die Aktualisierungen angewendet wurden
replies[]

object (Response)

Die Antwort auf die Updates. Dies entspricht der 1:1-Beziehung mit den Aktualisierungen, wobei die Antworten auf einige Anfragen möglicherweise leer sein können.
updatedSpreadsheet

object (Spreadsheet)

Die Tabelle, nachdem die Änderungen übernommen wurden. 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.