Method: orgunits.list

Truy xuất danh sách tất cả các đơn vị tổ chức cho một tài khoản.

Yêu cầu HTTP

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

URL sử dụng cú pháp Chuyển mã gRPC.

Tham số đường dẫn

Tham số
customerId

string

Mã nhận dạng duy nhất của tài khoản Google Workspace của khách hàng. Là quản trị viên tài khoản, bạn cũng có thể sử dụng bí danh my_customer để đại diện cho customerId của tài khoản. customerId cũng được trả về như một phần của tài nguyên người dùng.

Tham số truy vấn

Tham số
orgUnitPath

string

Đường dẫn đầy đủ đến đơn vị tổ chức hoặc mã nhận dạng duy nhất của đơn vị tổ chức đó. Trả về các phần tử con của đơn vị tổ chức đã chỉ định.

type

enum (Type)

Liệu có trả về tất cả các tổ chức con hay chỉ các tổ chức con trực tiếp hay không.

Nội dung yêu cầu

Nội dung yêu cầu phải trống.

Nội dung phản hồi

Nếu thành công, phần nội dung phản hồi sẽ chứa dữ liệu có cấu trúc sau:

Biểu diễn dưới dạng JSON
{
  "kind": string,
  "etag": string,
  "organizationUnits": [
    {
      object (OrgUnit)
    }
  ]
}
Trường
kind

string

Loại tài nguyên API. Đối với các tài nguyên của Đơn vị tổ chức, kiểu này là admin#directory#orgUnits.

etag

string

ETag của tài nguyên.

organizationUnits[]

object (OrgUnit)

Danh sách các đối tượng của đơn vị tổ chức.

Phạm vi uỷ quyền

Yêu cầu một trong các phạm vi OAuth sau:

  • 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

Để biết thêm thông tin, hãy xem Hướng dẫn uỷ quyền.

Loại

Enum
ALL Tất cả các đơn vị tổ chức con.
CHILDREN Chỉ trẻ em xuất hiện ngay lập tức (mặc định).
ALL_INCLUDING_PARENT Tất cả các đơn vị tổ chức con và đơn vị tổ chức được chỉ định (gốc nếu không được chỉ định).