Method: customers.reports.enumeratePrintJobs

Obtén una lista de trabajos de impresión.

Solicitud HTTP

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

La URL usa la sintaxis de la transcodificación gRPC.

Parámetros de ruta

Parámetros
customer

string

Obligatorio. ID de cliente con el prefijo "customers/" o "customers/my_customer" para usar el cliente asociado a la cuenta que realiza la solicitud.

Parámetros de consulta

Parámetros
printerOrgUnitId

string

Es el ID de la unidad organizativa de las impresoras. Si se especifica, solo se devolverán los trabajos de impresión enviados a las impresoras de la unidad organizativa especificada.

pageSize

integer

Cantidad de trabajos de impresión en la página, del 0 al 100 inclusive. Si no se especifica pageSize o es cero, el tamaño será 50.

pageToken

string

Es un token de página que se recibió de una llamada a reports.enumeratePrintJobs anterior. Proporciona esto para recuperar la página siguiente. Si se omite, se devolverá la primera página de resultados.

Cuando se pagina, todos los demás parámetros proporcionados a reports.enumeratePrintJobs deben coincidir con la llamada que proporcionó el token de la página.

filter

string

Es la cadena de consulta para filtrar los resultados, con campos separados por AND en sintaxis de EBNF.

Nota: Las operaciones OR no se admiten en este filtro. Nota: Solo se admiten los comparadores >= y <= para completeTime. Nota: Solo se admite el comparador = para userId y printerId.

Campos de filtro admitidos:

  • completeTime
  • printerId
  • userid
orderBy

string

Campo que se usa para ordenar los resultados. Si no se especifica, los resultados se ordenarán de forma descendente según el campo completeTime.

Campos admitidos para ordenar:

  • título
  • state
  • createTime
  • completeTime
  • documentPageCount
  • colorMode
  • duplexMode
  • impresora
  • userEmail

Cuerpo de la solicitud

El cuerpo de la solicitud debe estar vacío.

Cuerpo de la respuesta

Es la respuesta que contiene una lista de trabajos de impresión.

Si se ejecuta correctamente, el cuerpo de la respuesta contendrá datos con la siguiente estructura:

Representación JSON
{
  "printJobs": [
    {
      object (PrintJob)
    }
  ],
  "nextPageToken": string,
  "totalSize": string
}
Campos
printJobs[]

object (PrintJob)

Es la lista de trabajos de impresión solicitados.

nextPageToken

string

Es un token que se puede usar en una solicitud posterior para recuperar la página siguiente. Si se omite este campo, no habrá páginas siguientes.

totalSize

string (int64 format)

Es la cantidad total de trabajos de impresión que coinciden con la solicitud.

Permisos de autorización

Requiere el siguiente permiso de OAuth:

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

PrintJob

Representa una solicitud para imprimir un documento que se envió a una impresora.

Representación 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
}
Campos
id

string

Es el ID único del trabajo de impresión.

title

string

Es el título del documento.

state

enum (State)

Es el estado final del trabajo.

createTime

string (Timestamp format)

Es la marca de tiempo de creación del trabajo de impresión.

Usa el formato RFC 3339, en el que el resultado generado siempre usará la normalización Z y los dígitos fraccionarios 0, 3, 6 o 9. También se aceptan otras compensaciones que no sean “Z”. Ejemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".

completeTime

string (Timestamp format)

Es la marca de tiempo de finalización del trabajo de impresión.

Usa el formato RFC 3339, en el que el resultado generado siempre usará la normalización Z y los dígitos fraccionarios 0, 3, 6 o 9. También se aceptan otras compensaciones que no sean “Z”. Ejemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".

documentPageCount

integer

Es la cantidad de páginas del documento.

colorMode

enum (ColorMode)

Modo de color.

duplexMode

enum (DuplexMode)

Modo dúplex.

copyCount

integer

Cantidad de copias

printerId

string

Es el ID de la API de la impresora que se usa para imprimir.

printer

string

Nombre de la impresora que se usó para imprimir.

userEmail

string

Es la dirección de correo electrónico principal del usuario que envió el trabajo de impresión.

userId

string

Es el ID único de la API de Directory del usuario que envió el trabajo de impresión.

Estado

Es el estado del trabajo de impresión.

Enums
STATE_UNSPECIFIED El trabajo de impresión se encuentra en un estado no especificado.
PRINTED El documento se imprimió correctamente.
CANCELLED Se canceló el trabajo de impresión.
FAILED No se pudo realizar el trabajo de impresión.

ColorMode

Modo de color del trabajo de impresión.

Enums
COLOR_MODE_UNSPECIFIED Sin especificar.
BLACK_AND_WHITE Blanco y negro.
COLOR Color

DuplexMode

Modo dúplex del trabajo de impresión.

Enums
DUPLEX_MODE_UNSPECIFIED Sin especificar.
ONE_SIDED Un solo lado.
TWO_SIDED_LONG_EDGE Volteo a doble cara sobre el borde largo.
TWO_SIDED_SHORT_EDGE Volteo a doble cara sobre el borde corto.