Method: accounts.list

Liệt kê tất cả tài khoản của người dùng đã xác thực. Điều này bao gồm tất cả tài khoản mà người dùng sở hữu cũng như mọi tài khoản mà người dùng có quyền quản lý.

Yêu cầu HTTP

GET https://mybusinessaccountmanagement.googleapis.com/v1/accounts

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

Tham số truy vấn

Các tham số
parentAccount

string

Không bắt buộc. Tên tài nguyên của tài khoản mà danh sách các tài khoản có thể truy cập trực tiếp sẽ được truy xuất. Điều này chỉ phù hợp với Tổ chức và Nhóm người dùng. Nếu trống, hàm sẽ trả về accounts.list cho người dùng đã xác thực. accounts/{account_id}.

pageSize

integer

Không bắt buộc. Số lượng tài khoản cần tìm nạp trên mỗi trang. Giá trị mặc định và tối đa là 20.

pageToken

string

Không bắt buộc. Nếu chỉ định, trang tiếp theo của tài khoản sẽ được truy xuất. pageToken được trả về khi lệnh gọi đến accounts.list trả về nhiều kết quả hơn số lượng kết quả vừa với kích thước trang được yêu cầu.

filter

string

Không bắt buộc. Bộ lọc ràng buộc các tài khoản trả về. Phản hồi chỉ bao gồm các mục khớp với bộ lọc. Nếu filter trống, thì không có quy tắc ràng buộc nào được áp dụng và tất cả tài khoản (đã phân trang) sẽ được truy xuất cho tài khoản được yêu cầu.

Ví dụ: một yêu cầu có bộ lọc type=USER_GROUP sẽ chỉ trả về nhóm người dùng.

Trường type là bộ lọc duy nhất được hỗ trợ.

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

Thông báo phản hồi cho Accounts.ListAccounts.

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
{
  "accounts": [
    {
      object (Account)
    }
  ],
  "nextPageToken": string
}
Các trường
accounts[]

object (Account)

Tập hợp các tài khoản mà người dùng có quyền truy cập. Tài khoản cá nhân của người dùng thực hiện truy vấn sẽ luôn là mục đầu tiên của kết quả, trừ khi nó bị lọc ra.

nextPageToken

string

Nếu số lượng tài khoản vượt quá kích thước trang được yêu cầu, thì trường này sẽ được điền sẵn một mã thông báo để tìm nạp trang tài khoản tiếp theo trong lệnh gọi tiếp theo đến accounts.list. Nếu không có tài khoản nào khác, thì trường này sẽ không xuất hiện trong phản hồi.

Phạm vi uỷ quyền

Yêu cầu phạm vi OAuth sau:

  • https://www.googleapis.com/auth/business.manage

Để biết thêm thông tin, hãy xem Tổng quan về OAuth 2.0.