Method: partners.customers.list
Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang
Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.
Liệt kê những khách hàng đã đăng ký đại lý được xác định bằng đối số partnerId. Danh sách này bao gồm những khách hàng mà đại lý đã tạo và những khách hàng tự đăng ký bằng cổng thông tin.
Yêu cầu HTTP
GET https://androiddeviceprovisioning.googleapis.com/v1/partners/{partnerId}/customers
URL sử dụng cú pháp Chuyển mã gRPC.
Tham số đường dẫn
| Tham số |
partnerId |
string (int64 format)
Bắt buộc. Mã của đối tác đại lý.
|
Tham số truy vấn
| Tham số |
pageSize |
integer
Số lượng kết quả tối đa được trả về. Nếu không được chỉ định hoặc trả về 0, tất cả bản ghi sẽ được trả về.
|
pageToken |
string
Mã thông báo nhận dạng một trang kết quả do máy chủ trả về.
|
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:
Tin nhắn phản hồi của tất cả khách hàng có liên quan đến đối tác này.
| Biểu diễn dưới dạng JSON |
{
"customers": [
{
object (Company)
}
],
"nextPageToken": string,
"totalSize": integer
} |
| Trường |
customers[] |
object (Company)
Danh sách khách hàng có liên quan đến đối tác đại lý này.
|
nextPageToken |
string
Mã thông báo để truy xuất trang kết quả tiếp theo. Bị bỏ qua nếu không có thêm kết quả.
|
totalSize |
integer
Tổng số mục trong danh sách, bất kể việc phân trang.
|
Phạm vi cấp phép
Yêu cầu phạm vi OAuth sau:
https://www.googleapis.com/auth/androidworkprovisioning
Để biết thêm thông tin, hãy xem bài viết Tổng quan về OAuth 2.0.
Trừ phi có lưu ý khác, nội dung của trang này được cấp phép theo Giấy phép ghi nhận tác giả 4.0 của Creative Commons và các mẫu mã lập trình được cấp phép theo Giấy phép Apache 2.0. Để biết thông tin chi tiết, vui lòng tham khảo Chính sách trang web của Google Developers. Java là nhãn hiệu đã đăng ký của Oracle và/hoặc các đơn vị liên kết với Oracle.
Cập nhật lần gần đây nhất: 2025-07-25 UTC.
[null,null,["Cập nhật lần gần đây nhất: 2025-07-25 UTC."],[[["\u003cp\u003eThis endpoint retrieves a list of customers associated with a specific reseller partner, identified by the \u003ccode\u003epartnerId\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eThe request is a \u003ccode\u003eGET\u003c/code\u003e operation using a predefined URL structure and does not require a request body.\u003c/p\u003e\n"],["\u003cp\u003ePagination is supported through the \u003ccode\u003epageSize\u003c/code\u003e and \u003ccode\u003epageToken\u003c/code\u003e query parameters, allowing for the retrieval of a subset of customers and the navigation through large datasets.\u003c/p\u003e\n"],["\u003cp\u003eThe response body, when successful, contains an array of customer objects, along with pagination details such as \u003ccode\u003enextPageToken\u003c/code\u003e and \u003ccode\u003etotalSize\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eThe access to this API requires the \u003ccode\u003ehttps://www.googleapis.com/auth/androidworkprovisioning\u003c/code\u003e authorization scope.\u003c/p\u003e\n"]]],["This document outlines the process to retrieve a list of customers associated with a reseller partner. The key action is to use a `GET` request to the specified URL: `https://androiddeviceprovisioning.googleapis.com/v1/partners/{partnerId}/customers`, substituting `{partnerId}` with the reseller's ID. Optional query parameters `pageSize` and `pageToken` control pagination. The response includes a JSON payload with `customers` array, `nextPageToken`, and `totalSize`. The request requires authorization with the `https://www.googleapis.com/auth/androidworkprovisioning` scope, and the request body must be empty.\n"],null,["# Method: partners.customers.list\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Query parameters](#body.QUERY_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n - [JSON representation](#body.ListCustomersResponse.SCHEMA_REPRESENTATION)\n- [Authorization Scopes](#body.aspect)\n\nLists the customers that are enrolled to the reseller identified by the `partnerId` argument. This list includes customers that the reseller created and customers that enrolled themselves using the portal.\n\n### HTTP request\n\n`GET https://androiddeviceprovisioning.googleapis.com/v1/partners/{partnerId}/customers`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|-------------|-------------------------------------------------------------------------------------------------------------------------------|\n| `partnerId` | `string (`[int64](https://developers.google.com/discovery/v1/type-format)` format)` Required. The ID of the reseller partner. |\n\n### Query parameters\n\n| Parameters ||\n|-------------|--------------------------------------------------------------------------------------------------------------|\n| `pageSize` | `integer` The maximum number of results to be returned. If not specified or 0, all the records are returned. |\n| `pageToken` | `string` A token identifying a page of results returned by the server. |\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nIf successful, the response body contains data with the following structure:\nResponse message of all customers related to this partner.\n\n| JSON representation ||\n|------------------------------------------------------------------------------------------------------------------------------------------------------------|---|\n| ``` { \"customers\": [ { object (/zero-touch/reference/reseller/rest/v1/partners.customers#Company) } ], \"nextPageToken\": string, \"totalSize\": integer } ``` |\n\n| Fields ||\n|-----------------|-----------------------------------------------------------------------------------------------------------------------------------------------|\n| `customers[]` | `object (`[Company](/zero-touch/reference/reseller/rest/v1/partners.customers#Company)`)` List of customers related to this reseller partner. |\n| `nextPageToken` | `string` A token to retrieve the next page of results. Omitted if no further results are available. |\n| `totalSize` | `integer` The total count of items in the list irrespective of pagination. |\n\n### Authorization Scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/androidworkprovisioning`\n\nFor more information, see the [OAuth 2.0 Overview](https://developers.google.com/identity/protocols/OAuth2)."]]
