Method: spreadsheets.batchUpdate

Powoduje zastosowanie do arkusza kalkulacyjnego co najmniej jednej aktualizacji.

Każdy request jest weryfikowany przed zastosowaniem. Jeśli którekolwiek żądanie jest nieprawidłowe, cała prośba zostanie odrzucona i nie zostanie wprowadzona żadna zmiana.

Niektóre żądania mają przycisk replies, który zawiera informacje o sposobie ich zastosowania. Odpowiedzi będą odzwierciedlać te żądania. Jeśli na przykład zastosujesz 4 aktualizacje, a 3 z nich będą miały odpowiedź, odpowiedź będzie zawierać 2 puste odpowiedzi, a następnie rzeczywistą odpowiedź i jeszcze jedną pustą odpowiedź, w tej kolejności.

Ze względu na współpracę nad arkuszami kalkulacyjnymi nie możemy zagwarantować, że po zakończeniu procesu arkusz będzie dokładnie odzwierciedlał Twoje zmiany. Możemy jednak zagwarantować, że aktualizacje w żądaniu zostaną zastosowane łącznie w sposób atomowy. Twoje zmiany mogą zostać zmienione w zależności od zmian wprowadzonych przez współpracowników. Jeśli nie ma żadnych współpracowników, arkusz kalkulacyjny powinien odzwierciedlać Twoje zmiany.

Żądanie HTTP

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

Adres URL używa składni transkodowania gRPC.

Parametry ścieżki

Parametry
spreadsheetId

string

Arkusz kalkulacyjny, w którym mają zostać zastosowane zmiany.

Treść żądania

Treść żądania zawiera dane o następującej strukturze:

Zapis JSON 
{
  "requests": [
    {
      object (Request)
    }
  ],
  "includeSpreadsheetInResponse": boolean,
  "responseRanges": [
    string
  ],
  "responseIncludeGridData": boolean
}
Pola
requests[]

object (Request)

Lista zmian do zastosowania w arkuszu kalkulacyjnym. Zgłoszenia będą rozpatrywane w kolejności, w jakiej zostały podane. Jeśli którekolwiek z nich jest nieprawidłowe, żadne z nich nie zostanie zastosowane.
includeSpreadsheetInResponse

boolean

Określa, czy odpowiedź na aktualizację powinna zawierać zasób arkusza kalkulacyjnego.
responseRanges[]

string

Ogranicza zakresy uwzględnione w arkuszu kalkulacyjnym odpowiedzi. Ma znaczenie tylko wtedy, gdy parametr includeSpreadsheetInResponse ma wartość „true” (prawda).
responseIncludeGridData

boolean

Wartość Prawda, jeśli mają zostać zwrócone dane siatki. Ma znaczenie tylko wtedy, gdy parametr includeSpreadsheetInResponse ma wartość „true” (prawda). Ten parametr jest ignorowany, jeśli w żądaniu ustawiono maskę pola.

Treść odpowiedzi

Odpowiedź dotycząca zbiorczego aktualizowania arkusza kalkulacyjnego.

W przypadku powodzenia treść żądania zawiera dane o następującej strukturze:

Zapis JSON 
{
  "spreadsheetId": string,
  "replies": [
    {
      object (Response)
    }
  ],
  "updatedSpreadsheet": {
    object (Spreadsheet)
  }
}
Pola
spreadsheetId

string

Arkusz kalkulacyjny, do którego zastosowano zmiany.
replies[]

object (Response)

Odpowiedź na aktualizacje. Odpowiadają one 1:1 aktualizacjom, ale odpowiedzi na niektóre żądania mogą być puste.
updatedSpreadsheet

object (Spreadsheet)

Arkusz kalkulacyjny po zastosowaniu aktualizacji. Jest ona ustawiana tylko wtedy, gdy BatchUpdateSpreadsheetRequest.include_spreadsheet_in_response ma wartość true.

Zakresy autoryzacji

Wymaga jednego z tych zakresów protokołu OAuth:

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

Więcej informacji znajdziesz w przewodniku dotyczącym autoryzacji.