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