تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
تسمح واجهة برمجة التطبيقات "جهات الاتصال المشتركة في النطاق" لتطبيقاتك بالحصول على جهات الاتصال الخارجية التي تتم مشاركتها مع جميع المستخدمين في نطاق 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.
تاريخ التعديل الأخير: 2025-03-25 (حسب التوقيت العالمي المتفَّق عليه)
[[["يسهُل فهم المحتوى.","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"]],["تاريخ التعديل الأخير: 2025-03-25 (حسب التوقيت العالمي المتفَّق عليه)"],[],[],null,["# Domain Shared Contacts API overview\n\nThe Domain Shared Contacts API lets your applications get and update external\ncontacts that are shared with all users in a Google Workspace domain. Shared\ncontacts are visible to all users of a Google Workspace domain and all Google\nservices have access to the contact list.\n| **Warning:** The Domain Shared Contacts API is intended only for *external* contacts. Using this API to create contact information for domain (internal) users or groups can result in duplicate contact information for those users and groups, which might lead to unexpected behavior. To get and update Google Workspace domain (internal) users' contact information, use the [Directory API](https://developers.google.com/workspace/admin/directory) instead.\n\nYour application can use the Domain Shared Contacts API to create shared contacts, edit\nor delete existing shared contacts, and query for shared contacts that match a\nparticular criteria.\n\nThe Domain Shared Contacts API is only available to Google Workspace accounts.\nTo use the API,\n[enable the Domain Shared Contacts API in the Admin console](https://support.google.com/a/answer/60757).\nShared contact changes can take up to 24 hours to be reflected in the email\naddress autocomplete and the contact manager.\n\nIn addition to providing background on the capabilities of the\nDomain Shared Contacts API, this document offers examples about how to manage\ncontacts by using XML and HTTP. After reading this document, you can learn more\nabout interacting with the API by using our\n[client libraries](https://developers.google.com/api-client-library).\n\nAudience\n--------\n\nThis document is intended for developers who want to write client applications\nthat can manipulate Google's contact lists by using HTTP and XML.\nThis document assumes that you understand the\n[fundamentals behind the Google Data APIs protocol](https://developers.google.com/gdata/docs/2.0/basics).\n\nIf you're using a UNIX operating system and you want to try the examples in this\ndocument without writing any code, use the UNIX command-line utilities\n[curl](https://curl.haxx.se/)\nor\n[wget](https://www.gnu.org/software/wget/).\nLearn how to\n[use cURL with Google Data services](https://developers.google.com/gdata/articles/using_cURL).\n\nPrinciples\n----------\n\nThis version of the Domain Shared Contacts API follows the principles of the\n[Google Data APIs](https://developers.google.com/gdata/docs/developers-guide).\nGoogle Data APIs are based on both the Atom 1.0 and RSS 2.0 syndication formats\nin addition to the Atom Publishing Protocol.\n\nSpecify a version\n-----------------\n\nEvery request that you send using the Domain Shared Contacts API should specify version\n3.0 of the API: \n\n GData-Version: 3.0\n\nIf you can't set HTTP headers, you can specify`v=3.0` as a query parameter in\nthe URL, but the HTTP header method is recommended.\n| **Note:** The client libraries supply appropriate version headers automatically, so don't use the `v=3.0` query parameter when you're using a client library."]]
