mostrar lista de clientes
Organiza tus páginas con colecciones
Guarda y categoriza el contenido según tus preferencias.
Un company (denominado cliente) representa una organización única con una cuenta sin intervención manual. Con este método, se muestra una lista de los clientes asociados con tu cuenta de distribuidor.
Firma del método
public ListCustomersResponse listCustomers(ListCustomersRequest request) throws CommonException;
ListCustomersRequest
| Nombre de la propiedad |
Valor |
Obligatorio |
Descripción |
pageSize |
int |
No |
Es el tamaño de la página, hasta 100. Si es mayor que 100 o null, se usa 100. |
pageToken |
string |
No |
Es el token de página. Si está vacío, se muestra la primera página. |
vendorParams |
map |
No |
Campos adicionales, par clave-valor especificado por el proveedor |
ListCustomersResponse
| Nombre de la propiedad |
Valor |
Descripción |
customers |
Lista de object(Company) |
La lista de clientes asociados con el revendedor |
totalCount |
int |
Es el recuento total de dispositivos que coinciden con la solicitud. |
nextPageToken |
strong |
El token de la página siguiente. La columna está vacía para la última página. |
vendorParams |
map |
Campos adicionales, par clave-valor especificado por el proveedor |
Comportamiento del error
Si se produce un error, la biblioteca arroja un CommonException que contiene uno de los siguientes códigos de error:
| Código de error |
INTERNAL_SERVER_ERROR |
INVALID_PAGE_TOKEN |
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-08-29 (UTC)
[null,null,["Última actualización: 2025-08-29 (UTC)"],[[["\u003cp\u003eA company, referred to as a customer, represents an organization with a zero-touch account.\u003c/p\u003e\n"],["\u003cp\u003eThis method \u003ccode\u003elistCustomers\u003c/code\u003e is used to list customers associated with a reseller account.\u003c/p\u003e\n"],["\u003cp\u003eThe request for the list of customers can be customized using \u003ccode\u003epageSize\u003c/code\u003e, \u003ccode\u003epageToken\u003c/code\u003e, and \u003ccode\u003evendorParams\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003eListCustomersResponse\u003c/code\u003e provides a list of customers, total customer count, the next page token, and extra vendor parameters.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003elistCustomers\u003c/code\u003e method can throw a \u003ccode\u003eCommonException\u003c/code\u003e with \u003ccode\u003eINTERNAL_SERVER_ERROR\u003c/code\u003e or \u003ccode\u003eINVALID_PAGE_TOKEN\u003c/code\u003e error codes.\u003c/p\u003e\n"]]],["The `listCustomers` method retrieves a list of customer organizations associated with a reseller account. It accepts a `ListCustomersRequest` with optional `pageSize` (up to 100), `pageToken`, and `vendorParams`. The response, `ListCustomersResponse`, includes a list of `customers`, `totalCount`, `nextPageToken` for pagination, and `vendorParams`. Errors are returned as `CommonException` with codes like `INTERNAL_SERVER_ERROR` or `INVALID_PAGE_TOKEN`.\n"],null,["# listCustomers\n\nA [`company`](/zero-touch/reseller-library/reference/objects#company) (referred to as a *customer*)\nrepresents a unique organization with a zero-touch account. This method lists\ncustomers associated with your reseller account.\n\nMethod signature\n----------------\n\n public ListCustomersResponse listCustomers(ListCustomersRequest request) throws CommonException;\n\nListCustomersRequest\n--------------------\n\n| Property name | Value | Required | Description |\n|----------------|----------|----------|-----------------------------------------------------------------------------|\n| `pageSize` | `int` | No | The page size, up to `100`. If greater than `100` or `null`, `100` is used. |\n| `pageToken` | `string` | No | The page token. If empty, the first page is returned. |\n| `vendorParams` | `map` | No | Extra fields, vendor specified key-value pair. |\n\nListCustomersResponse\n---------------------\n\n| Property name | Value | Description |\n|-----------------|-----------------------------------------------------------------------------------------|-----------------------------------------------------|\n| `customers` | List of `object(`[`Company`](/zero-touch/reseller-library/reference/objects#company)`)` | The list of customers associated with the reseller. |\n| `totalCount` | `int` | The total count of devices matching the request. |\n| `nextPageToken` | `strong` | The next page token. Empty for the last page. |\n| `vendorParams` | `map` | Extra fields, vendor specified key-value pair. |\n\nError behavior\n--------------\n\nIf an error occurs, the library throws a `CommonException` containing one of the\nfollowing error codes:\n\n| Error code |\n|-------------------------|\n| `INTERNAL_SERVER_ERROR` |\n| `INVALID_PAGE_TOKEN` |"]]
