סקירה כללית על Domain Shared Contacts API

Domain Shared Contacts API מאפשר לאפליקציות שלך לקבל ולעדכן גורמים חיצוניים אנשי קשר שמשותפים עם כל המשתמשים בדומיין של Google Workspace. משותפים אנשי הקשר גלויים לכל המשתמשים בדומיין ב-Google Workspace ולכל המשתמשים לשירותים יש גישה לרשימת אנשי הקשר.

האפליקציה שלך יכולה להשתמש ב-Domain Shared Contacts API כדי ליצור אנשי קשר משותפים, לערוך או למחוק אנשי קשר משותפים קיימים, והרצת שאילתות על אנשי קשר משותפים שתואמים קריטריונים מסוימים.

Domain Shared Contacts 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 תואמת לעקרונות של ממשקי API של Google Data. ממשקי ה-API של נתונים של Google מבוססים על פורמט ההפצה Atom 1.0 ו-RSS 2.0 בנוסף ל-Atom Publishing Protocol.

ציון גרסה

כל בקשה ששולחים באמצעות Domain Shared Contacts API צריכה לציין גרסה 3.0 של ה-API:

GData-Version: 3.0

אם אי אפשר להגדיר כותרות HTTP, אפשר לציין את v=3.0 כפרמטר של שאילתה כתובת האתר, אך מומלץ להשתמש בשיטה של כותרת ה-HTTP.