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 de acceso

Parámetros
customer

string

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

Parámetros de consulta

Parámetros
printerOrgUnitId

string

El ID de la unidad organizativa para las impresoras. Si se especifica, solo se mostrarán trabajos de impresión enviados a impresoras desde la unidad organizativa especificada.

pageSize

integer

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

pageToken

string

Un token de página recibido de una llamada reports.enumeratePrintJobs anterior. Proporciona esto para recuperar la página siguiente. Si se omite, se mostrará 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

Cadena de consulta para filtrar resultados y campos separados por Y en la sintaxis EBNF.

Nota: Este filtro no admite las operaciones OR. Nota: Solo se admiten comparadores >= y <= para completeTime. Nota: Solo = se admite el comparador para userId y printerId.

Campos de filtro admitidos:

  • completeTime
  • printerId
  • userid
orderBy

string

Es el campo que se usa para ordenar los resultados. Si no se especifica, los resultados se ordenarán en orden descendente del campo completeTime.

Orden admitido por campos:

  • 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

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)

Lista de trabajos de impresión solicitados.

nextPageToken

string

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

totalSize

string (int64 format)

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

Alcances de autorización

Requiere el siguiente alcance 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)

El estado final del trabajo.

createTime

string (Timestamp format)

Marca de tiempo de creación del trabajo de impresión.

Una marca de tiempo en formato RFC3339 UTC “Zulú”, con una resolución de nanosegundos y hasta nueve dígitos fraccionarios. Ejemplos: "2014-10-02T15:01:23Z" y "2014-10-02T15:01:23.045123456Z".

completeTime

string (Timestamp format)

Marca de tiempo de finalización del trabajo de impresión.

Una marca de tiempo en formato RFC3339 UTC “Zulú”, con una resolución de nanosegundos y hasta nueve dígitos fraccionarios. Ejemplos: "2014-10-02T15:01:23Z" y "2014-10-02T15:01:23.045123456Z".

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 API de la impresora que se usa para imprimir.

printer

string

Es el nombre de la impresora que se usó para imprimir.

userEmail

string

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

userId

string

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

Estado

Estado del trabajo de impresión.

Enumeraciones
STATE_UNSPECIFIED El estado del trabajo de impresión no se especifica.
PRINTED El documento se imprimió correctamente.
CANCELLED Se canceló el trabajo de impresión.
FAILED Se produjo un error en el trabajo de impresión.

ColorMode

Modo de color del trabajo de impresión.

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

DuplexMode

Modo doble del trabajo de impresión.

Enumeraciones
DUPLEX_MODE_UNSPECIFIED Sin especificar.
ONE_SIDED Unilateral.
TWO_SIDED_LONG_EDGE Giro de dos lados sobre borde largo.
TWO_SIDED_SHORT_EDGE Giro de dos lados sobre borde corto.