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

Mencantumkan tugas pencetakan.

Permintaan HTTP

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

URL menggunakan sintaksis gRPC Transcoding.

Parameter jalur

Parameter
parent

string

Wajib diisi. Induk, yang memiliki koleksi tugas pencetakan ini. Format: customer/{customer-id}/chrome/printers/{printer-id} ID printer dapat berupa - untuk mencantumkan tugas pencetakan di semua printer.

Parameter kueri

Parameter
pageSize

integer

Jumlah tugas pencetakan di halaman dari 0 hingga 100, jika pageSize tidak ditentukan atau nol, ukurannya adalah 50.

pageToken

string

Token halaman yang diterima dari panggilan printJobs.list sebelumnya. Berikan ini untuk mengambil halaman berikutnya. Jika dihilangkan, halaman pertama hasil akan ditampilkan.

Saat melakukan penomoran halaman, semua parameter lain yang disediakan untuk printJobs.list harus cocok dengan panggilan yang menyediakan token halaman.

filter

string

String kueri untuk memfilter hasil, dan kolom yang dipisahkan DAN dalam sintaksis EBNF.

Operasi OR tidak didukung di filter ini. Hanya >= dan <= komparator yang didukung untuk completionTime. Hanya = pembanding yang didukung untuk userEmail dan orgUnitId. Pemfilteran berdasarkan userEmail atau orgUnitId hanya didukung jika {printer-id} adalah '-'. orgUnitId merujuk pada kolom orgUnitId printer induk.

Kolom filter yang didukung:

  • completionTime
  • orgUnitId
  • userEmail
orderBy

string

Kolom digunakan untuk mengurutkan hasil. Jika tidak ditentukan, hasil diurutkan berdasarkan completionTime.

Urutan berdasarkan kolom yang didukung:

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

Isi permintaan

Isi permintaan harus kosong.

Isi respons

Jika berhasil, isi respons memuat data dengan struktur berikut:

Respons yang berisi daftar tugas pencetakan.

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

object (PrintJob)

Daftar tugas pencetakan yang diminta.

nextPageToken

string

Token yang dapat digunakan dalam permintaan berikutnya untuk mengambil halaman berikutnya. Jika kolom ini dihilangkan, tidak ada halaman berikutnya.

totalSize

integer

Total jumlah hasil.

Cakupan Otorisasi

Memerlukan salah satu cakupan OAuth berikut:

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

Untuk informasi selengkapnya, lihat Ringkasan OAuth 2.0.

Tugas Pencetakan

PrintJob mewakili permintaan untuk mencetak dokumen yang telah dikirimkan ke printer.

Representasi 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
}
Kolom
name

string

Nama resource tugas pencetakan. Format: customers/{customer-id}/printers/{printer-id}/printJobs/{print-job-id}

title

string

Judul dokumen.

state

enum (State)

Status terakhir tugas.

creationTime

string (Timestamp format)

Stempel waktu pembuatan tugas pencetakan.

Stempel waktu dalam format RFC3339 UTC "Zulu", dengan resolusi nanodetik dan hingga sembilan digit pecahan. Contoh: "2014-10-02T15:01:23Z" dan "2014-10-02T15:01:23.045123456Z".

completionTime

string (Timestamp format)

Stempel waktu penyelesaian tugas pencetakan.

Stempel waktu dalam format RFC3339 UTC "Zulu", dengan resolusi nanodetik dan hingga sembilan digit pecahan. Contoh: "2014-10-02T15:01:23Z" dan "2014-10-02T15:01:23.045123456Z".

pageCount

integer

Jumlah halaman dalam dokumen.

color

enum (ColorMode)

Mode warna.

duplex

enum (DuplexMode)

Mode dupleks.

mediaSize

object (MediaSize)

Ukuran media tugas pencetakan.

copyCount

integer

Jumlah salinan.

printerId

string

ID API Printer.

printer

string

Nama printer yang digunakan untuk pencetakan.

userId

string

ID Directory API unik pengguna yang mengirimkan tugas pencetakan.

userEmail

string

Alamat email utama pengguna yang mengirimkan tugas pencetakan.

deviceId

string

ID Directory API unik perangkat yang digunakan untuk mengirim tugas pencetakan.

Negara bagian

Status tugas pencetakan.

Enumerasi
STATE_UNSPECIFIED Tugas pencetakan dalam status yang tidak ditentukan.
STATE_PRINTED Dokumen berhasil dicetak.
STATE_CANCELED Tugas pencetakan dibatalkan.
STATE_FAILED Tugas pencetakan gagal.

ModeWarna

Mode warna tugas pencetakan.

Enumerasi
COLOR_MODE_UNSPECIFIED Tidak ditentukan.
COLOR_MODE_BLACK_AND_WHITE Hitam dan putih.
COLOR_MODE_COLORED Berwarna.

Mode Duplex

Mode Duplex Tugas Pencetakan.

Enumerasi
DUPLEX_MODE_UNSPECIFIED Tidak ditentukan.
DUPLEX_MODE_ONE_SIDED Satu sisi.
DUPLEX_MODE_TWO_SIDED_LONG_EDGE Balik dua sisi pada tepi panjang.
DUPLEX_MODE_TWO_SIDED_SHORT_EDGE Membalik dua sisi pada tepi pendek.

UkuranMedia

Ukuran media tugas pencetakan.

Representasi JSON
{
  "width": integer,
  "height": integer,
  "vendorId": string
}
Kolom
width

integer

Lebar (dalam mikrometer).

height

integer

Tinggi (dalam mikrometer).

vendorId

string

ID yang disediakan vendor—misalnya, iso_a3_297x420mm atau na_index-3x5_3x5in. Nilai yang mungkin adalah nilai atribut IPP media. Untuk mengetahui informasi selengkapnya, lihat Pendaftaran IPP.