Method: spreadsheets.batchUpdate

Zastosuj co najmniej jedną zmianę w arkuszu kalkulacyjnym.

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 stosowania. Odpowiedzi będą odzwierciedlały żą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 potem właściwą odpowiedź.

Ze względu na współpracę nad arkuszami kalkulacyjnymi nie możemy zagwarantować, że po zakończeniu procesu arkusz kalkulacyjny będzie odzwierciedlał dokładnie 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 żądanie 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 z odpowiedziami. Ma znaczenie tylko wtedy, gdy includeSpreadsheetInResponse ma wartość „true”.
responseIncludeGridData

boolean

Wartość „prawda”, jeśli mają zostać zwrócone dane siatki. Ma znaczenie tylko wtedy, gdy includeSpreadsheetInResponse ma wartość „true”. Ten parametr jest ignorowany, jeśli w żądaniu została ustawiona maska 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, w którym zastosowano aktualizacje.
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. Ta wartość jest ustawiana tylko wtedy, gdy BatchUpdateSpreadsheetRequest.include_spreadsheet_in_response ma wartość true.

Zakresy autoryzacji

Wymaga jednego z tych zakresów 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.