Method: customers.reports.enumeratePrintJobs

Permet d'obtenir la liste des tâches d'impression.

Requête HTTP

GET https://chromemanagement.googleapis.com/v1/{customer=customers/*}/reports:enumeratePrintJobs

L'URL utilise la syntaxe de transcodage gRPC.

Paramètres de chemin d'accès

Paramètres
customer

string

Obligatoire. Numéro client précédé de "customers/" ou "customers/my_customer" pour utiliser le client associé au compte à l'origine de la demande

Paramètres de requête

Paramètres
printerOrgUnitId

string

ID de l'unité organisationnelle des imprimantes. Si elle est spécifiée, seules les tâches d'impression envoyées aux imprimantes de l'unité organisationnelle spécifiée sont renvoyées.

pageSize

integer

Nombre de tâches d'impression de la page, compris entre 0 et 100. Si la taille de la page n'est pas spécifiée ou égale à zéro, la taille sera de 50.

pageToken

string

Jeton de page reçu lors d'un appel reports.enumeratePrintJobs précédent. Fournissez-le pour récupérer la page suivante. Si cette valeur est omise, la première page de résultats est renvoyée.

Lors de la pagination, tous les autres paramètres fournis à reports.enumeratePrintJobs doivent correspondre à l'appel ayant fourni le jeton de page.

filter

string

Chaîne de requête permettant de filtrer les résultats, champs séparés par l'opérateur ET dans la syntaxe EBNF.

Remarque: Les opérations OR ne sont pas compatibles avec ce filtre. Remarque: Seuls les comparateurs >= et <= sont compatibles avec completeTime. Remarque: Seul le comparateur est pris en charge pour userId et printerId.

Champs de filtre compatibles:

  • completeTime
  • printerId
  • userId
orderBy

string

Champ utilisé pour classer les résultats. Si aucune valeur n'est spécifiée, les résultats sont classés par ordre décroissant des valeurs du champ completeTime.

Champs acceptés pour les tris:

  • title
  • state
  • createTime
  • completeTime
  • documentPageCount
  • colorMode
  • duplexMode
  • imprimante
  • userEmail

Corps de la requête

Le corps de la requête doit être vide.

Corps de la réponse

Réponse contenant la liste des tâches d'impression.

Si la requête aboutit, le corps de la réponse contient des données qui ont la structure suivante :

Représentation JSON
{
  "printJobs": [
    {
      object (PrintJob)
    }
  ],
  "nextPageToken": string,
  "totalSize": string
}
Champs
printJobs[]

object (PrintJob)

Liste des tâches d'impression demandées.

nextPageToken

string

Un jeton, qui peut être utilisé dans une requête ultérieure pour récupérer la page suivante. Si ce champ est omis, il n'y a pas d'autres pages.

totalSize

string (int64 format)

Nombre total de tâches d'impression correspondant à la demande.

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

  • https://www.googleapis.com/auth/chrome.management.reports.readonly

PrintJob

Représente une requête d'impression d'un document envoyé à une imprimante.

Représentation JSON
{
  "id": string,
  "title": string,
  "state": enum (State),
  "createTime": string,
  "completeTime": string,
  "documentPageCount": integer,
  "colorMode": enum (ColorMode),
  "duplexMode": enum (DuplexMode),
  "copyCount": integer,
  "printerId": string,
  "printer": string,
  "userEmail": string,
  "userId": string
}
Champs
id

string

ID unique de la tâche d'impression.

title

string

Titre du document.

state

enum (State)

État final de la tâche.

createTime

string (Timestamp format)

Code temporel de création du job d'impression.

Code temporel au format RFC3339 UTC "Zulu", avec une résolution à la nanoseconde et jusqu'à neuf chiffres fractionnaires. Exemples: "2014-10-02T15:01:23Z" et "2014-10-02T15:01:23.045123456Z".

completeTime

string (Timestamp format)

Code temporel de fin de la tâche d'impression.

Code temporel au format RFC3339 UTC "Zulu", avec une résolution à la nanoseconde et jusqu'à neuf chiffres fractionnaires. Exemples: "2014-10-02T15:01:23Z" et "2014-10-02T15:01:23.045123456Z".

documentPageCount

integer

Nombre de pages du document.

colorMode

enum (ColorMode)

Mode couleur.

duplexMode

enum (DuplexMode)

Mode duplex.

copyCount

integer

Nombre de copies.

printerId

string

Identifiant d'API de l'imprimante utilisée pour l'impression.

printer

string

Nom de l'imprimante utilisée pour l'impression.

userEmail

string

Adresse e-mail principale de l'utilisateur ayant envoyé la tâche d'impression.

userId

string

ID unique de l'API Directory de l'utilisateur qui a envoyé la tâche d'impression.

État

État de la tâche d'impression.

Enums
STATE_UNSPECIFIED L'état de la tâche d'impression n'est pas spécifié.
PRINTED Le document a bien été imprimé.
CANCELLED La tâche d'impression a été annulée.
FAILED Échec de la tâche d'impression.

ColorMode

Mode couleur de la tâche d'impression

Enums
COLOR_MODE_UNSPECIFIED URL indéterminée.
BLACK_AND_WHITE Noir et blanc
COLOR Couleur

DuplexMode

Tâche d'impression en mode duplex.

Enums
DUPLEX_MODE_UNSPECIFIED URL indéterminée.
ONE_SIDED Unilatérale.
TWO_SIDED_LONG_EDGE Retournement des deux côtés sur un bord long.
TWO_SIDED_SHORT_EDGE Retournement des deux côtés sur un bord court.