Method: spreadsheets.batchUpdate

Powoduje zastosowanie do arkusza kalkulacyjnego co najmniej jednej aktualizacji.

Każdy element typu request jest weryfikowany przed zastosowaniem. Jeśli któreś żądanie jest nieprawidłowe, całe żądanie zakończy się niepowodzeniem i nic nie zostanie zastosowane.

W przypadku niektórych żądań replies informuje o sposobie ich stosowania. Odpowiedzi będą odzwierciedlać te żądania. Jeśli na przykład zastosujesz 4 aktualizacje, a na trzecia była już odpowiedź, odpowiedź będzie zawierać 2 puste odpowiedzi, faktyczną odpowiedź i drugą w tej kolejności pustą odpowiedź.

Ze względu na to, że arkusze kalkulacyjne zapewniają możliwość współpracy, nie możemy zagwarantować, że wprowadzone zmiany zostaną dokładnie odzwierciedlone w arkuszu kalkulacyjnym. Pamiętaj jednak, że zmiany w żądaniu zostaną zastosowane atomowo. Twoje zmiany mogą zostać zmienione zgodnie ze zmianami dotyczącymi współpracowników. Jeśli nie ma współpracowników, wprowadzone zmiany powinny być odzwierciedlone w arkuszu kalkulacyjnym.

Żą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, do której chcesz zastosować 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 aktualizacji, które mają zostać zastosowane do arkusza kalkulacyjnego. Żądania będą stosowane w kolejności, w jakiej zostały określone. Jeśli któreś z żądań jest nieprawidłowe, nie są stosowane.
includeSpreadsheetInResponse

boolean

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

string

Ogranicza zakresy w arkuszu odpowiedzi. Znaczenie tylko wtedy, gdy includeSpreadsheetInResponse ma wartość „true” (prawda).
responseIncludeGridData

boolean

Prawda, jeśli dane siatki mają być zwracane. Znaczenie tylko wtedy, gdy includeSpreadsheetInResponse ma wartość „true” (prawda). Ten parametr jest ignorowany, jeśli w żądaniu ustawiono maskę pola.

Treść odpowiedzi

Odpowiedź dotycząca zbiorczej aktualizacji 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. Wynika to z tego 1:1 na podstawie aktualizacji, chociaż odpowiedzi na niektóre prośby mogą być puste.
updatedSpreadsheet

object (Spreadsheet)

Arkusz kalkulacyjny po zastosowaniu aktualizacji. Ta wartość jest ustawiona 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 na temat autoryzacji.