# Import dat Uživatelská dokumentace k importů dat. # 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](https://cloud.google.com/) 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](https://docs.n8n.io/integrations/builtin/credentials/google/oauth-single-service/?utm_source=n8n_app&utm_medium=credential_settings&utm_campaign=create_new_credentials_modal)**. ##### 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](https://drive.google.com/file/d/1lYEH55A61-TCfCxukT_54-ImWC-XFGvi/view?usp=sharing) 2. [Import dat](https://drive.google.com/file/d/1IPvPuL37UAKOvzGjPQF1d4mK-C5Mc1wT/view?usp=sharing) 3. [Vytváření záznamů ](https://drive.google.com/file/d/1XRVD2OKNTzJdR495Bpp2wNRMudoy52L1/view?usp=sharing) ##### 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**.[![Snímek obrazovky 2025-09-23 v 13.55.37.png](https://navody.atollon.cz/uploads/images/gallery/2025-09/scaled-1680-/snimek-obrazovky-2025-09-23-v-13-55-37.png)](https://navody.atollon.cz/uploads/images/gallery/2025-09/snimek-obrazovky-2025-09-23-v-13-55-37.png) 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**.