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 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 |
Sposób interpretacji danych wejściowych. |
data[] |
Nowe wartości, które zostaną zastosowane w arkuszu kalkulacyjnym. |
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[] |
Jedna odpowiedź UpdateValuesResponse w żądanym zakresie, w tej samej kolejności co żą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.