Method: orgunits.list

ดึงข้อมูลรายการหน่วยขององค์กรทั้งหมดสําหรับบัญชี

คำขอ HTTP

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

URL ใช้ไวยากรณ์การแปลง gRPC

พารามิเตอร์เส้นทาง

พารามิเตอร์
customerId

string

รหัสที่ไม่ซ้ำกันสำหรับบัญชี Google Workspace ของลูกค้า ในฐานะผู้ดูแลระบบบัญชี คุณสามารถใช้อีเมลแทน my_customer เพื่อแสดง customerId ของบัญชีได้เช่นกัน ระบบจะแสดงผล customerId เป็นส่วนหนึ่งของทรัพยากรผู้ใช้ด้วย

พารามิเตอร์การค้นหา

พารามิเตอร์
orgUnitPath

string

เส้นทางแบบเต็มไปยังหน่วยขององค์กรหรือรหัสที่ไม่ซ้ำกัน แสดงผลหน่วยขององค์กรย่อยของหน่วยขององค์กรที่ระบุ
type

enum (Type)

แสดงองค์กรย่อยทั้งหมดหรือเฉพาะองค์กรย่อยโดยตรง

เนื้อหาของคำขอ

เนื้อหาของคำขอต้องว่างเปล่า

เนื้อหาการตอบกลับ

หากทำสำเร็จ เนื้อหาการตอบกลับจะมีข้อมูลซึ่งมีโครงสร้างดังต่อไปนี้

การแสดง JSON 
{
  "kind": string,
  "etag": string,
  "organizationUnits": [
    {
      object (OrgUnit)
    }
  ]
}
ช่อง
kind

string

ประเภทของทรัพยากร API สำหรับทรัพยากรของหน่วยขององค์กร ประเภทจะเป็น admin#directory#orgUnits
etag

string

ETag ของทรัพยากร
organizationUnits[]

object (OrgUnit)

รายการออบเจ็กต์หน่วยขององค์กร

ขอบเขตการให้สิทธิ์

ต้องใช้ขอบเขต OAuth ต่อไปนี้

  • https://apps-apis.google.com/a/feeds/policies/
  • https://www.googleapis.com/auth/admin.directory.orgunit
  • https://www.googleapis.com/auth/admin.directory.orgunit.readonly

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

ประเภท

Enum
ALL หน่วยขององค์กรย่อยทั้งหมด
CHILDREN แท็กย่อยที่อยู่ใต้โดยตรงเท่านั้น (ค่าเริ่มต้น)
ALL_INCLUDING_PARENT หน่วยย่อยทั้งหมดและหน่วยขององค์กรที่ระบุ (ระดับรูทหากไม่ได้ระบุ)