Method: roleAssignments.list

אחזור רשימה מחולקת לדפים של כל ה-roleAssignments.

בקשת HTTP

GET https://admin.googleapis.com/admin/directory/v1/customer/{customer}/roleassignments

כתובת ה-URL משתמשת בתחביר של Transcoding של gRPC.

פרמטרים של נתיב

פרמטרים
customer

string

המזהה הייחודי של חשבון Google Workspace של הלקוח. בחשבון עם כמה דומיינים, כדי לאחזר את כל הקבוצות של לקוח, משתמשים בשדה הזה במקום ב-domain. אפשר גם להשתמש בכתובת החלופית my_customer כדי לייצג את customerId של החשבון. הערך customerId מוחזר גם כחלק מהמשאב Users. חובה לספק את הפרמטר customer או את הפרמטר domain.

פרמטרים של שאילתה

פרמטרים
maxResults

integer

המספר המקסימלי של תוצאות להחזרה.
pageToken

string

אסימון לציון הדף הבא ברשימה.
roleId

string

מזהה קבוע של תפקיד. אם השדה הזה נכלל בבקשה, המערכת מחזירה רק הקצאות תפקידים שמכילות את מזהה התפקיד הזה.
userKey

string

כתובת האימייל הראשית, כתובת האימייל החלופית או מזהה המשתמש או הקבוצה הייחודי. אם הפרמטר הזה נכלל בבקשה, המערכת מחזירה הקצאות תפקידים רק למשתמש או לקבוצה האלה.
includeIndirectRoleAssignments

boolean

כשהערך מוגדר כ-true, מתבצעת אחזור של הקצאות תפקידים עקיפות (כלומר הקצאת תפקיד דרך קבוצה) וגם של הקצאות ישירות. ברירת המחדל היא false. חובה לציין את הערך userKey, אחרת הקצאות התפקידים העקיפות לא ייכללו.

גוף הבקשה

גוף הבקשה חייב להיות ריק.

גוף התשובה

אם הפעולה מצליחה, גוף התגובה מכיל נתונים במבנה הבא:

ייצוג ב-JSON 
{
  "kind": string,
  "etag": string,
  "items": [
    {
      object (RoleAssignment)
    }
  ],
  "nextPageToken": string
}
שדות
kind

string

הסוג של משאב ה-API. הערך הזה הוא תמיד admin#directory#roleAssignments.
etag

string

ה-ETag של המשאב.
items[]

object (RoleAssignment)

רשימה של משאבי RoleAssignment.
nextPageToken

string

היקפי הרשאה

נדרש אחד מהיקפי ההרשאות הבאים של OAuth:

  • https://www.googleapis.com/auth/admin.directory.rolemanagement
  • https://www.googleapis.com/auth/admin.directory.rolemanagement.readonly

מידע נוסף זמין במדריך ההרשאות.