Method: spreadsheets.batchUpdate

Stosuje co najmniej jedną aktualizację w arkuszu kalkulacyjnym.

Każdy element 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 próśb opcja replies zawiera informacje o sposobie ich stosowania. Odpowiedzi będą odzwierciedlały żądania. Jeśli na przykład zastosujesz 4 aktualizacje, a trzecia ma odpowiedź, to będzie ona mieć 2 puste odpowiedzi – faktyczną i drugą pustą odpowiedź (w tej kolejności).

Ze względu na możliwość współpracy w arkuszach kalkulacyjnych nie można zagwarantować, że po zakończeniu operacji wprowadzone zmiany zostaną dokładnie odzwierciedlone w zmianach. Gwarantujemy jednak, że aktualizacje w żądaniu zostaną zastosowane atomowo. Twoje zmiany mogą zostać zmienione w zależności od zmian wprowadzonych przez współpracowników. Jeśli nie masz współpracowników, arkusz kalkulacyjny powinien zawierać wprowadzone 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 aktualizacji, które mają zostać zastosowane do arkusza kalkulacyjnego. Żądania będą stosowane w kolejności, w jakiej zostały podane. Jeśli jakieś żądanie jest nieprawidłowe, nie zostaną zastosowane żadne żądania.
includeSpreadsheetInResponse

boolean

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

string

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

boolean

Prawda, jeśli powinny zostać zwrócone dane siatki. Istotne 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 zaktualizowania 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. Aktualizacje są mapowane indywidualnie, chociaż odpowiedzi na niektóre prośby mogą być puste.
updatedSpreadsheet

object (Spreadsheet)

Arkusz kalkulacyjny po zastosowaniu aktualizacji. Tę wartość należy ustawić 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.