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