Dokumenty Google

A1Connection architecture

The connection uses OAuth 2.0 against the vendor's own consent screen. The authorisation request names the minimum scopes the features need — the exact scope list is shown in the security-flow panel below, pulled from the same provider registry the application uses. The code-for-token exchange happens entirely server-side (klientske poverenia v tele požiadavky na token, per the vendor's token endpoint contract); tokens are stored encrypted at rest and are never rendered back to any screen — connection pages show presence, not values.

Životný cyklus tokenu je riadený v jedinom bode: vypršanie platnosti spustí automatické obnovenie, otočené obnovovacie tokeny sa uložia a obnovenie, ktoré dodávateľ odmietne, sa zobrazí ako viditeľná výzva na opätovné pripojenie – nikdy nie ako ticho pokazené funkcie. Odvolanie funguje z oboch strán: odpojte sa tu alebo ho odvolajte v bezpečnostných nastaveniach samotného dodávateľa.

A2Napíšte sémantiku a tok dát

Každý prenos údajov je explicitnou akciou so zaznamenaným výsledkom. Zápisy sa dejú na vaše kliknutie — alebo automaticky iba tam, kde ste povolili pravidlo (automatické presunutie pri prijatí je predvolene vypnuté, podľa poskytovateľa). Čítania — importy osôb, účtov alebo súborov — sa spustia, keď stlačíte tlačidlo Importovať, vykoná sa deduplikácia voči tomu, čo už máte (klienti podľa mena, osoby podľa e-mailu), preskočí sa namiesto prepísania a čestne sa nahlási vytvorené verzus preskočené, a preto je opätovné spustenie akéhokoľvek importu bezpečné už zo svojej podstaty.

Každá akcia zapíše riadok do denníka aktivity aplikácie (ats_app_activity): čo sa spustilo, kedy, pre ktorý záznam a výsledok — vrátane doslovného chybového textu dodávateľa, keď niečo zlyhá. Vykazovanie využitia v rámci ATS agreguje ten istý denník, takže vykazovanie integrácie a realita integrácie sa nemôžu rozchádzať.

Všetko, čo opúšťa cestu požiadavky – distribúcia upozornení, doručovanie webových hákov, zaznamenávanie aktivít, pošta – beží v zákulisných vláknach typu „odošli a zabudni“. Pomalý externý koncový bod nikdy nemôže spôsobiť zlyhanie rozhrania a zlyhaný vedľajší účinok sa zaznamená do denníka, namiesto toho, aby sa ticho opakovane spúšťal do nekonzistentného stavu.

A3Prevádzkové úvahy

Pripojenia sú na úrovni organizácie a sú obmedzené na role vlastníka a správcu; náboroví pracovníci využívajú funkcie, ktoré pripojenie napája, ale nemôžu ho pripojiť, odpojiť ani prekonfigurovať. Odpojenie okamžite odstráni uložené poverenia a viditeľne, nie ticho, zastaví závislé funkcie. Údaje, ktoré už boli importované, zostávajú vaše a sú upraviteľné.

Importovaní ľudia prichádzajú označení ako importovaní s konzervatívnymi predvolenými nastaveniami súkromia – predpokladá sa žiadny súhlas pre každého, kto nikdy nevyplnil vašu žiadosť, a platia predvolené nastavenia uchovávania. Všetko, čo je napísané, je vaše: exporty CSV a aplikácia Data Export pokrývajú tie isté úložiská, ktoré číta samotný produkt. Odchod je rovnako otvorený ako príchod – zámerne, nie ako ústupok.

A4Umiestnenie v topológii integrácie

Táto integracja je dnes v registri spustená. One connection per provider unlocks every feature it powers, and the topology grid below shows the neighbouring connectors in the same capability area — statuses come from the same registry that drives the in-app hub, so this page can never claim more than the product does. For anything the catalogue does not cover, Webhooks and Zapier are the generic, documented escape hatch.