Method: roleAssignments.list

เรียกรายการที่ใส่เลขหน้าของ roleAssignments ทั้งหมด

คำขอ HTTP

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

URL ใช้ไวยากรณ์การแปลง 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

โปรดดูข้อมูลเพิ่มเติมที่คู่มือการให้สิทธิ์