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.

Suchparameter

Parameter
printerOrgUnitId

string

Die ID der Organisationseinheit für Drucker. Wenn angegeben, werden nur Druckaufträge zurückgegeben, die an Drucker aus der angegebenen Organisationseinheit gesendet wurden.

pageSize

integer

Die Anzahl der Druckaufträge auf der Seite. Wenn „pageSize“ nicht angegeben oder null ist, beträgt die Größe 50. Die Anzahl kann zwischen 0 und 100 liegen.

pageToken

string

Ein Seitentoken, das von einem vorherigen reports.enumeratePrintJobs-Aufruf empfangen wurde. Geben Sie dieses an, um die nachfolgende Seite abzurufen. Wenn nicht angegeben, wird die erste Seite der Ergebnisse 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

Abfragestring zum Filtern von Ergebnissen, mit UND verknüpfte Felder in EBNF-Syntax.

Hinweis: OR-Operationen werden in diesem Filter nicht unterstützt. Hinweis: Für completeTime werden nur die Vergleichsoperatoren >= und <= unterstützt. Hinweis: Für userId und printerId wird nur der Vergleichsoperator = unterstützt.

Unterstützte Filterfelder:

  • completeTime
  • printerId
  • userId
orderBy

string

Feld, das zum Sortieren der Ergebnisse verwendet wird. Wenn nicht angegeben, werden die Ergebnisse in absteigender Reihenfolge des Felds completeTime sortiert.

Unterstützte Felder für die Sortierung:

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

Anfragetext

Der Anfragetext muss leer sein.

Antworttext

Antwort mit einer Liste von Druckaufträgen.

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 Druckaufträge, 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, die 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 Druckauftrags.

title

string

Der Titel des Dokuments

state

enum (State)

Der endgültige Status des Jobs.

createTime

string (Timestamp format)

Zeitstempel der Erstellung des Druckauftrags.

Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30".

completeTime

string (Timestamp format)

Zeitstempel des Abschlusses des Druckauftrags.

Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30".

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 für den Druck verwendeten Druckers.

printer

string

Name des für den Druck verwendeten Druckers.

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.

Bundesland

Status des Druckauftrags.

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

ColorMode

Farbmodus des Druckauftrags.

Enums
COLOR_MODE_UNSPECIFIED Nicht angegeben
BLACK_AND_WHITE Schwarzweiß
COLOR Farbe

DuplexMode

Duplexmodus des Druckauftrags.

Enums
DUPLEX_MODE_UNSPECIFIED Nicht angegeben
ONE_SIDED Einseitig
TWO_SIDED_LONG_EDGE Zweiseitig, lange Kante
TWO_SIDED_SHORT_EDGE Zweiseitig, kurze Kante