Method: spreadsheets.values.append

Добавляет значения в электронную таблицу. Диапазон ввода используется для поиска существующих данных и поиска «таблицы» в этом диапазоне. Значения будут добавлены в следующую строку таблицы, начиная с первого столбца таблицы. Подробные сведения о том, как обнаруживаются таблицы и добавляются данные, см. в руководстве и образце кода .

Вызывающая сторона должна указать идентификатор электронной таблицы, диапазон и valueInputOption . Параметр valueInputOption контролирует только то, как входные данные будут добавлены на лист (по столбцам или по строкам), но не влияет на то, в какую ячейку начинают записываться данные.

HTTP-запрос

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

URL-адрес использует синтаксис транскодирования gRPC .

Параметры пути

Параметры
spreadsheetId

string

Идентификатор таблицы, которую необходимо обновить.

range

string

Обозначение диапазона A1 для поиска логической таблицы данных. Значения добавляются после последней строки таблицы.

Параметры запроса

Параметры
valueInputOption

enum ( ValueInputOption )

Как следует интерпретировать входные данные.

insertDataOption

enum ( InsertDataOption )

Как должны быть вставлены входные данные.

includeValuesInResponse

boolean

Определяет, должен ли ответ на обновление включать значения добавленных ячеек. По умолчанию ответы не включают обновленные значения.

responseValueRenderOption

enum ( ValueRenderOption )

Определяет, как должны отображаться значения в ответе. Опция рендеринга по умолчанию — FORMATTED_VALUE .

responseDateTimeRenderOption

enum ( DateTimeRenderOption )

Определяет, как должны отображаться даты, время и продолжительность в ответе. Это игнорируется, если responseValueRenderOption имеет значение FORMATTED_VALUE . Опция рендеринга dateTime по умолчанию — SERIAL_NUMBER .

Тело запроса

Тело запроса содержит экземпляр ValueRange .

Тело ответа

Ответ при обновлении диапазона значений в электронной таблице.

В случае успеха тело ответа содержит данные следующей структуры:

JSON-представление 
{
  "spreadsheetId": string,
  "tableRange": string,
  "updates": {
    object (UpdateValuesResponse)
  }
}
Поля
spreadsheetId

string

Таблица, к которой были применены обновления.

tableRange

string

Диапазон (в нотации A1) таблицы, к которой добавляются значения (до добавления значений). Пусто, если таблица не найдена.

updates

object ( UpdateValuesResponse )

Информация об обновлениях, которые были применены.

Области авторизации

Требуется одна из следующих областей OAuth:

  • https://www.googleapis.com/auth/drive
  • https://www.googleapis.com/auth/drive.file
  • https://www.googleapis.com/auth/spreadsheets

Дополнительную информацию см. в руководстве по авторизации .

Инсердатавариант

Определяет, как изменяются существующие данные при вводе новых данных.

Перечисления
OVERWRITE Новые данные перезаписывают существующие данные в тех областях, где они записаны. (Примечание: добавление данных в конец листа все равно приведет к вставке новых строк или столбцов, чтобы данные можно было записать.)
INSERT_ROWS Строки вставляются для новых данных.