- Żą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 określić identyfikator arkusza kalkulacyjnego, element valueInputOption
i co najmniej 1 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 |
Jak należy interpretować dane wejściowe. |
data[] |
Nowe wartości, które zostaną zastosowane do arkusza kalkulacyjnego. Jeśli określony argument |
includeValuesInResponse |
Określa, czy odpowiedź dotycząca aktualizacji 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ślną opcją renderowania jest |
responseDateTimeRenderOption |
Określa sposób renderowania dat, godzin i czasu trwania odpowiedzi. Ta wartość jest ignorowana, jeśli |
Treść odpowiedzi
Odpowiedź wyświetlana 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 zastosowano zmiany. |
totalUpdatedRows |
Łączna liczba wierszy, w których co najmniej 1 komórka w wierszu została zaktualizowana. |
totalUpdatedColumns |
Łączna liczba kolumn, w których co najmniej 1 komórka w kolumnie została zaktualizowana. |
totalUpdatedCells |
Łączna liczba zaktualizowanych komórek. |
totalUpdatedSheets |
Łączna liczba arkuszy, w których co najmniej jedna komórka w arkuszu została zaktualizowana. |
responses[] |
Zaktualizowano odpowiedź dla każdego zakresu. |
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órych lokalizacja jest określana za pomocą atrybutu 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 zgodnych z filtrem danych, żądanie się nie powiedzie. Jeśli podane wartości są mniejsze niż dopasowane zakresy, zapisywane są tylko określone wartości, istniejące wartości w dopasowanych zakresach pozostają bez zmian. |
UpdateValuesByDataFilterResponse
Odpowiedź przy aktualizacji 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), do którego zostały zastosowane aktualizacje. |
updatedRows |
Liczba wierszy, w których co najmniej 1 komórka w wierszu została zaktualizowana. |
updatedColumns |
Liczba kolumn, w których co najmniej 1 komórka w kolumnie została zaktualizowana. |
updatedCells |
Liczba zaktualizowanych komórek. |
dataFilter |
Filtr danych, który zaznaczył zaktualizowany zakres. |
updatedData |
Wartości komórek w zakresie pasujących do filtra danych po zastosowaniu wszystkich aktualizacji. Jest to uwzględniane tylko wtedy, gdy pole |