تسمح واجهة برمجة التطبيقات "جهات الاتصال المشتركة في النطاق" للتطبيقات بالحصول على جهات الاتصال الخارجية التي تتم مشاركتها مع جميع المستخدمين في نطاق 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 للنشر.
تحديد إصدار
يجب أن تحدّد جميع الطلبات المُرسَلة باستخدام واجهة برمجة التطبيقات "جهات الاتصال المشتركة في النطاق" الإصدار 3.0:
GData-Version: 3.0
إذا لم تتمكّن من ضبط عناوين HTTP، حدِّد v=3.0 كمعلَمة طلب بحث.
يُنصح باستخدام طريقة عنوان HTTP.