- HTTP-запрос
- Параметры пути
- Параметры запроса
- Тело запроса
- Тело ответа
- Области авторизации
- Инсердататаоптион
- Попробуй это!
Добавляет значения в электронную таблицу. Входной диапазон используется для поиска существующих данных и поиска «таблицы» в этом диапазоне. Значения будут добавлены к следующей строке таблицы, начиная с первого столбца таблицы. Подробные сведения о том, как обнаруживаются таблицы и добавляются данные, см. в руководстве и примере кода .
Вызывающий должен указать идентификатор электронной таблицы, диапазон и valueInputOption
. Параметр valueInputOption
управляет только тем, как входные данные будут добавляться на лист (по столбцам или по строкам), он не влияет на то, в какую ячейку начинают записываться данные.
HTTP-запрос
POST https://sheets.googleapis.com/v4/spreadsheets/{spreadsheetId}/values/{range}:append
URL-адрес использует синтаксис транскодирования gRPC .
Параметры пути
Параметры | |
---|---|
spreadsheetId | Идентификатор электронной таблицы для обновления. |
range | Нотация диапазона A1 для поиска логической таблицы данных. Значения добавляются после последней строки таблицы. |
Параметры запроса
Параметры | |
---|---|
valueInputOption | Как следует интерпретировать входные данные. |
insertDataOption | Как вводить входные данные. |
includeValuesInResponse | Определяет, должен ли ответ на обновление включать значения добавленных ячеек. По умолчанию ответы не включают обновленные значения. |
responseValueRenderOption | Определяет, как должны отображаться значения в ответе. Параметр рендеринга по умолчанию — |
responseDateTimeRenderOption | Определяет, как должны отображаться даты, время и продолжительность в ответе. Это игнорируется, если |
Тело запроса
Тело запроса содержит экземпляр ValueRange
.
Тело ответа
Ответ при обновлении диапазона значений в электронной таблице.
В случае успеха тело ответа содержит данные со следующей структурой:
Представление JSON |
---|
{
"spreadsheetId": string,
"tableRange": string,
"updates": {
object ( |
Поля | |
---|---|
spreadsheetId | Электронная таблица, к которой были применены обновления. |
tableRange | Диапазон (в нотации A1) таблицы, к которой добавляются значения (до добавления значений). Пусто, если таблица не найдена. |
updates | Информация о применённых обновлениях. |
Области авторизации
Требуется одна из следующих областей действия OAuth:
-
https://www.googleapis.com/auth/drive
-
https://www.googleapis.com/auth/drive.file
-
https://www.googleapis.com/auth/spreadsheets
Дополнительные сведения см. в руководстве по авторизации .
Инсердататаоптион
Определяет, как изменяются существующие данные при вводе новых данных.
перечисления | |
---|---|
OVERWRITE | Новые данные перезаписывают существующие данные в тех областях, где они записаны. (Примечание: добавление данных в конец листа все равно приведет к добавлению новых строк или столбцов, чтобы данные можно было записать.) |
INSERT_ROWS | Строки вставляются для новых данных. |