Method: customers.list
קל לארגן דפים בעזרת אוספים
אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.
הצגת רשימה של חשבונות הלקוחות של המשתמש.
בקשת HTTP
GET https://androiddeviceprovisioning.googleapis.com/v1/customers
כתובת ה-URL משתמשת בתחביר של Transcoding של gRPC.
פרמטרים של שאילתה
| פרמטרים |
pageSize |
integer
חובה. המספר המקסימלי של לקוחות שמוצגים בדף תוצאות. מספר בין 1 ל-100 (כולל).
|
pageToken |
string
אסימון שמציין איזה דף תוצאות להציג.
|
גוף הבקשה
גוף הבקשה חייב להיות ריק.
גוף התשובה
אם הפעולה מצליחה, גוף התגובה מכיל נתונים במבנה הבא:
הודעת תגובה לגבי הצגת הלקוחות שלי.
| ייצוג ב-JSON |
{
"customers": [
{
object (Company)
}
],
"nextPageToken": string
} |
| שדות |
customers[] |
object (Company)
חשבונות הלקוח שהמשתמש מבצע את הקריאה החוזרת נכלל בהם.
|
nextPageToken |
string
אסימון שמאפשר לגשת לדף התוצאות הבא. השמטה אם אין תוצאות נוספות.
|
היקפי הרשאות
נדרש היקף הרשאות OAuth הבא:
https://www.googleapis.com/auth/androidworkzerotouchemm
למידע נוסף, ראו סקירה כללית על OAuth 2.0.
אלא אם צוין אחרת, התוכן של דף זה הוא ברישיון Creative Commons Attribution 4.0 ודוגמאות הקוד הן ברישיון Apache 2.0. לפרטים, ניתן לעיין במדיניות האתר Google Developers. Java הוא סימן מסחרי רשום של חברת Oracle ו/או של השותפים העצמאיים שלה.
עדכון אחרון: 2025-07-25 (שעון UTC).
[null,null,["עדכון אחרון: 2025-07-25 (שעון UTC)."],[[["\u003cp\u003eThis endpoint retrieves a list of customer accounts associated with the authenticated user via a \u003ccode\u003eGET\u003c/code\u003e request to \u003ccode\u003ehttps://androiddeviceprovisioning.googleapis.com/v1/customers\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eThe request requires \u003ccode\u003epageSize\u003c/code\u003e and \u003ccode\u003epageToken\u003c/code\u003e as query parameters to manage the number of results per page and navigate through multiple pages of customer accounts.\u003c/p\u003e\n"],["\u003cp\u003eThe request body should be empty for this endpoint, meaning no data should be sent within the request body.\u003c/p\u003e\n"],["\u003cp\u003eThe response body contains a list of customer objects in the \u003ccode\u003ecustomers\u003c/code\u003e field, and an optional \u003ccode\u003enextPageToken\u003c/code\u003e string to retrieve subsequent pages of results if available.\u003c/p\u003e\n"],["\u003cp\u003eAuthorization for this request requires the \u003ccode\u003ehttps://www.googleapis.com/auth/androidworkzerotouchemm\u003c/code\u003e OAuth scope.\u003c/p\u003e\n"]]],["This document outlines the process for listing a user's customer accounts via an HTTP GET request to `https://androiddeviceprovisioning.googleapis.com/v1/customers`. Required query parameters include `pageSize` (1-100) and `pageToken` for pagination. The request body must be empty. A successful response returns a JSON structure containing an array of `customers` (Company objects) and a `nextPageToken` for subsequent pages. Authorization requires the `androidworkzerotouchemm` OAuth scope.\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\nLists the user's customer accounts.\n\n### HTTP request\n\n`GET https://androiddeviceprovisioning.googleapis.com/v1/customers`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Query parameters\n\n| Parameters ||\n|-------------|---------------------------------------------------------------------------------------------------------------------------|\n| `pageSize` | `integer` Required. The maximum number of customers to show in a page of results. A number between 1 and 100 (inclusive). |\n| `pageToken` | `string` A token specifying which result page to return. |\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 for listing my customers.\n\n| JSON representation ||\n|-----------------------------------------------------------------------------------------------------------------------------|---|\n| ``` { \"customers\": [ { object (/zero-touch/reference/customer/rest/v1/customers#Company) } ], \"nextPageToken\": string } ``` |\n\n| Fields ||\n|-----------------|-----------------------------------------------------------------------------------------------------------------------------------------|\n| `customers[]` | `object (`[Company](/zero-touch/reference/customer/rest/v1/customers#Company)`)` The customer accounts the calling user is a member of. |\n| `nextPageToken` | `string` A token used to access the next page of results. Omitted if no further results are available. |\n\n### Authorization Scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/androidworkzerotouchemm`\n\nFor more information, see the [OAuth 2.0 Overview](https://developers.google.com/identity/protocols/OAuth2)."]]
