إنّ واجهة برمجة التطبيقات Domain Shared Contacts API تتيح لتطبيقاتك الحصول على جهات الاتصال الخارجية التي تتم مشاركتها مع جميع المستخدمين في نطاق Google Workspace وتعديلها. تظهر جهات الاتصال المشتركة لجميع المستخدمين في نطاق Google Workspace ويمكن لجميع خدمات Google الوصول إلى قائمة جهات الاتصال.
يمكن للتطبيق استخدام Domain Shared Contacts API لإنشاء جهات اتصال مشتركة وتعديل جهات الاتصال المشتركة الحالية أو حذفها والبحث عن جهات الاتصال المشتركة التي تتطابق مع معايير معيّنة.
لا تتوفّر واجهة Domain Shared Contacts API إلا لحسابات Google Workspace. لاستخدام واجهة برمجة التطبيقات، فعِّل واجهة برمجة التطبيقات لجهات الاتصال المشتركة في النطاق في "وحدة تحكُّم المشرف". قد يستغرق ظهور التغييرات في جهات الاتصال المشتركة ما يصل إلى 24 ساعة في الإكمال التلقائي لعنوان البريد الإلكتروني ومدير جهات الاتصال.
بالإضافة إلى توفير معلومات أساسية حول إمكانات واجهة برمجة التطبيقات لجهات الاتصال المشتركة في النطاق، يقدم هذا المستند أمثلة حول كيفية إدارة جهات الاتصال باستخدام XML وHTTP. بعد قراءة هذا المستند، يمكنك معرفة المزيد حول التفاعل مع واجهة برمجة التطبيقات باستخدام مكتبات العملاء.
الجمهور
هذا المستند معد للمطورين الذين يريدون كتابة تطبيقات عميل يمكنها التلاعب بقوائم جهات اتصال Google باستخدام HTTP وXML. يفترض هذا المستند أنك تفهم الأساسيات وراء بروتوكول Google Data APIs.
إذا كنت تستخدم نظام تشغيل UNIX وتريد تجربة الأمثلة الواردة في هذا المستند بدون كتابة أي رمز، استخدِم أدوات سطر أوامر UNIX curl أو wget. تعرَّف على كيفية استخدام cURL مع خدمات Google Data.
المبادئ
يتّبع هذا الإصدار من Domain Shared Contacts API مبادئ واجهات برمجة التطبيقات للبيانات من Google. تعتمد واجهات برمجة التطبيقات للبيانات من Google على تنسيقات المشاركة بتنسيق Atom 1.0 وRSS 2.0 بالإضافة إلى بروتوكول نشر Atom.
تحديد إصدار
يجب أن يحدّد كل طلب ترسله باستخدام Domain Shared Contacts API الإصدار 3.0 من واجهة برمجة التطبيقات:
GData-Version: 3.0
إذا لم تتمكّن من ضبط عناوين HTTP، يمكنك تحديد v=3.0 كمَعلمة طلب بحث في عنوان URL، ولكن ننصحك باستخدام طريقة عنوان HTTP.