- Żądanie HTTP
- Parametry ścieżki
- Treść żądania
- Treść odpowiedzi
- Zakresy autoryzacji
- DataFilterValueRange
- UpdateValuesByDataFilterResponse
- Wypróbuj
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 |
Identyfikator arkusza kalkulacyjnego do zaktualizowania. |
Treść żądania
Treść żądania zawiera dane o następującej strukturze:
Zapis JSON |
---|
{ "valueInputOption": enum ( |
Pola | |
---|---|
valueInputOption |
Sposób interpretacji danych wejściowych. |
data[] |
Nowe wartości, które zostaną zastosowane w arkuszu kalkulacyjnym. Jeśli określona wartość |
includeValuesInResponse |
Określa, czy odpowiedź powinna zawierać wartości zaktualizowanych komórek. Domyślnie odpowiedzi nie zawierają zaktualizowanych wartości. Pole |
responseValueRenderOption |
Określa sposób renderowania wartości w odpowiedzi. Domyślna opcja renderowania to |
responseDateTimeRenderOption |
Określa sposób wyświetlania dat, godzin i czasów trwania odpowiedzi. Ta wartość jest ignorowana, jeśli |
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 ( |
Pola | |
---|---|
spreadsheetId |
Arkusz kalkulacyjny, do którego zostały zastosowane aktualizacje. |
totalUpdatedRows |
Łączna liczba wierszy, w których zaktualizowano co najmniej 1 komórkę. |
totalUpdatedColumns |
Łączna liczba kolumn, w których zaktualizowano co najmniej 1 komórkę. |
totalUpdatedCells |
Łączna liczba zaktualizowanych komórek. |
totalUpdatedSheets |
Łączna liczba arkuszy, w których zaktualizowano co najmniej jedną komórkę. |
responses[] |
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 ( |
Pola | |
---|---|
dataFilter |
Filtr danych opisujący lokalizację wartości w arkuszu kalkulacyjnym. |
majorDimension |
Główny wymiar wartości. |
values[] |
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 ( |
Pola | |
---|---|
updatedRange |
Zakres (w notacji A1), w którym zostały zastosowane aktualizacje. |
updatedRows |
Liczba wierszy, w których zaktualizowano co najmniej 1 komórkę. |
updatedColumns |
Liczba kolumn, w których zaktualizowano co najmniej 1 komórkę. |
updatedCells |
Liczba zaktualizowanych komórek. |
dataFilter |
Filtr danych, który wybrał zaktualizowany zakres. |
updatedData |
Wartości komórek w zakresie zgodne z filtrem dataFilter po zastosowaniu wszystkich aktualizacji. Uwzględnione są tylko wtedy, gdy pole |