--- title: "Импорт контактов из Google Sheets в Brevo через Apps Script" description: "Повторяемый пример Apps Script: проверка согласия, сопоставление полей, сохранение отписок и явные ошибки API." url: https://tajo.io/ru/blog/import-google-sheet-contacts-to-brevo-apps-script/ markdown: https://tajo.io/ru/blog/import-google-sheet-contacts-to-brevo-apps-script.md lang: ru-RU author: "Set Noa" author_url: https://tajo.io/ru/set-noa/ published: 2026-04-30 updated: 2026-10-09 alternates: {en-US: /blog/import-google-sheet-contacts-to-brevo-apps-script.md, bg-BG: /bg/blog/import-google-sheet-contacts-to-brevo-apps-script.md, cs-CZ: /cz/blog/import-google-sheet-contacts-to-brevo-apps-script.md, de-DE: /de/blog/import-google-sheet-contacts-to-brevo-apps-script.md, da-DK: /dk/blog/import-google-sheet-contacts-to-brevo-apps-script.md, es-ES: /es/blog/import-google-sheet-contacts-to-brevo-apps-script.md, fr-FR: /fr/blog/import-google-sheet-contacts-to-brevo-apps-script.md, el-GR: /gr/blog/import-google-sheet-contacts-to-brevo-apps-script.md, hi-IN: /hi/blog/import-google-sheet-contacts-to-brevo-apps-script.md, id-ID: /in/blog/import-google-sheet-contacts-to-brevo-apps-script.md, hr-HR: /hr/blog/import-google-sheet-contacts-to-brevo-apps-script.md, hu-HU: /hu/blog/import-google-sheet-contacts-to-brevo-apps-script.md, it-IT: /it/blog/import-google-sheet-contacts-to-brevo-apps-script.md, ja-JP: /jp/blog/import-google-sheet-contacts-to-brevo-apps-script.md, ko-KR: /kr/blog/import-google-sheet-contacts-to-brevo-apps-script.md, ar-SA: /ar/blog/import-google-sheet-contacts-to-brevo-apps-script.md, nl-NL: /nl/blog/import-google-sheet-contacts-to-brevo-apps-script.md, no-NO: /no/blog/import-google-sheet-contacts-to-brevo-apps-script.md, pl-PL: /pl/blog/import-google-sheet-contacts-to-brevo-apps-script.md, pt-BR: /pt/blog/import-google-sheet-contacts-to-brevo-apps-script.md, ro-RO: /ro/blog/import-google-sheet-contacts-to-brevo-apps-script.md, sv-SE: /se/blog/import-google-sheet-contacts-to-brevo-apps-script.md, zh-CN: /zh-cn/blog/import-google-sheet-contacts-to-brevo-apps-script.md, sl-SI: /sl/blog/import-google-sheet-contacts-to-brevo-apps-script.md, sr-Latn-RS: /sr/blog/import-google-sheet-contacts-to-brevo-apps-script.md, th-TH: /th/blog/import-google-sheet-contacts-to-brevo-apps-script.md, tr-TR: /tr/blog/import-google-sheet-contacts-to-brevo-apps-script.md, ur-PK: /ur/blog/import-google-sheet-contacts-to-brevo-apps-script.md, vi-VN: /vi/blog/import-google-sheet-contacts-to-brevo-apps-script.md, sk-SK: /sk/blog/import-google-sheet-contacts-to-brevo-apps-script.md} --- [Синхронизация данных](https://tajo.io/ru/blog/?category=data-sync) # Импорт контактов из Google Sheets в Brevo через Apps Script Повторяемый пример Apps Script: проверка согласия, сопоставление полей, сохранение отписок и явные ошибки API. google apps script brevo Как синхронизировать контакты Google Sheets с Brevo? Создайте столбцы email, firstName, lastName и consent. Сохраните BREVO\_API\_KEY в Script Properties, задайте ID списка в коде и запустите syncSheetToBrevo. Скрипт обрабатывает только строки с согласием, проверяет отписки Brevo, удаляет дубли и останавливается при ошибке API. Это управляемый Вами Apps Script, а не встроенный коннектор. [Узнать больше](https://tajo.io/ru/blog/import-google-sheet-contacts-to-brevo-apps-script/#%D0%BF%D0%BE%D0%B4%D0%B3%D0%BE%D1%82%D0%BE%D0%B2%D1%8C%D1%82%D0%B5-%D1%82%D0%B0%D0%B1%D0%BB%D0%B8%D1%86%D1%83-%D0%B8-%D1%81%D0%BF%D0%B8%D1%81%D0%BE%D0%BA) | Поле источника | Поле назначения | Пример значения | | --- | --- | --- | | `email` | `email` | `alex@example.com` | | `firstName` | `FNAME` | `Alex` | | `lastName` | `LNAME` | `Example` | Один раз выгрузить двенадцать регистраций на мероприятие легко. При втором импорте один адрес может повториться, а другой человек уже отписался в Brevo. Повторяемый импорт обязан учитывать оба случая. Скрипт использует [эндпоинты Brevo для чтения, создания и обновления контактов](https://developers.brevo.com/reference/create-contact). Он рассчитан на небольшие запланированные импорты, не является встроенным коннектором Google Sheets или массовым загрузчиком. Письма не отправляются. Доказательства согласия и работу скрипта обеспечиваете Вы. ## Подготовьте таблицу и список Создайте вкладку `Contacts` строго с этими заголовками. Для `consent` используйте флажок и ставьте `TRUE` только при согласии на конкретный маркетинг. | email | firstName | lastName | consent | | --- | --- | --- | --- | | [jane@example.com](mailto:jane@example.com) | Jane | Doe | TRUE | | [alex@example.com](mailto:alex@example.com) | Alex | Lee | FALSE | Создайте или выберите список Brevo и впишите его числовой ID в `LIST_ID`. Убедитесь, что в Brevo существуют атрибуты `FNAME` и `LNAME`: только они сопоставляются. Если таблица не доказывает, когда и как было дано согласие, храните запись отдельно. Ячейка `TRUE` сама по себе доказательством не служит. В **Extensions → Apps Script → Project Settings → Script Properties** добавьте `BREVO_API_KEY`. Свойства общие для пользователей скрипта, поэтому ограничьте редактирование. Не помещайте ключ в ячейку или код. См. [правила доступа Google](https://developers.google.com/apps-script/guides/properties). ## Скрипт Замените `Code.gs` этим примером. До первого запуска задайте `LIST_ID`. ```javascript const LIST_ID = 42; // Replace with your existing Brevo list ID. const TAB = 'Contacts'; const BASE = 'https://api.brevo.com/v3'; function syncSheetToBrevo() { const key = PropertiesService.getScriptProperties().getProperty('BREVO_API_KEY'); if (!key) throw new Error('Set BREVO_API_KEY in Script Properties first'); const sheet = SpreadsheetApp.getActiveSpreadsheet().getSheetByName(TAB); if (!sheet) throw new Error('Contacts tab missing'); const values = sheet.getDataRange().getValues(); const headers = values.shift().map(h => String(h).trim()); const columns = ['email', 'firstName', 'lastName', 'consent'] .map(name => headers.indexOf(name)); if (columns.includes(-1)) throw new Error('Required header missing'); const [emailCol, firstCol, lastCol, consentCol] = columns; const seen = new Set(); const result = { written: 0, skipped: 0 }; for (const row of values) { const email = String(row[emailCol] || '').trim().toLowerCase(); if (row[consentCol] !== true || !/^[^\s@]+@[^\s@]+\.[^\s@]+$/.test(email) || seen.has(email)) { result.skipped++; continue; } seen.add(email); const path = '/contacts/' + encodeURIComponent(email); const current = brevo_(key, path, 'get'); if (current.code !== 200 && current.code !== 404) { throw new Error(`Contact read failed (${current.code}) for row ${result.written + result.skipped + 2}`); } if (current.code === 200) { const contact = JSON.parse(current.text); if (contact.emailBlacklisted || (contact.listUnsubscribed || []).includes(LIST_ID)) { result.skipped++; continue; } } const attributes = {}; if (row[firstCol] !== '') attributes.FNAME = String(row[firstCol]); if (row[lastCol] !== '') attributes.LNAME = String(row[lastCol]); const body = { attributes, listIds: [LIST_ID] }; const saved = current.code === 404 ? brevo_(key, '/contacts', 'post', { email, ...body }) : brevo_(key, path, 'put', body); if (![201, 204].includes(saved.code)) { throw new Error(`Contact write failed (${saved.code}) for ${email}: ${saved.text.slice(0, 200)}`); } result.written++; } Logger.log(JSON.stringify(result)); return result; } function brevo_(key, path, method, body) { for (let attempt = 0; attempt < 3; attempt++) { const response = UrlFetchApp.fetch(BASE + path, { method, contentType: 'application/json', headers: { 'api-key': key }, payload: body ? JSON.stringify(body) : undefined, muteHttpExceptions: true, }); const code = response.getResponseCode(); if (code !== 429) return { code, text: response.getContentText() }; if (attempt === 2) return { code, text: response.getContentText() }; const reset = Object.entries(response.getHeaders()).find( ([name]) => name.toLowerCase() === 'x-sib-ratelimit-reset' ); const raw = Number(reset && reset[1]); const seconds = Number.isFinite(raw) && raw > 0 ? raw : 2 ** attempt; const waitSeconds = seconds + 2 ** attempt; if (waitSeconds > 60) return { code, text: response.getContentText() }; Utilities.sleep(waitSeconds * 1000); } } ``` Сохраните, выберите `syncSheetToBrevo` и нажмите **Run**. Google запросит доступ к Sheets и внешним запросам. В **Executions** найдите итоговую запись `{written, skipped}`. Ответ 404 при чтении ведёт к созданию контакта, 200 к обновлению. Другие ошибки останавливают запуск. Успешная запись контакта не означает отправку кампании. Скрипт удаляет повторы адресов внутри одного запуска, а при следующем снова проверяет Brevo. Он не задаёт `emailBlacklisted: false` и не меняет email. Если Brevo сообщает о блокировке или отписке от целевого списка, строка пропускается даже при `TRUE`. Не используйте скрипт для отмены отписки. [Brevo предупреждает](https://developers.brevo.com/reference/update-contact): смена email заблокированного контакта может снять блокировку. ## Проверьте один запуск перед расписанием Используйте тестовый список и свои контакты. Одна строка `TRUE`, одна `FALSE` и повтор адреса должны дать одну запись и два пропуска. Отпишите тестовый контакт в Brevo и повторите: для него записи быть не должно. Для проверки ошибки временно задайте неверный `LIST_ID`, увидьте HTTP-ошибку в **Executions**, восстановите ID и повторите. Не проверяйте на реальных клиентах. Код локально испытан на имитации ответов Brevo, без живой записи. Для расписания откройте **Apps Script → Triggers → Add Trigger**, выберите `syncSheetToBrevo` и интервал. [Триггер запускается от аккаунта создателя](https://developers.google.com/apps-script/guides/triggers/installable), которому нужен постоянный доступ к таблице. Для маленькой таблицы начните с ежедневного запуска и следите за ошибками. Google [ограничивает время выполнения и URL Fetch](https://developers.google.com/apps-script/guides/services/quotas); большие источники разделяйте на ограниченные задания. После 429 скрипт читает `x-sib-ratelimit-reset` и повторяет не более двух раз. Если ждать нужно больше 60 секунд, он возвращает 429 для последующего запуска. Другие ошибки также останавливают его; следующий запуск начинается сначала. Контакт может отписаться между чтением и записью. Этот пример подходит только если короткое окно допустимо. Для строгой защиты нужны сверка событий, надёжное хранилище согласий и последняя проверка перед отправкой. Для крупных таблиц [асинхронный импорт Brevo](https://developers.brevo.com/reference/import-contacts) возвращает `processId`. Он подтверждает принятие задачи, не завершение. Проверяйте результат. Обработка по контактам здесь показывает строку ошибки. ## Часто Задаваемые Вопросы **Нужен ли встроенный коннектор Google Sheets?** Нет. Пример работает в привязанном к таблице проекте Apps Script и вызывает API контактов Brevo. Скрипт, ключ и запланированный триггер поддерживаете Вы. **Какие строки передаются в Brevo?** Только строки с consent TRUE и допустимым email. Скрипт удаляет дубли при каждом запуске и перед записью проверяет Brevo. **Повторный запуск подпишет отписавшегося контакта?** Скрипт пропускает контакты, которые Brevo пометил emailBlacklisted или отписал от целевого списка. Он не передаёт emailBlacklisted: false и не меняет адрес. Перед рабочим запуском проверьте и другие источники согласия и блокировок. **Как повторить неудачный запуск?** Прочитайте ошибку в выполнениях Apps Script, устраните причину и запустите ту же функцию. Тот же email и ID списка позволяют обновить ранее успешную строку без создания второго контакта. ## Похожие статьи ### [Как импортировать контакты из CSV или Excel в Brevo с помощью скрипта (Python, Node.js, cURL)](https://tajo.io/ru/blog/import-csv-contacts-to-brevo-with-a-script/) 30 апр. 2026 г. · 5 мин чтения CSV → Brevo ### [Как загружать контакты из Excel в Brevo с помощью VBA-макроса (и альтернатива на Office Scripts)](https://tajo.io/ru/blog/import-excel-contacts-to-brevo-with-vba-macro/) 30 апр. 2026 г. · 6 мин чтения Microsoft Excel → Brevo ### [Интеграции Brevo: выберите проверяемое подключение](https://tajo.io/ru/blog/brevo-connector-guide/) 19 авг. 2026 г. · 4 мин чтения 6 разделов