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, który chcesz zaktualizować.

range

string

Notacja A1 wartości, które mają zostać zaktualizowane.

Parametry zapytania

Parametry
valueInputOption

enum (ValueInputOption)

Sposób interpretacji danych wejściowych.

includeValuesInResponse

boolean

Określa, czy odpowiedź na aktualizację powinna zawierać wartości komórek, które zostały zaktualizowane. Domyślnie odpowiedzi nie zawierają zaktualizowanych wartości. Jeśli zakres do zapisania był większy niż zakres faktycznie zapisany, odpowiedź zawiera wszystkie wartości w żądanym zakresie (z wyjątkiem pustych wierszy i kolumn na końcu).

responseValueRenderOption

enum (ValueRenderOption)

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

responseDateTimeRenderOption

enum (DateTimeRenderOption)

Określa sposób wyświetlania dat, godzin i czasów trwania w odpowiedzi. Jest on ignorowany, jeśli responseValueRenderOption ma wartość FORMATTED_VALUE. Domyślną opcją renderowania daty i czasu 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 dotyczącym autoryzacji.