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