Method: customers.list
با مجموعه‌ها، منظم بمانید
ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.
لیستی از customers درخواست شده را برمی گرداند.
درخواست HTTP
GET https://sasportal.googleapis.com/v1alpha1/customers
URL از دستور GRPC Transcoding استفاده می کند.
پارامترهای پرس و جو
| پارامترها |
|---|
pageSize | integer حداکثر تعداد customers برای بازگشت در پاسخ. |
pageToken | string یک نشانه صفحه‌بندی که از تماس قبلی به customers.list بازگشته است که نشان می‌دهد این فهرست باید از کجا ادامه یابد. |
درخواست بدن
بدنه درخواست باید خالی باشد.
بدن پاسخگو
در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی داده هایی با ساختار زیر است:
پاسخ برای customers.list .
| نمایندگی JSON |
|---|
{
"customers": [
{
object (Customer)
}
],
"nextPageToken": string
} |
| فیلدها |
|---|
customers[] | object ( Customer ) لیست customers که با درخواست مطابقت دارند. |
nextPageToken | string یک نشانه صفحه‌بندی که از تماس قبلی به customers.list برگردانده شده است که نشان می‌دهد فهرست از کجا باید ادامه یابد. اگر فیلد مفقود یا خالی باشد، به این معنی است که مشتری دیگری وجود ندارد. |
محدوده مجوز
به محدوده OAuth زیر نیاز دارد:
-
https://www.googleapis.com/auth/sasportal
جز در مواردی که غیر از این ذکر شده باشد،محتوای این صفحه تحت مجوز Creative Commons Attribution 4.0 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده Oracle و/یا شرکتهای وابسته به آن است.
تاریخ آخرین بهروزرسانی 2025-07-25 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2025-07-25 بهوقت ساعت هماهنگ جهانی."],[[["\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`"]]
