Method: spreadsheets.batchUpdate

Stosuje co najmniej jedną aktualizację arkusza kalkulacyjnego.

Każdy request jest sprawdzany przed zastosowaniem. Jeśli któreś z żądań jest nieprawidłowe, nie powiedzie się żadne żądanie.

Niektóre żądania zawierają dane replies, które zawierają informacje o tym, jak je stosujemy. Odpowiedzi będą odzwierciedlać żądania. Jeśli na przykład zastosowałeś 4 aktualizacje, a trzecia miała odpowiedź, wtedy odpowiedź będzie miała 2 puste odpowiedzi, faktyczną i kolejną pustą odpowiedź w tej kolejności.

Ze względu na charakter arkusza kalkulacyjnego nie gwarantujemy, że po jego zakończeniu zmiany będą dokładnie odzwierciedlać zmiany, ale gwarantujemy, że aktualizacje w żądaniu zostaną zastosowane atomowo. Zmiany mogą dotyczyć zmian wprowadzanych przez współpracowników. Jeśli nie ma współpracowników, arkusz kalkulacyjny powinien odzwierciedlać 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, do którego chcesz zastosować aktualizacje.

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, które zostaną zastosowane w arkuszu kalkulacyjnym. Żądania będą stosowane w określonej kolejności. Jeśli któreś z żądań jest nieprawidłowe, nie są one stosowane.
includeSpreadsheetInResponse

boolean

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

string

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

boolean

Wartość to „prawda”, jeśli mają być zwracane dane siatki. Ma 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 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 zostały zastosowane aktualizacje.
replies[]

object (Response)

Odpowiedź na aktualizacje. Odpowiada on mapom 1:1 zawierającym aktualizacje, chociaż odpowiedzi na niektóre żądania mogą być puste.
updatedSpreadsheet

object (Spreadsheet)

Arkusz kalkulacyjny po zastosowaniu aktualizacji. Tę wartość ustawia się 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 po autoryzacji.