Method: roles.get

אחזור תפקיד.

בקשת HTTP

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

כתובת ה-URL כוללת תחביר של קידוד gRPC.

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

פרמטרים
customer

string

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

string

המזהה הבלתי משתנה של התפקיד.

גוף הבקשה

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

גוף התשובה

אם הפעולה בוצעה בהצלחה, גוף התגובה מכיל מופע של Role.

היקפי הרשאה

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

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

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