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 (بيانات اعتماد العميل في نص طلب الرمز المميز, 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.

تتم إدارة دورة حياة الرمز المميز في نقطة تحكم مركزية واحدة: حيث يؤدي انتهاء الصلاحية إلى تحديث تلقائي، وتُحفظ رموز التحديث المُدارة باستمرار، وإذا رفض المزود التحديث تظهر مطالبة واضحة بإعادة الاتصال — دون أن تتعطل الميزات بشكل صامت أو غير ملحوظ. ويعمل إلغاء الوصول من كلا الطرفين: إما بقطع الاتصال من هنا، أو إلغائه في إعدادات الأمان الخاصة بالمزود.

A2كتابة الدلالات وتدفق البيانات

كل حركة للبيانات هي إجراء صريح بنتيجة مسجلة في السجل. تتم عمليات الكتابة بنقرة منك — أو تلقائياً فقط عند تفعيلك لقاعدة معينة (الإرسال التلقائي عند التوظيف معطل افتراضياً، لكل مزود). أما عمليات القراءة — استيراد الأشخاص أو الحسابات أو الملفات — فتعمل عندما تضغط على "استيراد"، وتزيل التكرار مقارنة بما لديك بالفعل (العملاء بالاسم، والأشخاص بالبريد الإلكتروني)، وتتخطى بدلاً من الكتابة فوق البيانات القديمة، وتبلغ بكل أمانة عن العناصر التي تم إنشاؤها مقابل المتخطاة، ولهذا السبب فإن إعادة تشغيل أي عملية استيراد تكون آمنة بطبيعتها.

يكتب كل إجراء صفاً في سجل نشاط التطبيق (ats_app_activity): ما تم تشغيله، ومتى، ولأي سجل، والنتيجة — بما في ذلك نص الخطأ الخاص بالمزود حرفياً عند حدوث إخفاق. تجمع تقارير الاستخدام داخل نظام ATS بيانات السجل نفسه، بحيث تتطابق تقارير التكامل تماماً مع واقع التكامل.

كل ما يخرج عن مسار الطلب — إرسال الإشعارات المتعددة، وتسليم الـ webhook، وتسجيل الأنشطة، والبريد — يعمل في مسارات خلفية مستقلة دون انتظار. لا يمكن لأي نقطة نهاية خارجية بطيئة أن تتسبب في تجميد الواجهة، ويتم تسجيل أي تأثير جانبي فاشل بدلاً من إعادة المحاولة بصمت مؤدياً إلى عدم الاتساق.

A3الاعتبارات التشغيلية

تتوفر عمليات الربط على مستوى المؤسسة وتقتصر على أدوار المالك والمشرف؛ ويستخدم مسؤولو التوظيف الميزات التي يتيحها الربط ولكن لا يمكنهم ربطها أو فصلها أو إعادة ضبطها. يؤدي فصل الربط إلى إزالة بيانات الاعتماد المخزنة فوراً وإيقاف الميزات المعتمدة عليها بشكل واضح، وليس بصمت. تبقى البيانات المستوردة بالفعل ملكك وقابلة للتعديل.

يتم إدراج الأشخاص المستوردين مع وضع علامة تشير إلى استيرادهم وتطبيق إعدادات خصوصية تحفظية — حيث لا يُفترض تقديم موافقة من جانب أي شخص لم يقم بملء نموذج التقديم الخاص بك، وتُطبق إعدادات الاحتفاظ الافتراضية. كل ما يُكتب هو ملكك بالكامل: تغطي عمليات تصدير CSV وتطبيق تصدير البيانات نفس مخازن البيانات التي يقرأ منها المنتج نفسه. والمغادرة متاحة وميسرة تماماً مثل الانضمام — عن قصد وتصميم مسبق، وليس مجرد تنازل.

A4الموضع في هيكلية التكامل

هذا التكامل متاح في السجل اليوم. 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.