Method: spreadsheets.values.update

Ustawia wartości w zakresie arkusza kalkulacyjnego. Rozmówca musi podać 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)

Sposób interpretacji danych wejściowych.
includeValuesInResponse

boolean

Określa, czy odpowiedź powinna zawierać wartości zaktualizowanych komórek. Domyślnie odpowiedzi nie zawierają zaktualizowanych wartości. Jeśli zakres zapisu jest większy niż rzeczywisty zakres, odpowiedź zawiera wszystkie wartości z żądanego zakresu (z wyjątkiem pustych wierszy i kolumn).
responseValueRenderOption

enum (ValueRenderOption)

Określa sposób renderowania wartości w odpowiedzi. Domyślna opcja renderowania to FORMATTED_VALUE.
responseDateTimeRenderOption

enum (DateTimeRenderOption)

Określa sposób wyświetlania dat, godzin i czasów trwania odpowiedzi. Ta wartość jest ignorowana, jeśli responseValueRenderOption ma wartość FORMATTED_VALUE. Domyślna opcja renderowania dateTime to 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.