Method: admin.directory.v1.customers.chrome.printers.list
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
Liste des configurations des imprimantes.
Requête HTTP
GET https://admin.googleapis.com/admin/directory/v1/{parent=customers/*}/chrome/printers
L'URL utilise la syntaxe de transcodage gRPC.
Paramètres de chemin d'accès
Paramètres |
parent |
string
Obligatoire. Nom du client propriétaire de cette collection d'imprimantes. Format: customers/{customer_id}
|
Paramètres de requête
Paramètres |
pageSize |
integer
Nombre maximal d'objets à renvoyer. Le service peut renvoyer un nombre inférieur à cette valeur.
|
pageToken |
string
Jeton de page reçu d'un appel précédent.
|
orgUnitId |
string
Unité organisationnelle pour laquelle vous souhaitez lister les imprimantes. Lorsque org_unit n'est pas présent dans la requête, toutes les imprimantes du client sont renvoyées (ou filtrées). Lorsque org_unit est présent dans la requête, seules les imprimantes disponibles pour cette unité organisationnelle sont renvoyées (propriété ou héritées). Pour savoir si l'imprimante est gérée ou héritée pour cette UO, consultez Printer.org_unit_id.
|
filter |
string
Requête de recherche. La syntaxe de recherche est partagée entre cette API et les pages des imprimantes de la console d'administration.
|
orderBy |
string
Ordre de tri des résultats. Doit être l'une des valeurs suivantes : displayName, description, makeAndModel ou createTime. L'ordre par défaut est croissant, mais vous pouvez afficher l'ordre décroissant en ajoutant "desc" au champ "orderBy". Par exemple, "description desc" renvoie les imprimantes triées par description par ordre décroissant.
|
Corps de la requête
Le corps de la requête doit être vide.
Corps de la réponse
Réponse pour la liste des imprimantes.
Si la requête aboutit, le corps de la réponse contient des données qui ont la structure suivante :
Représentation JSON |
{
"printers": [
{
object (Printer )
}
],
"nextPageToken": string
} |
Champs |
printers[] |
object (Printer )
Liste des imprimantes. Si orgUnitId a été indiqué dans la requête, seules les imprimantes visibles pour cette UO seront renvoyées. Si orgUnitId n'a pas été spécifié dans la requête, toutes les imprimantes sont renvoyées.
|
nextPageToken |
string
Jeton pouvant être envoyé en tant que pageToken pour récupérer la page suivante. Si ce champ est omis, il n'y a pas d'autres pages.
|
Champs d'application des autorisations
Nécessite l'un des champs d'application OAuth suivants :
https://www.googleapis.com/auth/admin.chrome.printers
https://www.googleapis.com/auth/admin.chrome.printers.readonly
Pour en savoir plus, consultez le guide d'autorisation.
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/07/24 (UTC).
[null,null,["Dernière mise à jour le 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)."]]