Import dat s n8n z google sheets

Nastavení napojení v n8n

Credentials

V Overview v n8n je potřeba v sekci Credentials založit dvě napojení: Google Sheets OAuth2 API a Atollon Crawler API

Google Sheets OAuth2 API

1. V pravém horním rohu vedle Create Workflow otevřete rozbalovací nabídku a zvolte Create Credentials.

2. Jako typ vyberte Google Sheets OAuth2 API.

3. Z pole OAuth Redirect URL v n8n zkopírujte adresu a vložte ji do Google Cloud Console do Authorized redirect URIs (Obrazovka souhlasu/OAuth client)

4. Vyplňte:

   • Client ID – z vašeho Google Cloud projektu

   • Client Secret – z vašeho Google Cloud projektu

5. Z pole OAuth Redirect URL v n8n zkopírujte adresu a vložte ji do Google Cloud Console do Authorized redirect URIs (Obrazovka souhlasu/OAuth client).

6. Uložte změny v Google Cloud Console.

7. Vraťte se do n8n, v credentialu klikněte na Connect/Authorize, přihlaste se ke správnému Google účtu a udělte přístup (Google Sheets, případně Drive).

8. Uložte credential – stav by měl být Connected.

Pozn.: Pokud jste ještě nenastavili OAuth consent screen a nepovolili Google Sheets API v Google Cloud, udělejte to nejprve (jinak autorizace selže).

Google Cloud - Nastavení OAuth

Pro propojení přihlašovacích údajů n8n se službami Google je potřeba projít pěti kroky:

1. Vytvořte projekt v Google Cloud Console.
2. Povolte rozhraní API.
3. Nakonfigurujte obrazovku souhlasu OAuth (OAuth consent screen).
4. Vytvořte klientské přihlašovací údaje Google OAuth (OAuth client credentials).
5. Dokončete nastavení přihlašovacích údajů v n8n.

Kompletní návod k nastavení včetně instruktážního videa najdete zde.

Atollon Crawler API

1. Opět zvolte Create Credentials.
2. Jako typ vyberte Atollon Crawler API.

3. Vyplňte požadovaná pole:

   • Domain (Doména): odkaz na vaši webovou verzi ve formátu https://instance.atollon.com/ (kde namísto instance napíšete název vašeho Atollonu, např. "nejlepsifirma.atollon.com"). 

   • Instance (Instance): název Vaší instance

   • Crawler Secret Key: tajný klíč, který Vám byl poskytnut.

4. Uložte.

Workflows

V Overview n8n v sekci Workflows, je potřeba přidat následující workflow:

1. Vytvoření vzoru pro import

2. Import dat

3. Vytváření záznamů 

Založení nového workflow v n8n

1. Nahoře vpravo klikněte na Create Workflow.

2. Otevřete vpravo nahoře menu … a zvolte Import from file.

3. Vyberte požadovaný .json soubor a potvrďte import.

4. Uložte změny a případně přejmenujte workflow v záhlaví.

Importní workflow

Vytvoření vzorového dokumentu pro následný import

Před spuštěním upravte jednotlivé kroky:

1. Atollon Crawler
   • Credential to connect with: vyberte připravený Crawler pro vaši instanci.
   • Sample object type: zvolte požadovaný typ pro import (např. Kontakty, Složky, Projekty, Aktivity, Produkty).
   • Object ID: doplňte ID vybraného testovacího vzorku.
     • V Atollonu si nejprve vytvořte jeden správně vyplněný vzorek tak, jak si přejete, aby byl naimportován.
     • Při vytváření otevřete Logger (Atollon - Volby a nástroje).
     • Po uložení vyhledejte záznam v Loggeru Create… response a z něj zkopírujte newId do pole Object ID v n8n.
2. Create Google Sheet
   • Credential to connect with: vyberte připravené připojení Google Sheets OAuth2.
   • Title: zadejte název dokumentu, který se má vytvořit.
3. Uložení a první test

   • Uložte změny.

   • Pro první test doporučujeme projít jednotlivé kroky a spouštět je pomocí Execute Step, případně spustit celé workflow přes Execute Workflow.

Kompletní import dat

Než spustíte import, upravte kroky ve workflow Import dat a Vytváření záznamů, jelikož jsou vzájemně provázané. 

Krok 1: Import dat

1. Google Sheets

   • Credential to connect with: vyberte vytvořené připojení Google Sheets OAuth2.

   • Document: zvolte dokument, ve kterém jsou připravena data pro import.

   • Sheet: vyberte správný list, který data obsahuje.

   • Doporučujeme tento krok nejprve otestovat samostatně pomocí Execute Step pro kontrolu dat před importem.

2. Execute Workflow

   • Workflow: vyberte navazující workflow (Vytváření záznamů), která na tento krok přímo navazuje.

Krok 2: Vytváření záznamů

1. Atollon Crawler

   • Credential to connect with: vyberte připravený Crawler pro vaši instanci.

   • Resource: zvolte požadovaný typ pro import (např. Kontakty, Složky, Projekty, Aktivity, Produkty).

2. Uložení nastavené workflow
   

Po nastavení obou kroků otevřete workflow Import dat. Vyberte node Google Sheets a nejprve jej otestujte samostatně pomocí Execute Step, abyste ověřili správnost dat. Pokud je vše v pořádku, spusťte celý import přes Execute Workflow. Díky provázání kroků se automaticky spustí celá sekvence. Doporučujeme nejprve provést testovací import na malém vzorku (pár položek), ověřit, že vše proběhlo v pořádku, a teprve poté importovat zbytek dat.