במדריך הזה נסביר איך ליצור, להציג ולמחוק הרשאות גישה לאנשי קשר.
יצירת משתמש מנוהל
כדי ליצור משתמש שיכול להעניק הרשאות, יוצרים בקשה מסוג POST שמכילה את כתובת האימייל של המשתמש:
POST https://admin.googleapis.com/admin/contacts/v1/users/delegator@example.com/delegates
בגוף הבקשה, מציינים את כתובת האימייל של המשתמש שרוצים להעניק לו הרשאת גישה:
{
“email”: “delegate@example.com”
}
בתגובה מוצלחת מוחזר קוד סטטוס HTTP 200 ואימייל של הנציג החדש:
{
“email”: “delegate@example.com”
}
הצגת רשימת הנציגים
כדי לקבל רשימה של משתמשים עם הרשאות לניהול אנשי הקשר של משתמש מסוים, יוצרים בקשה מסוג GET שמכילה את כתובת האימייל של המשתמש:
GET https://admin.googleapis.com/admin/contacts/v1/users/delegator@example.com/delegates
בתגובה מוצלחת מוחזר קוד סטטוס HTTP 200 ורשימה של כתובות האימייל של הנציגים:
{
“email”: “delegate1@example.com”
}
מחיקת הגישה של אדם אחר
כדי למחוק את הרשאת הגישה של משתמש לאנשי הקשר של משתמש אחר, יוצרים בקשה מסוג DELETE שמכילה את כתובת האימייל של המשתמש שהעניק את הגישה ושל המשתמש שקיבל אותה:
DELETE https://admin.googleapis.com/admin/contacts/v1/users/delegator@example.com/delegates/delegate@example.com
בתגובה מוצלחת מוחזר קוד סטטוס HTTP 200.