אחזור רשימה מעומדת של כל הקצאות התפקידים.
בקשת HTTP
GET https://admin.googleapis.com/admin/directory/v1/customer/{customer}/roleassignments
בכתובת ה-URL נעשה שימוש בתחביר המרת gRPC.
פרמטרים של נתיב
פרמטרים | |
---|---|
customer |
המזהה הייחודי של חשבון Google Workspace של הלקוח. אם מדובר בחשבון מרובה דומיינים, כדי לאחזר את כל הקבוצות של לקוח מסוים, יש להשתמש בשדה הזה במקום בשדה |
פרמטרים של שאילתה
פרמטרים | |
---|---|
maxResults |
מספר התוצאות המקסימלי שיוחזר. |
pageToken |
אסימון לציון הדף הבא ברשימה. |
roleId |
מזהה לא קבוע של תפקיד. אם הבקשה כלולה, הפונקציה מחזירה רק הקצאות של תפקידים שמכילות את מזהה התפקיד הזה. |
userKey |
כתובת האימייל הראשית, כתובת האימייל החלופית או מזהה המשתמש או הקבוצה הייחודיים. אם הבקשה כלולה, הפונקציה מחזירה הקצאות של תפקידים רק למשתמש או לקבוצה האלה. |
includeIndirectRoleAssignments |
אם הערך שמוגדר לפרמטר הוא |
גוף הבקשה
גוף הבקשה חייב להיות ריק.
גוף התשובה
אם הפעולה בוצעה ללא שגיאות, גוף התגובה יכלול נתונים במבנה הבא:
ייצוג JSON |
---|
{
"kind": string,
"etag": string,
"items": [
{
object ( |
שדות | |
---|---|
kind |
הסוג של משאב ה-API. הערך הוא תמיד |
etag |
ETag של המשאב. |
items[] |
רשימה של מקורות מידע להקצאת תפקידים. |
nextPageToken |
|
היקפי הרשאות
כדי להשתמש בתכונה הזו יש צורך באחד מההיקפים הבאים של OAuth:
https://www.googleapis.com/auth/admin.directory.rolemanagement
https://www.googleapis.com/auth/admin.directory.rolemanagement.readonly
למידע נוסף, ניתן לעיין במדריך ההרשאות.