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

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

Type

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