סקירה כללית על API לאנשי קשר משותפים בדומיין

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

האפליקציה שלכם יכולה להשתמש ב-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 ואתם רוצים לנסות את הדוגמאות שבמסמך הזה בלי לכתוב קוד, תוכלו להשתמש ב-curl או ב-wget באמצעות כלי שורת הפקודה UNIX. כך משתמשים ב-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.