$integration.googleSheets.writeDataToCells

Метод используется для записи данных в ячейки таблицы Google.

Синтаксис

Метод принимает 4 обязательных аргумента.

Аргумент	Описание	Тип
integrationId	Идентификатор интеграции	Строка
spreadsheetId	Идентификатор таблицы Google	Строка
sheetName	Название нужного листа	Строка
values	Записываемые значения	Массив объектов

Объекты, передаваемые в массиве values, в свою очередь должны иметь следующие поля:

Аргумент	Описание	Тип
values	Записываемые значения	Массив строк
cell	Координаты ячейки	Строка

Пример вызова метода:

ECMAScript 5

$integration.googleSheets.writeDataToCells(
    "4404df16-bfc7-4bc6-9f84-65d02d000217",
    "1gdkEwg2KMeKYJK-yrxgKuk9-uP7ntjtKg5ChDu8906E",
    "Sheet1",
    [{values: ["Николаевич", "78121770707"], cell: "C4"}]
);

ECMAScript 6

В среде ECMAScript 6 метод является асинхронным.

await $integration.googleSheets.writeDataToCells(
    "4404df16-bfc7-4bc6-9f84-65d02d000217",
    "1gdkEwg2KMeKYJK-yrxgKuk9-uP7ntjtKg5ChDu8906E",
    "Sheet1",
    [{values: ["Николаевич", "78121770707"], cell: "C4"}]
);

Действие

Метод записывает переданные значения в соответствующие ячейки на нужном листе.

подсказка

Если для записи в ячейку передается несколько значений, второе и последующие значения записываются в столбцы, следующие за нужной ячейкой.

предупреждение

В отличие от googleSheets.writeDataToLine, при использовании данного метода для записи данных в непустые ячейки предыдущие данные будут перезаписаны.

Пример

Рассмотрим пример использования метода для обновления базы клиентов.