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 Строки вставляются для новых данных.