Method: admin.directory.v1.customers.chrome.printers.list

Lister les configurations d'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 nous voulons 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 l'élément org_unit est présent dans la requête, seules les imprimantes disponibles pour cette unité organisationnelle sont renvoyées (dont vous êtes propriétaire ou hérité). Vous pouvez voir si l'imprimante appartient à cette unité organisationnelle ou en a hérité en consultant la page 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'un des éléments suivants : displayName, description, makeAndModel ou createTime. L'ordre par défaut est croissant, mais l'ordre décroissant peut être renvoyé en ajoutant "desc" au champ "orderBy". Par exemple, "description desc". renverra les imprimantes triées par description dans l'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 l'affichage de 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 unité organisationnelle seront renvoyées. Si orgUnitId n'a pas été indiqué 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 relatif aux autorisations.