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 ValueRanges
.
Żądanie HTTP
POST https://sheets.googleapis.com/v4/spreadsheets/{spreadsheetId}/values:batchUpdate
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. |
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[] |
Po jednej wartości UpdateValuesResponse na żądany zakres, w tej samej kolejności, w jakiej pojawiają się żądania. |
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.