Method: admin.directory.v1.customers.chrome.printers.list
Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
Listar as configurações das impressoras.
Solicitação HTTP
GET https://admin.googleapis.com/admin/directory/v1/{parent=customers/*}/chrome/printers
O URL usa a sintaxe de transcodificação gRPC.
Parâmetros de caminho
Parâmetros |
parent |
string
Obrigatório. O nome do cliente que tem essa coleção de impressoras. Formato: customers/{customer_id}
|
Parâmetros de consulta
Parâmetros |
pageSize |
integer
O número máximo de objetos a serem retornados. O serviço pode retornar menos que esse valor.
|
pageToken |
string
Um token de página recebido de uma chamada anterior.
|
orgUnitId |
string
Unidade organizacional para a qual queremos listar as impressoras. Quando org_unit não está presente na solicitação, todas as impressoras do cliente são retornadas (ou filtradas). Quando org_unit está presente na solicitação, apenas as impressoras disponíveis para essa unidade organizacional são retornadas (próprias ou herdadas). Para saber se a impressora é de propriedade ou herdada para essa OU, verifique Printer.org_unit_id.
|
filter |
string
Consulta de pesquisa. A sintaxe de pesquisa é compartilhada entre esta API e as páginas de impressoras do Admin Console.
|
orderBy |
string
A ordem de classificação dos resultados. Precisa ser displayName, description, makeAndModel ou createTime. A ordem padrão é crescente, mas a ordem decrescente pode ser retornada anexando "desc" ao campo "orderBy". Por exemplo, "description desc" retorna as impressoras classificadas por descrição em ordem decrescente.
|
Corpo da solicitação
O corpo da solicitação precisa estar vazio.
Corpo da resposta
Resposta para listar impressoras.
Se bem-sucedido, o corpo da resposta incluirá dados com a estrutura a seguir:
Representação JSON |
{
"printers": [
{
object (Printer )
}
],
"nextPageToken": string
} |
Campos |
printers[] |
object (Printer )
Lista de impressoras. Se orgUnitId foi fornecido na solicitação, apenas as impressoras visíveis para essa unidade organizacional serão retornadas. Se orgUnitId não foi informado na solicitação, todas as impressoras serão retornadas.
|
nextPageToken |
string
Um token, que pode ser enviado como pageToken para recuperar a próxima página. Se esse campo for omitido, não haverá páginas subsequentes.
|
Escopos de autorização
Requer um dos seguintes escopos do OAuth:
https://www.googleapis.com/auth/admin.chrome.printers
https://www.googleapis.com/auth/admin.chrome.printers.readonly
Para mais informações, consulte o guia de autorização.
Exceto em caso de indicação contrária, o conteúdo desta página é licenciado de acordo com a Licença de atribuição 4.0 do Creative Commons, e as amostras de código são licenciadas de acordo com a Licença Apache 2.0. Para mais detalhes, consulte as políticas do site do Google Developers. Java é uma marca registrada da Oracle e/ou afiliadas.
Última atualização 2025-07-24 UTC.
[null,null,["Última atualização 2025-07-24 UTC."],[],[],null,["# Method: admin.directory.v1.customers.chrome.printers.list\n\nList printers configs.\n\n### HTTP request\n\n`GET https://admin.googleapis.com/admin/directory/v1/{parent=customers/*}/chrome/printers`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|----------|-------------------------------------------------------------------------------------------------------------------|\n| `parent` | `string` Required. The name of the customer who owns this collection of printers. Format: customers/{customer_id} |\n\n### Query parameters\n\n| Parameters ||\n|-------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `pageSize` | `integer` The maximum number of objects to return. The service may return fewer than this value. |\n| `pageToken` | `string` A page token, received from a previous call. |\n| `orgUnitId` | `string` Organization Unit that we want to list the printers for. When org_unit is not present in the request then all printers of the customer are returned (or filtered). When org_unit is present in the request then only printers available to this OU will be returned (owned or inherited). You may see if printer is owned or inherited for this OU by looking at Printer.org_unit_id. |\n| `filter` | `string` Search query. Search syntax is shared between this api and Admin Console printers pages. |\n| `orderBy` | `string` The order to sort results by. Must be one of displayName, description, makeAndModel, or createTime. Default order is ascending, but descending order can be returned by appending \"desc\" to the orderBy field. For instance, \"description desc\" will return the printers sorted by description in descending order. |\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nResponse for listing printers.\n\nIf successful, the response body contains data with the following structure:\n\n| JSON representation |\n|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"printers\": [ { object (/workspace/admin/chrome-printer/reference/rest/v1/admin.directory.v1.customers.chrome.printers#Printer) } ], \"nextPageToken\": string } ``` |\n\n| Fields ||\n|-----------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `printers[]` | `object (`[Printer](/workspace/admin/chrome-printer/reference/rest/v1/admin.directory.v1.customers.chrome.printers#Printer)`)` List of printers. If `orgUnitId` was given in the request, then only printers visible for this OU will be returned. If `orgUnitId` was not given in the request, then all printers will be returned. |\n| `nextPageToken` | `string` A token, which can be sent as `pageToken` to retrieve the next page. If this field is omitted, there are no subsequent pages. |\n\n### Authorization scopes\n\nRequires one of the following OAuth scopes:\n\n- `https://www.googleapis.com/auth/admin.chrome.printers`\n- `\n https://www.googleapis.com/auth/admin.chrome.printers.readonly`\n\nFor more information, see the [Authorization guide](/workspace/guides/configure-oauth-consent)."]]