Method: spreadsheets.values.batchUpdateByDataFilter

Ustawia wartości w co najmniej 1 zakresie arkusza kalkulacyjnego. Więcej informacji znajdziesz w artykule Odczytywanie, zapisywanie i wyszukiwanie metadanych.

Dzwoniący musi podać identyfikator arkusza kalkulacyjnego, znak valueInputOption i co najmniej 1 znak DataFilterValueRanges.

Żądanie HTTP

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

Adres URL używa składni transkodowania gRPC.

Parametry ścieżki

Parametry
spreadsheetId

string

Identyfikator arkusza kalkulacyjnego do zaktualizowania.

Treść żądania

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

Zapis JSON 
{
  "valueInputOption": enum (ValueInputOption),
  "data": [
    {
      object (DataFilterValueRange)
    }
  ],
  "includeValuesInResponse": boolean,
  "responseValueRenderOption": enum (ValueRenderOption),
  "responseDateTimeRenderOption": enum (DateTimeRenderOption)
}
Pola
valueInputOption

enum (ValueInputOption)

Określa sposób interpretacji danych wejściowych.
data[]

object (DataFilterValueRange)

Nowe wartości, które mają zostać zastosowane w arkuszu kalkulacyjnym. Jeśli określony znak DataFilter pasuje do więcej niż jednego zakresu, określone wartości są stosowane do wszystkich tych zakresów.
includeValuesInResponse

boolean

Określa, czy odpowiedź na aktualizację powinna zawierać wartości zaktualizowanych komórek. Domyślnie odpowiedzi nie zawierają zaktualizowanych wartości. Pole updatedData w każdym z BatchUpdateValuesResponse.responses zawiera zaktualizowane wartości. Jeśli zakres do zapisu był większy niż zakres faktycznie zapisany, odpowiedź zawiera wszystkie wartości z żądanego zakresu (z wyjątkiem końcowych pustych wierszy i kolumn).
responseValueRenderOption

enum (ValueRenderOption)

Określa sposób renderowania wartości w odpowiedzi. Domyślna opcja renderowania to FORMATTED_VALUE.
responseDateTimeRenderOption

enum (DateTimeRenderOption)

Określa sposób renderowania dat, godzin i czasu trwania w odpowiedzi. Jest to ignorowane, jeśli responseValueRenderOption ma wartość FORMATTED_VALUE. Domyślna opcja renderowania daty i godziny to SERIAL_NUMBER.

Treść odpowiedzi

Odpowiedź podczas aktualizowania zakresu wartości w arkuszu kalkulacyjnym.

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

Zapis JSON 
{
  "spreadsheetId": string,
  "totalUpdatedRows": integer,
  "totalUpdatedColumns": integer,
  "totalUpdatedCells": integer,
  "totalUpdatedSheets": integer,
  "responses": [
    {
      object (UpdateValuesByDataFilterResponse)
    }
  ]
}
Pola
spreadsheetId

string

Arkusz kalkulacyjny, w którym zastosowano aktualizacje.
totalUpdatedRows

integer

Łączna liczba wierszy, w których zaktualizowano co najmniej 1 komórkę.
totalUpdatedColumns

integer

Łączna liczba kolumn, w których zaktualizowano co najmniej 1 komórkę.
totalUpdatedCells

integer

Łączna liczba zaktualizowanych komórek.
totalUpdatedSheets

integer

Łączna liczba arkuszy, w których zaktualizowano co najmniej 1 komórkę.
responses[]

object (UpdateValuesByDataFilterResponse)

Odpowiedź dla każdego zakresu zostanie zaktualizowana.

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.

DataFilterValueRange

Zakres wartości, którego lokalizacja jest określona przez DataFilter.

Zapis JSON 
{
  "dataFilter": {
    object (DataFilter)
  },
  "majorDimension": enum (Dimension),
  "values": [
    array
  ]
}
Pola
dataFilter

object (DataFilter)

Filtr danych opisujący lokalizację wartości w arkuszu kalkulacyjnym.
majorDimension

enum (Dimension)

Główny wymiar wartości.
values[]

array (ListValue format)

Dane do zapisania. Jeśli podane wartości przekraczają którykolwiek z zakresów pasujących do filtra danych, żądanie nie powiedzie się. Jeśli podane wartości są mniejsze niż dopasowane zakresy, zapisywane są tylko określone wartości, a istniejące wartości w dopasowanych zakresach pozostają bez zmian.

UpdateValuesByDataFilterResponse

Odpowiedź podczas aktualizowania zakresu wartości za pomocą filtra danych w arkuszu kalkulacyjnym.

Zapis JSON 
{
  "updatedRange": string,
  "updatedRows": integer,
  "updatedColumns": integer,
  "updatedCells": integer,
  "dataFilter": {
    object (DataFilter)
  },
  "updatedData": {
    object (ValueRange)
  }
}
Pola
updatedRange

string

Zakres (w notacji A1), do którego zastosowano aktualizacje.
updatedRows

integer

Liczba wierszy, w których zaktualizowano co najmniej 1 komórkę.
updatedColumns

integer

Liczba kolumn, w których zaktualizowano co najmniej 1 komórkę.
updatedCells

integer

Liczba zaktualizowanych komórek.
dataFilter

object (DataFilter)

Filtr danych, który wybrał zaktualizowany zakres.
updatedData

object (ValueRange)

Wartości komórek w zakresie pasującym do elementu dataFilter po zastosowaniu wszystkich aktualizacji. Jest ono uwzględniane tylko wtedy, gdy pole includeValuesInResponse w żądaniu ma wartość true.