Method: customers.reports.enumeratePrintJobs

Liste der Druckaufträge abrufen

HTTP-Anfrage

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

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
customer

string

Erforderlich. Kundennummer mit dem Präfix „customers/“ oder „customers/my_customer“, um den Kunden zu verwenden, der mit dem Konto verknüpft ist, von dem die Anfrage stammt.

Abfrageparameter

Parameter
printerOrgUnitId

string

Die ID der Organisationseinheit für Drucker. Falls angegeben, werden nur Druckjobs zurückgegeben, die an Drucker der angegebenen Organisationseinheit gesendet wurden.

pageSize

integer

Die Anzahl der Druckaufträge auf der Seite zwischen 0 und 100. Wenn „pageSize“ nicht angegeben oder null ist, wird „50“ verwendet.

pageToken

string

Ein Seitentoken, das von einem vorherigen reports.enumeratePrintJobs-Aufruf empfangen wurde. Geben Sie diese an, um die nachfolgende Seite abzurufen. Wird kein Wert angegeben, wird die erste Ergebnisseite zurückgegeben.

Beim Paginieren müssen alle anderen für reports.enumeratePrintJobs bereitgestellten Parameter mit dem Aufruf übereinstimmen, der das Seitentoken bereitgestellt hat.

filter

string

Abfragezeichenfolge zum Filtern von Ergebnissen, UND-getrennte Felder in der EBNF-Syntax.

Hinweis: ODER-Vorgänge werden in diesem Filter nicht unterstützt. Hinweis: Für completeTime werden nur die Vergleichszeichen „>=“ und „<=“ unterstützt. Hinweis: Für userId und printerId wird nur der Vergleichsoperator „=“ unterstützt.

Unterstützte Filterfelder:

  • completeTime
  • printerId
  • userId
orderBy

string

Feld, anhand dessen die Ergebnisse sortiert werden. Wenn nicht angegeben, werden die Ergebnisse in absteigender Reihenfolge nach dem Feld completeTime sortiert.

Unterstützte Felder für die Sortierung nach:

  • Titel
  • Bundesstaat
  • createTime
  • completeTime
  • documentPageCount
  • colorMode
  • duplexMode
  • drucker
  • userEmail

Anfragetext

Der Anfragetext muss leer sein.

Antworttext

Antwort mit einer Liste von Druckjobs.

Bei Erfolg enthält der Antworttext Daten mit der folgenden Struktur:

JSON-Darstellung
{
  "printJobs": [
    {
      object (PrintJob)
    }
  ],
  "nextPageToken": string,
  "totalSize": string
}
Felder
printJobs[]

object (PrintJob)

Liste der angeforderten Druckaufträge.

nextPageToken

string

Ein Token, das in einer nachfolgenden Anfrage verwendet werden kann, um die nächste Seite abzurufen. Wenn dieses Feld weggelassen wird, gibt es keine nachfolgenden Seiten.

totalSize

string (int64 format)

Gesamtzahl der Druckjobs, die der Anfrage entsprechen.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

PrintJob

Stellt eine Anfrage zum Drucken eines Dokuments dar, das an einen Drucker gesendet wurde.

JSON-Darstellung
{
  "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
}
Felder
id

string

Eindeutige ID des Druckjobs.

title

string

Der Titel des Dokuments.

state

enum (State)

Der endgültige Status des Jobs.

createTime

string (Timestamp format)

Zeitstempel der Joberstellung.

Ein Zeitstempel im Format RFC3339 UTC "Zulu" mit einer Auflösung im Nanosekundenbereich und bis zu neun Nachkommastellen. Beispiele: "2014-10-02T15:01:23Z" und "2014-10-02T15:01:23.045123456Z".

completeTime

string (Timestamp format)

Zeitstempel für den Abschluss des Druckauftrags.

Ein Zeitstempel im Format RFC3339 UTC "Zulu" mit einer Auflösung im Nanosekundenbereich und bis zu neun Nachkommastellen. Beispiele: "2014-10-02T15:01:23Z" und "2014-10-02T15:01:23.045123456Z".

documentPageCount

integer

Anzahl der Seiten im Dokument.

colorMode

enum (ColorMode)

Farbmodus

duplexMode

enum (DuplexMode)

Duplexmodus

copyCount

integer

Anzahl der Kopien.

printerId

string

API-ID des Druckers, der zum Drucken verwendet wird.

printer

string

Name des Druckers, der für den Druck verwendet wird.

userEmail

string

Die primäre E-Mail-Adresse des Nutzers, der den Druckauftrag gesendet hat.

userId

string

Die eindeutige Directory API-ID des Nutzers, der den Druckauftrag gesendet hat.

Status

Status des Druckauftrags.

Enums
STATE_UNSPECIFIED Der Status des Druckauftrags ist nicht spezifiziert.
PRINTED Das Dokument wurde gedruckt.
CANCELLED Der Druckauftrag wurde abgebrochen.
FAILED Druckauftrag fehlgeschlagen.

ColorMode

Farbmodus des Druckjobs.

Enums
COLOR_MODE_UNSPECIFIED Nicht angegeben
BLACK_AND_WHITE Schwarz-Weiß.
COLOR Farbe.

DuplexMode

Duplexmodus für Druckauftrag.

Enums
DUPLEX_MODE_UNSPECIFIED Nicht angegeben
ONE_SIDED Einseitig.
TWO_SIDED_LONG_EDGE Beidseitiger Umschlag über die lange Seite.
TWO_SIDED_SHORT_EDGE Beidseitig, kurze Kante