Method: customers.reports.enumeratePrintJobs

Pobieranie listy zadań drukowania.

Żądanie HTTP

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

Adres URL używa składni transkodowania gRPC.

Parametry ścieżki

Parametry
customer

string

Wymagane. Identyfikator klienta z prefiksem „customers/” lub „customers/my_customer”, aby używać klienta powiązanego z kontem, z którego wysyłane jest żądanie.

Parametry zapytania

Parametry
printerOrgUnitId

string

Identyfikator jednostki organizacyjnej drukarek. Jeśli zostanie określona, zwracane będą tylko zadania drukowania przesłane do drukarek z określonej jednostki organizacyjnej.

pageSize

integer

Liczba zadań drukowania na stronie z zakresu od 0 do 100 włącznie. Jeśli parametr pageSize nie jest określony lub ma wartość zero, rozmiar będzie wynosić 50.

pageToken

string

Token strony otrzymany z poprzedniego wywołania reports.enumeratePrintJobs. Podaj ten token, aby pobrać kolejną stronę. Jeśli nie zostanie podana, zostanie zwrócona pierwsza strona wyników.

Podczas paginacji wszystkie inne parametry przekazane do funkcji reports.enumeratePrintJobs muszą być zgodne z wywołaniem, które dostarczyło token strony.

filter

string

Ciąg zapytania do filtrowania wyników, pola rozdzielone operatorem AND w składni EBNF.

Uwaga: operacje OR nie są obsługiwane w tym filtrze. Uwaga: w przypadku parametru completeTime obsługiwane są tylko komparatory >= i <=. Uwaga: w przypadku parametrów userIdprinterId obsługiwany jest tylko komparator =.

Obsługiwane pola filtrów:

  • completeTime
  • printerId
  • userId
orderBy

string

Pole używane do sortowania wyników. Jeśli nie podasz tu żadnej wartości, wyniki zostaną posortowane malejąco według pola completeTime.

Obsługiwane pola sortowania:

  • tytuł
  • stan
  • Czas utworzenia
  • completeTime
  • documentPageCount
  • colorMode
  • duplexMode
  • drukarka
  • userEmail

Treść żądania

Treść żądania musi być pusta.

Treść odpowiedzi

Odpowiedź zawierająca listę zadań drukowania.

W przypadku powodzenia treść żądania zawiera dane o następującej strukturze:

Zapis JSON
{
  "printJobs": [
    {
      object (PrintJob)
    }
  ],
  "nextPageToken": string,
  "totalSize": string
}
Pola
printJobs[]

object (PrintJob)

Lista żądanych zadań drukowania.

nextPageToken

string

Token, którego można użyć w kolejnym żądaniu, aby pobrać następną stronę. Jeśli pominiesz to pole, nie będzie kolejnych stron.

totalSize

string (int64 format)

Łączna liczba zadań drukowania zgodnych z żądaniem.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

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

PrintJob

Reprezentuje żądanie wydrukowania dokumentu przesłane do drukarki.

Zapis 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
}
Pola
id

string

Unikalny identyfikator zadania drukowania.

title

string

Tytuł dokumentu.

state

enum (State)

Ostateczny stan zadania.

createTime

string (Timestamp format)

Sygnatura czasowa utworzenia zadania drukowania.

Korzysta ze standardu RFC 3339, w którym wygenerowane dane wyjściowe są zawsze znormalizowane do formatu Z i zawierają 0, 3, 6 lub 9 cyfr po przecinku. Akceptowane są też przesunięcia inne niż „Z”. Przykłady: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" lub "2014-10-02T15:01:23+05:30".

completeTime

string (Timestamp format)

Sygnatura czasowa zakończenia zadania drukowania.

Korzysta ze standardu RFC 3339, w którym wygenerowane dane wyjściowe są zawsze znormalizowane do formatu Z i zawierają 0, 3, 6 lub 9 cyfr po przecinku. Akceptowane są też przesunięcia inne niż „Z”. Przykłady: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" lub "2014-10-02T15:01:23+05:30".

documentPageCount

integer

Liczba stron w dokumencie.

colorMode

enum (ColorMode)

Tryb kolorów.

duplexMode

enum (DuplexMode)

Tryb dupleksu.

copyCount

integer

Liczba kopii.

printerId

string

Identyfikator API drukarki używanej do drukowania.

printer

string

Nazwa drukarki użytej do drukowania.

userEmail

string

Podstawowy adres e-mail użytkownika, który przesłał zadanie drukowania.

userId

string

Unikalny identyfikator interfejsu Directory API użytkownika, który przesłał zadanie drukowania.

Stan

Stan zadania drukowania.

Wartości w polu enum
STATE_UNSPECIFIED Zadanie drukowania jest w nieokreślonym stanie.
PRINTED Dokument został wydrukowany.
CANCELLED Zadanie drukowania zostało anulowane.
FAILED Nie udało się wykonać zadania drukowania.

ColorMode

Tryb kolorów zadania drukowania.

Wartości w polu enum
COLOR_MODE_UNSPECIFIED Nie określono.
BLACK_AND_WHITE Czarno-białe.
COLOR Kolor.

DuplexMode

Tryb dwustronny zadania drukowania.

Wartości w polu enum
DUPLEX_MODE_UNSPECIFIED Nie określono.
ONE_SIDED Jednostronne.
TWO_SIDED_LONG_EDGE Dwustronne odwracanie wzdłuż dłuższej krawędzi.
TWO_SIDED_SHORT_EDGE Dwustronne odwracanie wzdłuż krótszej krawędzi.