تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
تسمح واجهة برمجة التطبيقات "جهات الاتصال المشتركة في النطاق" لتطبيقاتك بالحصول على جهات الاتصال الخارجية التي تتم مشاركتها مع جميع المستخدمين في نطاق 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.
تاريخ التعديل الأخير: 2024-11-22 (حسب التوقيت العالمي المتفَّق عليه)
[[["يسهُل فهم المحتوى.","easyToUnderstand","thumb-up"],["ساعَدني المحتوى في حلّ مشكلتي.","solvedMyProblem","thumb-up"],["غير ذلك","otherUp","thumb-up"]],[["لا يحتوي على المعلومات التي أحتاج إليها.","missingTheInformationINeed","thumb-down"],["الخطوات معقدة للغاية / كثيرة جدًا.","tooComplicatedTooManySteps","thumb-down"],["المحتوى قديم.","outOfDate","thumb-down"],["ثمة مشكلة في الترجمة.","translationIssue","thumb-down"],["مشكلة في العيّنات / التعليمات البرمجية","samplesCodeIssue","thumb-down"],["غير ذلك","otherDown","thumb-down"]],["تاريخ التعديل الأخير: 2024-11-22 (حسب التوقيت العالمي المتفَّق عليه)"],[[["The Domain Shared Contacts API allows applications to manage external contacts shared across a Google Workspace domain."],["This API should not be used for internal contacts; the Directory API is the appropriate tool for managing those."],["Developers can use the API to create, update, delete, and query shared contacts using XML and HTTP."],["The Domain Shared Contacts API is exclusive to Google Workspace accounts and requires enabling in the Admin console."],["Version 3.0 should be specified in API requests, preferably via the `GData-Version` HTTP header."]]],[]]
