קל לארגן דפים בעזרת אוספים
אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.
באמצעות Domain Shared Contacts API, האפליקציות שלכם יכולות לקבל ולעדכן אנשי קשר חיצוניים ששותפו עם כל המשתמשים בדומיין ב-Google Workspace. כל המשתמשים בדומיין של Google Workspace יכולים לראות את אנשי הקשר המשותפים, וכל שירותי Google יכולים לגשת לרשימת אנשי הקשר.
האפליקציה שלכם יכולה להשתמש ב-Domain Shared Contacts API כדי ליצור אנשי קשר משותפים, לערוך או למחוק אנשי קשר משותפים קיימים ולבצע שאילתות לאנשי קשר משותפים שתואמים לקריטריונים מסוימים.
ה-API של כתובות האימייל המשותפות בדומיין זמין רק לחשבונות Google Workspace.
כדי להשתמש ב-API, צריך להפעיל את Domain Shared Contacts API במסוף Admin.
יכול להיות שיחלפו עד 24 שעות לפני שהשינויים באנשי הקשר המשותפים יבואו לידי ביטוי בהשלמה האוטומטית של כתובות האימייל ובמנהל אנשי הקשר.
בנוסף למידע על היכולות של API של אנשי הקשר המשותפים לדומיין, במסמך הזה מפורטות דוגמאות לניהול אנשי הקשר באמצעות XML ו-HTTP. אחרי שתסיימו לקרוא את המסמך הזה, תוכלו לקבל מידע נוסף על האינטראקציה עם ה-API באמצעות ספריות הלקוח שלנו.
קהל
המסמך הזה מיועד למפתחים שרוצים לכתוב אפליקציות לקוח שיכולות לבצע פעולות על רשימות אנשי הקשר של Google באמצעות HTTP ו-XML.
ההנחה במסמך הזה היא שיש לכם הבנה בעקרונות הבסיסיים של פרוטוקול Google Data APIs.
הגרסה הזו של Domain Shared Contacts API פועלת לפי העקרונות של Google Data APIs.
ממשקי Google Data API מבוססים על פורמטים של סינדיקציה של Atom 1.0 ו-RSS 2.0, בנוסף לפרוטוקול Atom Publishing.
ציון גרסה
בכל בקשה ששולחים באמצעות Domain Shared Contacts API צריך לציין את הגרסה 3.0 של ה-API:
GData-Version: 3.0
אם אין לכם אפשרות להגדיר כותרות HTTP, תוכלו לציין את v=3.0 כפרמטר של שאילתה בכתובת ה-URL, אבל מומלץ להשתמש בשיטה של כותרת ה-HTTP.
[[["התוכן קל להבנה","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 (שעון UTC)."],[],[],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."]]
