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