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

Elenca i processi di stampa.

Richiesta HTTP

GET https://admin.googleapis.com/admin/chrome/v1/{parent=customers/*/chrome/printers/*}/printJobs

L'URL utilizza la sintassi di transcodifica gRPC.

Parametri percorso

Parametri
parent

string

Obbligatorio. La risorsa principale, che è proprietaria di questa raccolta di processi di stampa. Formato: customer/{customer-id}/chrome/printers/{printer-id} L'ID stampante può essere - per elencare i processi di stampa in tutte le stampanti.

Parametri di ricerca

Parametri
pageSize

integer

Il numero di processi di stampa nella pagina da 0 a 100 inclusi, se pageSize non è specificato o zero, la dimensione è 50.
pageToken

string

Un token di pagina ricevuto da una chiamata printJobs.list precedente. Forniscilo per recuperare la pagina successiva. Se omessa, viene restituita la prima pagina dei risultati.

Durante l'impaginazione, tutti gli altri parametri forniti a printJobs.list devono corrispondere alla chiamata che ha fornito il token della pagina.
filter

string

Stringa di query per filtrare i risultati, campi separati da AND nella sintassi EBNF.

Le operazioni OR non sono supportate in questo filtro. Solo >= e <= i comparatori sono supportati per completionTime. Solo = comparatore supportato per userEmail e orgUnitId. Il filtro userEmail o orgUnitId è supportato solo quando {printer-id} è contrassegnato come "-". orgUnitId si riferisce al campo orgUnitId della stampante principale.

Campi filtro supportati:

  • completionTime
  • orgUnitId
  • userEmail
orderBy

string

Campo utilizzato per ordinare i risultati. Se non specificato, i risultati vengono ordinati per completionTime.

Ordine supportato per campi:

  • device
  • pageCount
  • creationTime
  • completionTime
  • status
  • printer
  • userEmail
  • title
  • color
  • duplex

Corpo della richiesta

Il corpo della richiesta deve essere vuoto.

Corpo della risposta

In caso di esito positivo, il corpo della risposta contiene dati con la seguente struttura:

Risposta contenente un elenco di processi di stampa.

Rappresentazione JSON 
{
  "printJobs": [
    {
      object (PrintJob)
    }
  ],
  "nextPageToken": string,
  "totalSize": integer
}
Campi
printJobs[]

object (PrintJob)

Elenco dei processi di stampa richiesti.
nextPageToken

string

Un token, che può essere utilizzato in una richiesta successiva per recuperare la pagina successiva. Se questo campo viene omesso, non verranno visualizzate altre pagine.
totalSize

integer

Numero totale di risultati.

Ambiti di autorizzazione

Richiede uno dei seguenti ambiti OAuth:

  • https://www.googleapis.com/auth/admin.chrome.printers
  • https://www.googleapis.com/auth/admin.chrome.printers.readonly

Per ulteriori informazioni, consulta la panoramica su OAuth 2.0.

Processo di stampa

PrintJob rappresenta la richiesta di stampa di un documento che è stato inviato a una stampante.

Rappresentazione JSON 
{
  "name": string,
  "title": string,
  "state": enum (State),
  "creationTime": string,
  "completionTime": string,
  "pageCount": integer,
  "color": enum (ColorMode),
  "duplex": enum (DuplexMode),
  "mediaSize": {
    object (MediaSize)
  },
  "copyCount": integer,
  "printerId": string,
  "printer": string,
  "userId": string,
  "userEmail": string,
  "deviceId": string
}
Campi
name

string

Il nome della risorsa del processo di stampa. Formato: customers/{customer-id}/printers/{printer-id}/printJobs/{print-job-id}
title

string

Il titolo del documento.
state

enum (State)

Lo stato finale del job.
creationTime

string (Timestamp format)

Timestamp creazione processo di stampa.

Un timestamp in formato RFC3339 UTC "Zulu", con risoluzione in nanosecondi e fino a nove cifre frazionarie. Esempi: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".
completionTime

string (Timestamp format)

Timestamp completamento processo di stampa.

Un timestamp in formato RFC3339 UTC "Zulu", con risoluzione in nanosecondi e fino a nove cifre frazionarie. Esempi: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".
pageCount

integer

Numero di pagine nel documento.
color

enum (ColorMode)

Modalità colore
duplex

enum (DuplexMode)

Modalità Duplex.
mediaSize

object (MediaSize)

Dimensioni supporto stampa.
copyCount

integer

Numero di copie.
printerId

string

ID API stampante.
printer

string

Nome della stampante utilizzata per la stampa.
userId

string

L'ID API Directory univoco dell'utente che ha inviato il processo di stampa.
userEmail

string

L'indirizzo email principale dell'utente che ha inviato il processo di stampa.
deviceId

string

L'ID API Directory univoco del dispositivo utilizzato per inviare il processo di stampa.

Stato

Stato del processo di stampa.

Enum
STATE_UNSPECIFIED Il processo di stampa è in uno stato non specificato.
STATE_PRINTED Il documento è stato stampato.
STATE_CANCELED Il processo di stampa è stato annullato.
STATE_FAILED Processo di stampa non riuscito.

Modalità colore

Modalità colore processo di stampa.

Enum
COLOR_MODE_UNSPECIFIED Non specificato.
COLOR_MODE_BLACK_AND_WHITE Bianco e nero.
COLOR_MODE_COLORED Colorato.

Modalità Duplex

Modalità di stampa fronte/retro.

Enum
DUPLEX_MODE_UNSPECIFIED Non specificato.
DUPLEX_MODE_ONE_SIDED Solo fronte.
DUPLEX_MODE_TWO_SIDED_LONG_EDGE Capovolto su due lati.
DUPLEX_MODE_TWO_SIDED_SHORT_EDGE Capovolto su due lati.

Dimensioni contenuti multimediali

Dimensioni supporto stampa.

Rappresentazione JSON 
{
  "width": integer,
  "height": integer,
  "vendorId": string
}
Campi
width

integer

Larghezza (in micrometri).
height

integer

Altezza (in micrometri).
vendorId

string

ID fornito dal fornitore, ad esempio iso_a3_297x420mm o na_index-3x5_3x5in. I valori possibili sono i valori dell'attributo IPP media. Per saperne di più, consulta Registrazioni IPP.