Method: spreadsheets.values.update
Устанавливает значения в диапазоне электронной таблицы. Вызывающая сторона должна указать идентификатор электронной таблицы, диапазон и valueInputOption
.
HTTP-запрос
PUT https://sheets.googleapis.com/v4/spreadsheets/{spreadsheetId}/values/{range}
URL-адрес использует синтаксис транскодирования gRPC .
Параметры пути
Параметры |
---|
spreadsheetId | string Идентификатор таблицы, которую необходимо обновить. |
range | string Обозначение A1 значений, которые необходимо обновить. |
Параметры запроса
Параметры |
---|
valueInputOption | enum ( ValueInputOption ) Как следует интерпретировать входные данные. |
includeValuesInResponse | boolean Определяет, должен ли ответ на обновление включать значения обновленных ячеек. По умолчанию ответы не включают обновленные значения. Если диапазон для записи превышает фактически записанный диапазон, ответ включает все значения в запрошенном диапазоне (исключая конечные пустые строки и столбцы). |
responseValueRenderOption | enum ( ValueRenderOption ) Определяет, как должны отображаться значения в ответе. Опция рендеринга по умолчанию — FORMATTED_VALUE . |
responseDateTimeRenderOption | enum ( DateTimeRenderOption ) Определяет, как должны отображаться даты, время и продолжительность в ответе. Это игнорируется, если responseValueRenderOption имеет значение FORMATTED_VALUE . Опция рендеринга dateTime по умолчанию — SERIAL_NUMBER . |
Тело запроса
Тело запроса содержит экземпляр ValueRange
.
Тело ответа
В случае успеха тело ответа содержит экземпляр UpdateValuesResponse
.
Области авторизации
Требуется одна из следующих областей OAuth:
-
https://www.googleapis.com/auth/drive
-
https://www.googleapis.com/auth/drive.file
-
https://www.googleapis.com/auth/spreadsheets
Дополнительную информацию см. в руководстве по авторизации .
Если не указано иное, контент на этой странице предоставляется по лицензии Creative Commons "С указанием авторства 4.0", а примеры кода – по лицензии Apache 2.0. Подробнее об этом написано в правилах сайта. Java – это зарегистрированный товарный знак корпорации Oracle и ее аффилированных лиц.
Последнее обновление: 2024-09-05 UTC.
[null,null,["Последнее обновление: 2024-09-05 UTC."],[[["This method allows you to set values within a specified range of a Google Sheet using the provided spreadsheet ID, range, and value input option."],["You can control data interpretation, response inclusion of updated values, value rendering, and date/time rendering through query parameters."],["The request body requires a ValueRange object defining the values to be set, while a successful response returns an UpdateValuesResponse object."],["Authorization is necessary using one of the specified OAuth scopes: `https://www.googleapis.com/auth/drive`, `https://www.googleapis.com/auth/drive.file`, or `https://www.googleapis.com/auth/spreadsheets`."]]],["This outlines updating spreadsheet values using a `PUT` request to the Google Sheets API. Key actions include specifying the `spreadsheetId` and `range` in the URL's path parameters. The request requires a `valueInputOption` in the query parameters to define data interpretation. Optional query parameters allow controlling response content and formatting. The request body uses `ValueRange`, and a successful response includes `UpdateValuesResponse`. Authorization requires specific OAuth scopes: `drive`, `drive.file`, or `spreadsheets`.\n"]]