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

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