Method: 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.
Yêu cầu HTTP
GET https://sasportal.googleapis.com/v1alpha1/customers
URL sử dụng cú pháp Chuyển mã gRPC.
Tham số truy vấn
| Thông số |
pageSize |
integer
Số lượng customers tối đa cần trả về trong phản hồi.
|
pageToken |
string
Mã thông báo phân trang được trả về từ một lệnh gọi trước đó đến customers.list, cho biết vị trí mà danh sách này sẽ tiếp tục.
|
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:
Câu trả lời cho customers.list.
| Biểu diễn dưới dạng JSON |
{
"customers": [
{
object (Customer)
}
],
"nextPageToken": string
} |
| Trường |
customers[] |
object (Customer)
Danh sách customers khớp với yêu cầu.
|
nextPageToken |
string
Mã thông báo phân trang được trả về từ một lệnh gọi trước đó đến customers.list, cho biết vị trí mà danh sách sẽ tiếp tục. Nếu trường này bị thiếu hoặc trống, tức là không còn khách hàng nào nữa.
|
Phạm vi cấp phép
Yêu cầu phạm vi OAuth sau:
https://www.googleapis.com/auth/sasportal
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 API call (\u003ccode\u003eGET https://sasportal.googleapis.com/v1alpha1/customers\u003c/code\u003e) retrieves a list of customers within the Spectrum Access System.\u003c/p\u003e\n"],["\u003cp\u003eUsers can control the number of results and pagination via query parameters \u003ccode\u003epageSize\u003c/code\u003e and \u003ccode\u003epageToken\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eThe response provides a list of customers and a token for retrieving further results if available.\u003c/p\u003e\n"],["\u003cp\u003eAuthorization requires the \u003ccode\u003ehttps://www.googleapis.com/auth/sasportal\u003c/code\u003e OAuth scope.\u003c/p\u003e\n"]]],["This document details the process of listing customers via an HTTP `GET` request to `https://sasportal.googleapis.com/v1alpha1/customers`. The request utilizes query parameters `pageSize` and `pageToken` for pagination. The request body must be empty. The successful response returns a JSON object containing an array of `customers` and a `nextPageToken` for further pagination. The request requires OAuth scope `https://www.googleapis.com/auth/sasportal`.\n"],null,["# Method: customers.list\n\n- [HTTP request](#body.HTTP_TEMPLATE)\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\nReturns a list of requested [customers](/spectrum-access-system/reference/rest/v1alpha1/customers#Customer).\n\n### HTTP request\n\n`GET https://sasportal.googleapis.com/v1alpha1/customers`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Query parameters\n\n| Parameters ||\n|-------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `pageSize` | `integer` The maximum number of [customers](/spectrum-access-system/reference/rest/v1alpha1/customers#Customer) to return in the response. |\n| `pageToken` | `string` A pagination token returned from a previous call to [customers.list](/spectrum-access-system/reference/rest/v1alpha1/customers/list#spectrum.sas.portal.v1alpha1.Customers.ListCustomers) that indicates where this listing should continue from. |\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 for `customers.list`.\n\n| JSON representation |\n|---------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"customers\": [ { object (/spectrum-access-system/reference/rest/v1alpha1/customers#Customer) } ], \"nextPageToken\": string } ``` |\n\n| Fields ||\n|-----------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `customers[]` | `object (`[Customer](/spectrum-access-system/reference/rest/v1alpha1/customers#Customer)`)` The list of [customers](/spectrum-access-system/reference/rest/v1alpha1/customers#Customer) that match the request. |\n| `nextPageToken` | `string` A pagination token returned from a previous call to [customers.list](/spectrum-access-system/reference/rest/v1alpha1/customers/list#spectrum.sas.portal.v1alpha1.Customers.ListCustomers) that indicates from where listing should continue. If the field is missing or empty, it means there are no more customers. |\n\n### Authorization Scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/sasportal`"]]
