Method: customers.reports.enumeratePrintJobs

Obtenez 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 pour les imprimantes. Si cette option est spécifiée, seules les tâches d'impression envoyées aux imprimantes de l'unité organisationnelle spécifiée seront renvoyées.

pageSize

integer

Nombre de tâches d'impression sur la page (de 0 à 100 inclus). Si pageSize n'est pas spécifié ou est défini sur zéro, la taille est de 50.

pageToken

string

Jeton de page reçu d'un appel reports.enumeratePrintJobs précédent. Fournissez-le pour récupérer la page suivante. Si elle 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. Les champs sont séparés par un opérateur AND dans la syntaxe EBNF.

Remarque : Les opérations OR ne sont pas acceptées dans ce filtre. Remarque : Seuls les comparateurs ">=" et "<=" sont acceptés pour completeTime. Remarque : Seul le comparateur "=" est accepté pour userId et printerId.

Champs de filtre acceptés :

  • completeTime
  • printerId
  • userId
orderBy

string

Champ utilisé pour trier les résultats. Si aucun ordre n'est spécifié, les résultats seront classés par ordre décroissant du champ completeTime.

Champs "order by" acceptés :

  • 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 une liste de 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

Jeton pouvant ê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 requête.

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 demande d'impression d'un document qui a été envoyée à 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 du job.

createTime

string (Timestamp format)

Code temporel de création de la tâche d'impression.

Utilise la norme RFC 3339, où la sortie générée utilise toujours le format UTC (indiqué par "Z" pour le temps universel coordonné) avec des secondes fractionnaires de 0, 3, 6 ou 9 chiffres décimaux. Des décalages horaires autres que "Z" (UTC) sont également acceptés. Exemples : "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".

completeTime

string (Timestamp format)

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

Utilise la norme RFC 3339, où la sortie générée utilise toujours le format UTC (indiqué par "Z" pour le temps universel coordonné) avec des secondes fractionnaires de 0, 3, 6 ou 9 chiffres décimaux. Des décalages horaires autres que "Z" (UTC) sont également acceptés. Exemples : "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".

documentPageCount

integer

Nombre de pages du document.

colorMode

enum (ColorMode)

Mode couleur.

duplexMode

enum (DuplexMode)

Mode duplex.

copyCount

integer

Nombre de copies.

printerId

string

ID 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 qui a envoyé la tâche d'impression.

userId

string

ID d'API Directory unique de l'utilisateur ayant 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 Non spécifié.
BLACK_AND_WHITE Noir et blanc.
COLOR Couleur

DuplexMode

Mode recto verso de la tâche d'impression.

Enums
DUPLEX_MODE_UNSPECIFIED Non spécifié.
ONE_SIDED Recto uniquement.
TWO_SIDED_LONG_EDGE Recto verso, retourner sur le bord long.
TWO_SIDED_SHORT_EDGE Recto verso, retourner sur le bord court.