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 (kredensial pelanggan dalam badan permintaan 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.

Kitaran hayat token dikendalikan pada titik pencekikan tunggal: tarikh luput mencetuskan muat semula automatik, token muat semula diputarkan dikekalkan, dan muat semula yang ditolak oleh vendor muncul sebagai gesaan sambung semula yang kelihatan — tidak pernah sebagai ciri yang rosak secara senyap. Pembatalan berfungsi dari kedua-dua belah pihak: putuskan sambungan di sini, atau batalkan dalam tetapan keselamatan vendor sendiri.

A2Tulis semantik dan aliran data

Setiap pergerakan data ialah tindakan tersurat dengan hasil yang dilog. Penulisan berlaku pada klik anda — atau secara automatik hanya di mana anda mendayakan peraturan (tolakan automatik semasa pengambilan dimatikan secara lalai, setiap penyedia). Pembacaan — import orang, akaun, atau fail — berjalan apabila anda menekan Import, menyahduplikasi terhadap apa yang anda sudah ada (pelanggan mengikut nama, orang mengikut e-mel), melangkau dan bukannya menimpa, dan melaporkan yang dicipta berbanding yang dilangkau dengan jujur, itulah sebabnya menjalankan semula sebarang import adalah selamat mengikut reka bentuk.

Setiap tindakan menulis baris pada jurnal aktiviti apl (ats_app_activity): apa yang berjalan, bila, untuk rekod yang mana, dan hasilnya — termasuk teks ralat vendor sendiri secara verbatim apabila sesuatu gagal. Pelaporan penggunaan di dalam ATS mengagregatkan jurnal yang sama, jadi pelaporan integrasi dan realiti integrasi tidak boleh menyimpang.

Apa sahaja yang meninggalkan laluan permintaan — sebaran pemberitahuan, penghantaran webhook, penjurnalan aktiviti, mel — berjalan dalam benang latar belakang "fire-and-forget". Titik akhir luaran yang perlahan tidak akan sekali-kali menyebabkan antara muka menjadi terhenti, dan kesan sampingan yang gagal akan dilog dan bukannya dicuba semula secara senyap sehingga menyebabkan ketidakkonsistenan.

A3Pertimbangan operasi

Sambungan adalah pada peringkat organisasi dan dihadkan kepada peranan pemilik dan pentadbir; perekrut menggunakan ciri yang dikuasakan oleh sambungan tetapi tidak boleh menyambung, memutuskan sambungan, atau mengkonfigurasi semula. Memutuskan sambungan mengalih keluar kelayakan yang disimpan serta-merta dan menghentikan ciri bergantung secara kelihatan, bukan secara senyap. Data yang telah diimport kekal milik anda dan boleh diedit.

Orang yang diimport tiba ditandakan sebagai diimport dengan lalai privasi konservatif — tiada persetujuan diandaikan untuk sesiapa yang tidak pernah mengisi borang permohonan anda, dan lalai pengekalan terpakai.Segala yang ditulis adalah milik anda untuk dibawa: eksport CSV dan apl Eksport Data merangkumi storan yang sama yang dibaca oleh produk itu sendiri. Keluar adalah terbuka seperti masuk — secara reka bentuk, bukan konsesi.

A4Penempatan dalam topologi integrasi

Integrasi ini aktif dalam pendaftaran hari ini. 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.