--- title: "Uvoz kontakata iz Google Sheetsa u Brevo pomoću Apps Scripta" description: "Ponovljiv primjer Google Apps Scripta koji provjerava privolu, mapira polja, čuva odjave i pokazuje pogreške API-ja." url: https://tajo.io/hr/blog/import-google-sheet-contacts-to-brevo-apps-script/ markdown: https://tajo.io/hr/blog/import-google-sheet-contacts-to-brevo-apps-script.md lang: hr-HR author: "Set Noa" author_url: https://tajo.io/hr/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, 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, ru-RU: /ru/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} --- [Sinkronizacija podataka](https://tajo.io/hr/blog/?category=data-sync) # Uvoz kontakata iz Google Sheetsa u Brevo pomoću Apps Scripta Ponovljiv primjer Google Apps Scripta koji provjerava privolu, mapira polja, čuva odjave i pokazuje pogreške API-ja. google apps script brevo Kako sinkronizirati kontakte iz Google Sheetsa u Brevo? Dodajte u tablicu stupce email, firstName, lastName i consent. Postavite BREVO\_API\_KEY u svojstva skripte i ID popisa u kod, pa pokrenite syncSheetToBrevo. Skripta obrađuje samo retke s privolom, provjerava odjave u Brevu, uklanja duplikate i zaustavlja se na pogrešci API-ja. To je Apps Script koji sami održavate, a ne ugrađeni poveznik. [Saznajte više](https://tajo.io/hr/blog/import-google-sheet-contacts-to-brevo-apps-script/#pripremite-tablicu-i-popis) | Izvorno polje | Odredišno polje | Primjer vrijednosti | | --- | --- | --- | | `email` | `email` | `alex@example.com` | | `firstName` | `FNAME` | `Alex` | | `lastName` | `LNAME` | `Example` | Tablicu s dvanaest prijava na događaj lako je izvesti jednom. Pri drugom uvozu jedna se adresa ponavlja, a druga se osoba odjavila u Brevu. Ponovljiv uvoz mora prepoznati oba slučaja. Skripta koristi [Brevo krajnje točke za čitanje, stvaranje i ažuriranje kontakata](https://developers.brevo.com/reference/create-contact). Namijenjena je malim planiranim uvozima, a ne masovnom učitavanju ni ulozi ugrađenog poveznika za Google Sheets. Ne šalje e-poštu. Za dokaz privole i rad skripte odgovorni ste vi. ## Pripremite tablicu i popis Stvorite karticu `Contacts` s točno ovim zaglavljima. Za `consent` koristite potvrdne okvire i postavite `TRUE` samo ako postoji privola za planirani marketing. | email | firstName | lastName | consent | | --- | --- | --- | --- | | [jane@example.com](mailto:jane@example.com) | Jane | Doe | TRUE | | [alex@example.com](mailto:alex@example.com) | Alex | Lee | FALSE | Stvorite ili odaberite Brevo popis te njegov brojčani ID unesite kao `LIST_ID`. Provjerite postoje li atributi `FNAME` i `LNAME` u Brevu. Samo su ta polja mapirana. Dokaz o tome kada i kako je privola dana spremite drugdje ako ga tablica ne može pružiti. Ćelija `TRUE` nije dokaz. Pod **Proširenja → Apps Script → Postavke projekta → Svojstva skripte** dodajte `BREVO_API_KEY`. Svojstva dijele korisnici skripte, stoga ograničite pravo uređivanja. Ključ ne stavljajte u ćeliju ni u kod. Pročitajte [Googleova pravila pristupa](https://developers.google.com/apps-script/guides/properties). ## Skripta Zamijenite `Code.gs` ovim primjerom i prije prvog pokretanja postavite `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); } } ``` Spremite, odaberite `syncSheetToBrevo` i kliknite **Pokreni**. Google traži pristup Sheetsu i vanjskim zahtjevima. Pod **Izvršavanja** je završni zapis `{written, skipped}`. Odgovor 404 pri čitanju vodi stvaranju kontakta, 200 ažuriranju. Druge pogreške zaustavljaju rad. Uspješan zapis potvrđuje zahtjev za kontakt, ne slanje kampanje. Skripta uklanja dvostruke adrese u jednom pokretanju i ponovno pita Brevo pri idućem. Nikad ne postavlja `emailBlacklisted` na `false` i ne mijenja e-poštu. Ako Brevo prijavi blokadu ili odjavu s tog popisa, redak se preskače i uz `TRUE` u tablici. Ne koristite skriptu za poništavanje odjave. [Brevo upozorava](https://developers.brevo.com/reference/update-contact) da promjena adrese blokiranog kontakta može ukloniti blokadu. ## Provjerite pokretanje prije rasporeda Koristite testni popis i kontakte koje nadzirete. Pokrenite s jednim retkom `TRUE`, jednim `FALSE` i dvostrukom adresom: očekujte jedan zapis i dva preskočena retka. Odjavite testni kontakt u Brevu i ponovite: za njega ne smije biti zapisa. Za ispitivanje pogreške privremeno postavite nevaljani `LIST_ID`, provjerite HTTP pogrešku pod **Izvršavanja**, vratite ID i pokušajte ponovno. Ne testirajte na pravim podacima kupaca. Kod je provjeren lokalno i sa simuliranim odgovorima Breva, bez stvarnog zapisivanja. Za raspored otvorite **Apps Script → Okidači → Dodaj okidač**, odaberite `syncSheetToBrevo` i vremenski interval. [Okidači se izvršavaju pod računom osobe koja ih je stvorila](https://developers.google.com/apps-script/guides/triggers/installable), pa račun mora zadržati pristup tablici. Za malu tablicu krenite jednom dnevno i pratite pogreške. Google [ograničava vrijeme izvođenja i pozive URL Fetch](https://developers.google.com/apps-script/guides/services/quotas); velike izvore podijelite u ograničene zadatke. Pri 429 skripta čita `x-sib-ratelimit-reset` i ponavlja najviše dvaput. Ako potrebno čekanje prelazi 60 sekundi, vraća 429 za kasnije pokretanje. Druge pogreške zaustavljaju rad; idući put kreće ispočetka. Kontakt se može odjaviti između čitanja i zapisa. Primjer rabite samo ako je taj kratak prozor prihvatljiv. Stroža jamstva traže usklađivanje događaja, pouzdan izvor privole i posljednju provjeru prije slanja. Za veće tablice [asinkrona Brevo točka za uvoz](https://developers.brevo.com/reference/import-contacts) vraća `processId`. To potvrđuje prihvat zadatka, ne dovršetak. Provjerite rezultat prije objave uspjeha. Put po pojedinačnim kontaktima ovdje otkriva pogrešku na dotičnom retku. ## Često postavljana pitanja **Treba li vam ugrađeni poveznik za Google Sheets?** Ne. Primjer se izvršava u projektu Google Apps Script povezanom s tablicom i poziva Brevo API za kontakte. Skriptu, API ključ i zakazani okidač održavate sami. **Koji se retci šalju u Brevo?** Samo oni s TRUE u consent i valjanom adresom e-pošte. Skripta uklanja duplikate pri svakom pokretanju i provjerava Brevo prije zapisivanja. **Prijavljuje li novo pokretanje odjavljeni kontakt?** Skripta preskače kontakte koje Brevo označi kao emailBlacklisted ili odjavljene s ciljnog popisa. Nikad ne šalje emailBlacklisted: false i ne mijenja adresu. Prije produkcije provjerite druge izvore privole. **Kako ponoviti neuspjelo pokretanje?** Pročitajte pogrešku u izvršavanjima Apps Scripta, otklonite uzrok i pokrenite istu funkciju ponovno. Zapisi rabe istu adresu i ID popisa, pa uspješan redak ne stvara drugi kontakt. ## Povezani članci ### [Kako uvesti CSV ili Excel kontakte u Brevo pomoću skripte (Python, Node.js, cURL)](https://tajo.io/hr/blog/import-csv-contacts-to-brevo-with-a-script/) 30\. tra 2026. · 5 min čitanja CSV → Brevo ### [Kako poslati Excel kontakte u Brevo pomoću VBA makronaredbe (i alternativa s Office Scripts)](https://tajo.io/hr/blog/import-excel-contacts-to-brevo-with-vba-macro/) 30\. tra 2026. · 6 min čitanja Microsoft Excel → Brevo ### [Brevo integracije: odaberite vezu koju možete provjeriti](https://tajo.io/hr/blog/brevo-connector-guide/) 19\. kol 2026. · 4 min čitanja 6 odjeljaka