Method: spreadsheets.values.batchUpdateByDataFilter

Ustawia wartości w co najmniej jednym zakresie arkusza kalkulacyjnego. Element wywołujący musi zawierać identyfikator arkusza kalkulacyjnego, obiekt valueInputOption i co najmniej jeden element 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)

Sposób interpretacji danych wejściowych.

data[]

object (DataFilterValueRange)

Nowe wartości, które zostaną zastosowane w arkuszu kalkulacyjnym. Jeśli określona wartość 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ź powinna zawierać wartości zaktualizowanych komórek. Domyślnie odpowiedzi nie zawierają zaktualizowanych wartości. Pole updatedData w każdym elemencie BatchUpdateValuesResponse.responses zawiera zaktualizowane wartości. Jeśli zakres zapisu jest większy niż rzeczywisty zakres, odpowiedź zawiera wszystkie wartości z żądanego zakresu (z wyjątkiem 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 wyświetlania dat, godzin i czasów trwania odpowiedzi. Ta wartość jest ignorowana, jeśli responseValueRenderOption ma wartość FORMATTED_VALUE. Domyślna opcja renderowania dateTime 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, do którego zostały zastosowane 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 jedną komórkę.

responses[]

object (UpdateValuesByDataFilterResponse)

Odpowiedź dla każdego zakresu została 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.

Zakres_wartości filtra

Zakres wartości, których lokalizację określa właściwość 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ą dowolny z zakresów ustawionych przez filtr danych, żądanie zakończy się niepowodzeniem. Jeśli podane wartości są mniejsze niż dopasowane zakresy, zapisywane są tylko określone wartości. Nie ma to wpływu na istniejące wartości w dopasowanych zakresach.

Aktualizuj wartość filtra danych według treści

Odpowiedź podczas aktualizowania zakresu wartości przez filtr 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), w którym zostały zastosowane 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 zgodne z filtrem dataFilter po zastosowaniu wszystkich aktualizacji. Uwzględnione są tylko wtedy, gdy pole includeValuesInResponse żądania miało wartość true.