ניהול בעלי הגישה לאנשי הקשר

במדריך הזה מוסבר איך ליצור, להציג ולמחוק משתמשים עם הרשאות לניהול אנשי קשר עבור משתמשי Google Workspace.

משתמשים ב-Google Workspace יכולים לתת למשתמשים אחרים בדומיין שלהם הרשאה לגשת לאנשי הקשר שלהם ולנהל אותם. המשתמשים האלה יוכלו להוסיף אנשי קשר ולעדכן את המידע שלהם בפרטים כמו שמות, מספרי טלפון וכתובות.

המדריך הזה מיועד להקצאת גישה לאנשי קשר. כדי להעניק גישה ל-Gmail, אפשר לעיין במאמר איך מעניקים גישה לאימייל ועובדים ביחד.

דרישות מוקדמות

לפני שמשתמשים בממשק Contact Delegation API, חשוב לוודא שמתקיימות הדרישות הבאות:

• הפעלת שיתוף אנשי קשר: אדמין של הספרייה צריך להפעיל את שיתוף אנשי הקשר במסוף Admin. מידע נוסף זמין במאמר בנושא הפעלה או השבתה של שיתוף אנשי קשר.
• הרשאות אדמין: כדי לנהל משתמשים עם הרשאות לניהול אנשי קשר של משתמשים אחרים, צריך להיות לכם הרשאת אדמין של 'אנשי קשר'.
• הגבלת דומיין: אפשר להעביר הרשאות לגישה לאנשי קשר רק בין משתמשים באותו ארגון Google Workspace.
• היקף הרשאות OAuth: האפליקציה שלכם צריכה להשתמש בהיקף ההרשאות הבא של OAuth: https://www.googleapis.com/auth/admin.contact.delegation.

יצירת בעל/ת גישה

כדי ליצור הרשאת גישה למשתמש, שולחים בקשת POST עם כתובת האימייל של המשתמש שמעניק את הגישה:

POST https://admin.googleapis.com/admin/contacts/v1/users/USER_EMAIL/delegates

מחליפים את USER_EMAIL בכתובת האימייל של המשתמש שהוקצו לו הרשאות.

בגוף הבקשה, מציינים את כתובת האימייל של הנציג:

{
  "email": "DELEGATE_EMAIL"
}

מחליפים את DELEGATE_EMAIL בכתובת האימייל של הנציג.

תשובה מוצלחת מחזירה קוד סטטוס HTTP 200 ואת כתובת האימייל של הנציג החדש:

{
  "email": "DELEGATE_EMAIL"
}

הצגת רשימת נציגים

כדי להציג רשימה של נציגים עבור אנשי הקשר של משתמש, שולחים בקשת GET עם כתובת האימייל של המשתמש:

GET https://admin.googleapis.com/admin/contacts/v1/users/USER_EMAIL/delegates

מחליפים את USER_EMAIL בכתובת האימייל של המשתמש.

תגובה מוצלחת מחזירה קוד סטטוס HTTP 200 ורשימה של כתובות אימייל של נציגים:

{
  "delegates": [
    {
      "email": "DELEGATE_EMAIL_1"
    },
    {
      "email": "DELEGATE_EMAIL_2"
    }
  ]
}

מחיקת בעל/ת גישה

כדי למחוק נציג מאנשי הקשר של משתמש:

1. מזהים את הנציג שרוצים להסיר. אפשר להשתמש בשיטה List delegates כדי למצוא את כתובת האימייל של נציג ספציפי.

2. שולחים בקשת DELETE עם כתובות האימייל של המשתמש שנותן את ההרשאה ושל המשתמש שמקבל את ההרשאה:

   DELETE https://admin.googleapis.com/admin/contacts/v1/users/USER_EMAIL/delegates/DELEGATE_EMAIL
   

מחליפים את USER_EMAIL בכתובת האימייל של מי שהעניק את ההרשאה, ואת DELEGATE_EMAIL בכתובת האימייל של מי שההרשאה הוענקה לו.

תשובה מוצלחת מחזירה קוד סטטוס HTTP 200.