Ustawia wartości w jednym lub kilku zakresach arkusza kalkulacyjnego. Wywołujący musi podać identyfikator arkusza kalkulacyjnego, valueInputOption
i co najmniej 1 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 do zastosowania w arkuszu kalkulacyjnym. |
includeValuesInResponse |
Określa, czy odpowiedź na aktualizację 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 renderowania dat, godzin i czasu 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 zastosowano zmiany. |
totalUpdatedRows |
Łączna liczba wierszy, w których zaktualizowano co najmniej 1 komórkę w wierszu. |
totalUpdatedColumns |
Łączna liczba kolumn, w których została zaktualizowana co najmniej 1 komórka w kolumnie. |
totalUpdatedCells |
Łączna liczba zaktualizowanych komórek. |
totalUpdatedSheets |
Łączna liczba arkuszy, w których co najmniej jedna komórka w arkuszu została zaktualizowana. |
responses[] |
Jedna odpowiedź UpdateValuesResponse na żądany zakres, w tej samej kolejności, w jakiej się pojawiły żądania. |
Zakresy autoryzacji
Wymaga jednego z tych zakresów protokołu 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 na temat autoryzacji.