Method: customers.list
Organiza tus páginas con colecciones
Guarda y categoriza el contenido según tus preferencias.
Muestra las cuentas de cliente del usuario.
Solicitud HTTP
GET https://androiddeviceprovisioning.googleapis.com/v1/customers
La URL usa la sintaxis de la transcodificación gRPC.
Parámetros de consulta
| Parámetros |
pageSize |
integer
Obligatorio. Es la cantidad máxima de clientes que se mostrarán en una página de resultados. Un número entre 1 y 100 (inclusive).
|
pageToken |
string
Un token que especifica qué página de resultados se mostrará.
|
Cuerpo de la solicitud
El cuerpo de la solicitud debe estar vacío.
Cuerpo de la respuesta
Si se ejecuta correctamente, el cuerpo de la respuesta contendrá datos con la siguiente estructura:
Mensaje de respuesta para enumerar mis clientes.
| Representación JSON |
{
"customers": [
{
object (Company)
}
],
"nextPageToken": string
} |
| Campos |
customers[] |
object (Company)
Las cuentas de cliente de las que es miembro el usuario que realiza la llamada
|
nextPageToken |
string
Es un token que se usa para acceder a la siguiente página de resultados. Se omite si no hay más resultados disponibles.
|
Alcances de la autorización
Requiere el siguiente alcance de OAuth:
https://www.googleapis.com/auth/androidworkzerotouchemm
Para obtener más información, consulta la descripción general de OAuth 2.0.
Salvo que se indique lo contrario, el contenido de esta página está sujeto a la licencia Atribución 4.0 de Creative Commons, y los ejemplos de código están sujetos a la licencia Apache 2.0. Para obtener más información, consulta las políticas del sitio de Google Developers. Java es una marca registrada de Oracle o sus afiliados.
Última actualización: 2025-07-25 (UTC)
[null,null,["Última actualización: 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)."]]
