Method: spreadsheets.values.update

Ustawia wartości w zakresie arkusza kalkulacyjnego. Element wywołujący musi określić identyfikator arkusza kalkulacyjnego, zakres i valueInputOption.

Żądanie HTTP

PUT https://sheets.googleapis.com/v4/spreadsheets/{spreadsheetId}/values/{range}

Adres URL używa składni transkodowania gRPC.

Parametry ścieżki

Parametry
spreadsheetId

string

Identyfikator arkusza kalkulacyjnego do zaktualizowania.
range

string

Zapis A1 wartości do zaktualizowania.

Parametry zapytania

Parametry
valueInputOption

enum (ValueInputOption)

Jak należy interpretować dane wejściowe.
includeValuesInResponse

boolean

Określa, czy odpowiedź dotycząca aktualizacji powinna zawierać wartości zaktualizowanych komórek. Domyślnie odpowiedzi nie zawierają zaktualizowanych wartości. Jeśli zakres do zapisu był większy niż rzeczywiście zapisany zakres, odpowiedź zawiera wszystkie wartości z żądanego zakresu (z wyłączeniem końcowych pustych wierszy i kolumn).
responseValueRenderOption

enum (ValueRenderOption)

Określa sposób renderowania wartości w odpowiedzi. Domyślną opcją renderowania jest FORMATTED_VALUE.
responseDateTimeRenderOption

enum (DateTimeRenderOption)

Określa sposób renderowania dat, godzin i czasu trwania odpowiedzi. Ta wartość jest ignorowana, jeśli responseValueRenderOption ma wartość FORMATTED_VALUE. Domyślną opcją renderowania daty i godziny jest SERIAL_NUMBER.

Treść żądania

Treść żądania zawiera wystąpienie elementu ValueRange.

Treść odpowiedzi

W przypadku powodzenia treść odpowiedzi obejmuje wystąpienie elementu UpdateValuesResponse.

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.