Method: admin.chrome.v1.customers.chrome.printers.printJobs.list

Wyświetlenie listy zadań drukowania.

Żądanie HTTP

GET https://admin.googleapis.com/admin/chrome/v1/{parent=customers/*/chrome/printers/*}/printJobs

Adres URL używa składni transkodowania gRPC.

Parametry ścieżki

Parametry
parent

string

Wymagany. Nadrzędny, który jest właścicielem tej kolekcji zadań drukowania. Format: customer/{customer-id}/chrome/printers/{printer-id} identyfikator drukarki może mieć wartość -, aby wyświetlać zadania drukowania na wszystkich drukarkach.

Parametry zapytania

Parametry
pageSize

integer

Liczba zadań drukowania na stronie z zakresu od 0 do 100 włącznie. Jeśli wartość pageSize nie jest określona lub wynosić 0, rozmiar wynosi 50.
pageToken

string

Token strony otrzymany z poprzedniego wywołania printJobs.list. Podaj go, aby pobrać następną stronę. W przypadku pominięcia tego ustawienia zwracana jest pierwsza strona wyników.

W podziale na strony wszystkie pozostałe parametry w żądaniu printJobs.list muszą być zgodne z wywołaniem tokena strony.
filter

string

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

Operacje LUB nie są obsługiwane w tym filtrze. W przypadku tagu completionTime obsługiwane są tylko tagi >= i <=. Tylko porównanie obsługiwane w przypadku znaczników userEmail i orgUnitId. Filtrowanie według wartości userEmail lub orgUnitId jest obsługiwane tylko wtedy, gdy {printer-id} ma wartość „-”. orgUnitId oznacza pole orgUnitId drukarki nadrzędnej.

Obsługiwane pola filtrów:

  • completionTime
  • orgUnitId
  • userEmail
orderBy

string

Pole używane do sortowania wyników. Jeśli nie określono wyników, wyniki są uporządkowane według atrybutu completionTime.

Obsługiwane pola według:

  • device
  • pageCount
  • creationTime
  • completionTime
  • status
  • printer
  • userEmail
  • title
  • color
  • duplex

Treść żądania

Treść żądania musi być pusta.

Treść odpowiedzi

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

Odpowiedź zawierająca listę zadań drukowania.

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

object (PrintJob)

Lista żądanych zadań drukowania.
nextPageToken

string

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

integer

Łączna liczba wyników.

Zakresy autoryzacji

Wymaga jednego z tych zakresów OAuth:

  • https://www.googleapis.com/auth/admin.chrome.printers
  • https://www.googleapis.com/auth/admin.chrome.printers.readonly

Więcej informacji znajdziesz w omówieniu protokołu OAuth 2.0.

Zadanie drukowania

PrintJob to żądanie wydrukowania dokumentu przesłanego do drukarki.

Zapis JSON 
{
  "name": string,
  "title": string,
  "state": enum (State),
  "creationTime": string,
  "completionTime": string,
  "pageCount": integer,
  "color": enum (ColorMode),
  "duplex": enum (DuplexMode),
  "mediaSize": {
    object (MediaSize)
  },
  "copyCount": integer,
  "printerId": string,
  "printer": string,
  "userId": string,
  "userEmail": string,
  "deviceId": string
}
Pola
name

string

Nazwa zasobu zadania drukowania. Format: customers/{customer-id}/printers/{printer-id}/printJobs/{print-job-id}
title

string

Tytuł dokumentu.
state

enum (State)

Ostatni stan zadania.
creationTime

string (Timestamp format)

Sygnatura czasowa utworzenia zadania drukowania.

Sygnatura czasowa w formacie „Zulu” UTC3339, z rozdzielczością nanosekundą i maksymalnie 9 cyframi. Przykłady: "2014-10-02T15:01:23Z" i "2014-10-02T15:01:23.045123456Z".
completionTime

string (Timestamp format)

Sygnatura czasowa zakończenia zadania drukowania.

Sygnatura czasowa w formacie „Zulu” UTC3339, z rozdzielczością nanosekundą i maksymalnie 9 cyframi. Przykłady: "2014-10-02T15:01:23Z" i "2014-10-02T15:01:23.045123456Z".
pageCount

integer

Liczba stron w dokumencie.
color

enum (ColorMode)

Tryb kolorów.
duplex

enum (DuplexMode)

Tryb dwustronny.
mediaSize

object (MediaSize)

Rozmiar multimediów zadania drukowania.
copyCount

integer

Liczba kopii.
printerId

string

Identyfikator interfejsu Printer API.
printer

string

Nazwa drukarki używanej do drukowania.
userId

string

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

string

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

string

Unikalny identyfikator interfejsu Directory API urządzenia użytego do przesłania zadania drukowania.

Stan

Stan zadania drukowania.

Wartości w polu enum
STATE_UNSPECIFIED Zadanie drukowania jest w nieokreślonym stanie.
STATE_PRINTED Dokument został wydrukowany.
STATE_CANCELED Zadanie drukowania zostało anulowane.
STATE_FAILED Zadanie drukowania nie powiodło się.

Tryb kolorów

Tryb koloru zadania drukowania.

Wartości w polu enum
COLOR_MODE_UNSPECIFIED Nie określono.
COLOR_MODE_BLACK_AND_WHITE Czarno-białe.
COLOR_MODE_COLORED Kolorowe.

Tryb dwustronny

Tryb duplikowania zadań drukowania.

Wartości w polu enum
DUPLEX_MODE_UNSPECIFIED Nie określono.
DUPLEX_MODE_ONE_SIDED Jest jednostronna.
DUPLEX_MODE_TWO_SIDED_LONG_EDGE Dwustronne odwracanie się wzdłuż dłuższej krawędzi.
DUPLEX_MODE_TWO_SIDED_SHORT_EDGE Dwustronne odwracanie się wzdłuż krótszej krawędzi.

MediaSize

Rozmiar multimediów zadania drukowania.

Zapis JSON 
{
  "width": integer,
  "height": integer,
  "vendorId": string
}
Pola
width

integer

Szerokość (w mikrometrach).
height

integer

Wysokość (w mikrometrach).
vendorId

string

Identyfikator podany przez dostawcę – np. iso_a3_297x420mm lub na_index-3x5_3x5in. Możliwe wartości atrybutu IPP: media. Więcej informacji znajdziesz w artykule na temat rejestracji IPP.