تسمح واجهة برمجة التطبيقات "جهات الاتصال المشتركة في النطاق" لتطبيقاتك بالحصول على جهات الاتصال الخارجية التي تتم مشاركتها مع جميع المستخدمين في نطاق Google Workspace وتعديلها. تظهر جهات الاتصال المشتركة لجميع مستخدمي نطاق Google Workspace، ويمكن لجميع خدمات Google الوصول إلى قائمة جهات الاتصال.
يمكن لتطبيقك استخدام Domain Shared Contacts API لإنشاء جهات اتصال مشتركة وتعديل جهات الاتصال المشتركة الحالية أو حذفها، والاستعلام عن جهات الاتصال المشتركة التي تتطابق مع معايير معيّنة.
لا تتوفّر واجهة برمجة التطبيقات "جهات الاتصال المشتركة في النطاق" إلا لحسابات Google Workspace. لاستخدام واجهة برمجة التطبيقات، عليك تفعيل واجهة برمجة التطبيقات "جهات الاتصال المشتركة في النطاق" في "وحدة تحكّم المشرف". قد يستغرق ظهور التغييرات في جهات الاتصال المشتركة في قائمة الإكمال التلقائي لعناوين البريد الإلكتروني وفي "مدير جهات الاتصال" مدة تصل إلى 24 ساعة.
بالإضافة إلى تقديم معلومات أساسية حول إمكانات واجهة برمجة التطبيقات الخاصة بجهات الاتصال المشترَكة في النطاق، يقدّم هذا المستند أمثلة حول كيفية إدارة جهات الاتصال باستخدام XML وHTTP. بعد قراءة هذا المستند، يمكنك الاطّلاع على مزيد من المعلومات حول التفاعل مع واجهة برمجة التطبيقات باستخدام مكتبات البرامج.
الجمهور
هذا المستند مخصّص للمطوّرين الذين يريدون كتابة تطبيقات عملاء يمكنها تعديل قوائم جهات الاتصال في Google باستخدام HTTP وXML. يفترض هذا المستند أنّك على دراية بالأساسيات التي يستند إليها بروتوكول Google Data APIs.
إذا كنت تستخدم نظام تشغيل UNIX وأردت تجربة الأمثلة الواردة في هذا المستند بدون كتابة أي رمز، استخدِم أدوات سطر الأوامر في UNIX، مثل curl أو wget. كيفية استخدام cURL مع خدمات Google Data
المبادئ
يتّبع هذا الإصدار من واجهة برمجة التطبيقات "جهات الاتصال المشتركة في النطاق" مبادئ واجهات 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 كمَعلمة طلب بحث في عنوان URL، ولكن يُنصح باستخدام طريقة عناوين HTTP.