ה-Domain Shared Contacts API מאפשר לאפליקציות לקבל ולעדכן אנשי קשר חיצוניים ששותפו עם כל המשתמשים בדומיין Google Workspace. כל המשתמשים בדומיין Google Workspace יכולים לראות את אנשי הקשר המשותפים, ולכל שירותי Google יש גישה לרשימת אנשי הקשר.
אפשר להשתמש ב-Domain Shared Contacts API כדי ליצור, לערוך או למחוק אנשי קשר משותפים, ולחפש אנשי קשר שתואמים לקריטריונים ספציפיים.
ה-API של אנשי קשר משותפים בדומיין זמין רק לחשבונות Google Workspace. כדי להשתמש ב-API, צריך להפעיל את Domain Shared Contacts API במסוף Admin. יכול להיות שיעברו 24 שעות עד שהשינויים יופיעו בהשלמה האוטומטית ובמרכז אנשי הקשר.
במאמר הזה מוסבר על Domain Shared Contacts API ומוצגות דוגמאות לניהול אנשי קשר באמצעות XML ו-HTTP. מידע נוסף זמין במאמר בנושא ספריות לקוח.
קהל
המסמך הזה מיועד למפתחים שכותבים אפליקציות לקוח שמבצעות מניפולציות ברשימות אנשי קשר ב-Google באמצעות HTTP ו-XML. המדריך מניח שיש לכם ידע בפרוטוקול Google Data APIs.
משתמשי Linux ו-macOS יכולים לנסות את הדוגמאות במסמך הזה באמצעות curl או wget. מידע נוסף זמין במאמר בנושא שימוש ב-curl עם Google Data APIs.
עקרונות
Domain Shared Contacts API פועל לפי העקרונות של Google Data APIs. ממשקי Google Data API מבוססים על Atom 1.0, RSS 2.0 ופרוטוקול הפרסום של Atom.
ציון גרסה
בכל הבקשות שנשלחות באמצעות Domain Shared Contacts API צריך לציין את גרסה 3.0:
GData-Version: 3.0
אם אי אפשר להגדיר כותרות HTTP, מציינים את v=3.0 כפרמטר של שאילתה.
מומלץ להשתמש בשיטת הכותרת של HTTP.