Google Docs

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 (bezeroaren kredentzialak token eskaeraren gorputzean, 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.

Tokenaren bizi-zikloa gune bakar batean kudeatzen da: iraungitzeak freskatze automatikoa eragiten du, biratutako freskatze tokenak iraunkor bihurtzen dira, eta hornitzaileak baztertzen duen freskatze batek berriro konektatzeko ohar ikusgai gisa azaleratzen da —inoiz ez funtzio apurtu isil gisa. Baliogabetzeak bi aldeetatik funtzionatzen du: deskonektatu hemen, edo baliogabetu hornitzailearen segurtasun-ezarpenetan.

A2Idatzi semantika eta datu-fluxua

Datu-mugimendu oro erregistro-emaitza duen ekintza esplizitu bat da. Idazketak zure klasean gertatzen dira —edo automatikoki arau bat gaitu duzun lekuetan bakarrik (kontratatzean auto-bultzatzea desgaituta dago lehenetsita, hornitzaile bakoitzeko)—. Irakurketak —pertsonen, kontuen edo fitxategien inportazioak— Inportatu sakatzen duzunean exekutatzen dira, jada duzunarekin bikoizketak kentzen dituzte (bezeroak izenez, pertsonak posta elektronikoz), gainidatzi baino gehiago saltatzen dute, eta sortutakoaren eta saltatutakoaren berri ematen dute zintzotasunez; horregatik da edozein inportazio berriro exekutatzea segurua diseinuz.

Ekintza bakoitzak errenkada bat idatzten du aplikazioaren jardueraren egunkarian (ats_app_activity): zer exekutatu zen, noiz, zein erregistrotarako, eta emaitza —zerbait huts egitean saltzailearen beraren errore-testua hitzez hitz barne. ATS barruko erabilera-txostenek egunkari bera biltzen dute; beraz, integrazio-txostenak eta integrazioaren errealitatea ezin dira desbideratu.

Eskaera-bidetik kanpo ihes egiten duen edozer — jakinarazpenen banaketa, webhook-en bidalketa, jardueren egunkaria, posta — atzeko planoko harietan exekutatzen da, emaitzaren zain geratu gabe. Kanpoko endpoint motel batek ezin du inoiz interfazea blokeatu, eta huts egin duen albo-efektu bat erregistratu egiten da, isilean eta ezegonkortasunera eramanez berriro saiatu beharrean.

A3Funtzionamenduaren alderdiak

Konexioak erakunde mailakoak dira eta jabe eta administratzaile rolei mugatuta daude; kontratatzaileek konexio batek bultzatzen dituen funtzioak erabiltzen dituzte baina ezin dute konektatu, deskonektatu edo birkonfiguratu. Deskonektatzeak gordetako kredentzialak berehala kentzen ditu eta mendeko funtzioak modu ikusgaian geldiarazten ditu, ez isilean. Dagoeneko inportatutako datuak zurea izaten jarraitzen dute eta editagarriak dira.

Inportatutako pertsonak inportatuta gisa markatuta iristen dira, pribatutasun-lehenespen kontserbadoreekin — ez da onartzen adostasunik zure eskaera-orria inoiz bete ez duen inorentzat, eta atxikipen-lehenespenak aplikatzen dira.Idatzitako guztia zurea da eramateko: CSV esportazioek eta Datuen Esportaziorako aplikazioak produktuak berak irakurtzen dituen biltegi berberak estaltzen dituzte. Irteera sarrera bezain irekia da —diseinuz, ez emakida bidez—.

A4Kokapena integrazio-topologian

Integrazio hau erregistroan martxan dago gaur. 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.