Method: customers.reports.enumeratePrintJobs

ดูรายการงานพิมพ์

คำขอ HTTP

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

URL ใช้ไวยากรณ์การแปลง gRPC

พารามิเตอร์เส้นทาง

พารามิเตอร์
customer

string

ต้องระบุ รหัสลูกค้าที่ขึ้นต้นด้วย "customers/" หรือ "customers/my_customer" ให้ใช้ลูกค้าที่เชื่อมโยงกับบัญชีที่ส่งคำขอ

พารามิเตอร์การค้นหา

พารามิเตอร์
printerOrgUnitId

string

รหัสหน่วยขององค์กรสำหรับเครื่องพิมพ์ หากระบุไว้ ระบบจะส่งคืนเฉพาะงานพิมพ์ที่ส่งไปยังเครื่องพิมพ์จากหน่วยขององค์กรที่ระบุ
pageSize

integer

จำนวนงานพิมพ์ในหน้าเว็บตั้งแต่ 0 ถึง 100 ถ้าไม่ได้ระบุ pageSize หรือ 0 ขนาดจะเป็น 50
pageToken

string

โทเค็นหน้าเว็บที่ได้รับจากการโทร reports.enumeratePrintJobs ครั้งก่อน โปรดระบุข้อมูลนี้เพื่อเรียกข้อมูลหน้าถัดไป หากไม่ระบุ ระบบจะแสดงผลผลการค้นหาหน้าแรก

เมื่อใส่เลขหน้า พารามิเตอร์อื่นๆ ทั้งหมดที่ให้กับ reports.enumeratePrintJobs ต้องตรงกับการเรียกใช้ที่ระบุโทเค็นของหน้าเว็บ
filter

string

สตริงการค้นหาเพื่อกรองผลลัพธ์ ฟิลด์ที่คั่นด้วย AND ในไวยากรณ์ EBNF

หมายเหตุ: ตัวกรองนี้ไม่รองรับการดำเนินการ "OR" หมายเหตุ: รองรับเฉพาะตัวเปรียบเทียบ >= และ <= สำหรับ completeTime หมายเหตุ: เฉพาะ = รองรับตัวเปรียบเทียบสำหรับ userId และ printerId เท่านั้น

ช่องตัวกรองที่รองรับ:

  • completeTime
  • printerId
  • userId
orderBy

string

ฟิลด์ที่ใช้เรียงลำดับผลลัพธ์ หากไม่ได้ระบุ ผลลัพธ์จะเรียงลำดับตามช่อง completeTime จากมากไปน้อย

ลำดับที่รองรับตามฟิลด์:

  • title
  • รัฐ
  • createTime
  • completeTime
  • documentPageCount
  • colorMode
  • duplexMode
  • เครื่องพิมพ์
  • userEmail

เนื้อหาของคำขอ

เนื้อหาของคำขอต้องว่างเปล่า

เนื้อหาการตอบกลับ

คำตอบที่มีรายการงานพิมพ์

หากทำสำเร็จ เนื้อหาการตอบกลับจะมีข้อมูลซึ่งมีโครงสร้างดังต่อไปนี้

การแสดง JSON 
{
  "printJobs": [
    {
      object (PrintJob)
    }
  ],
  "nextPageToken": string,
  "totalSize": string
}
ช่อง
printJobs[]

object (PrintJob)

รายการงานพิมพ์ที่ขอ
nextPageToken

string

โทเค็น ซึ่งสามารถใช้ในคำขอที่ตามมาเพื่อเรียกข้อมูลหน้าถัดไป หากเว้นช่องนี้ไว้ จะไม่มีหน้าลำดับต่อมา
totalSize

string (int64 format)

จำนวนงานพิมพ์ทั้งหมดที่ตรงกับคำขอ

ขอบเขตการให้สิทธิ์

ต้องใช้ขอบเขต OAuth ต่อไปนี้

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

PrintJob

หมายถึงคำขอพิมพ์เอกสารที่ส่งไปยังเครื่องพิมพ์

การแสดง 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
}
ช่อง
id

string

รหัสที่ไม่ซ้ำกันของงานพิมพ์
title

string

ชื่อเอกสาร
state

enum (State)

สถานะสุดท้ายของงาน
createTime

string (Timestamp format)

การประทับเวลาการสร้างงานพิมพ์

การประทับเวลาเป็น RFC3339 UTC "Zulu" โดยมีความละเอียดระดับนาโนวินาทีและมีเลขเศษส่วนสูงสุด 9 หลัก ตัวอย่าง: "2014-10-02T15:01:23Z" และ "2014-10-02T15:01:23.045123456Z"
completeTime

string (Timestamp format)

การประทับเวลาเสร็จสิ้นงานพิมพ์

การประทับเวลาเป็น RFC3339 UTC "Zulu" โดยมีความละเอียดระดับนาโนวินาทีและมีเลขเศษส่วนสูงสุด 9 หลัก ตัวอย่าง: "2014-10-02T15:01:23Z" และ "2014-10-02T15:01:23.045123456Z"
documentPageCount

integer

จำนวนหน้าในเอกสาร
colorMode

enum (ColorMode)

โหมดสี
duplexMode

enum (DuplexMode)

โหมดดูเพล็กซ์
copyCount

integer

จำนวนสำเนา
printerId

string

รหัส API ของเครื่องพิมพ์ที่ใช้สำหรับการพิมพ์
printer

string

ชื่อเครื่องพิมพ์ที่ใช้ในการพิมพ์
userEmail

string

อีเมลหลักของผู้ใช้ที่ส่งงานพิมพ์
userId

string

รหัส API ไดเรกทอรีที่ไม่ซ้ำกันของผู้ใช้ที่ส่งงานพิมพ์

รัฐ

สถานะของงานพิมพ์

Enum
STATE_UNSPECIFIED งานพิมพ์อยู่ในสถานะที่ไม่ระบุ
PRINTED พิมพ์เอกสารสำเร็จแล้ว
CANCELLED ยกเลิกงานพิมพ์แล้ว
FAILED งานพิมพ์ล้มเหลว

ColorMode

โหมดสีของงานพิมพ์

Enum
COLOR_MODE_UNSPECIFIED ไม่ระบุ
BLACK_AND_WHITE ขาวดำ
COLOR สี

DuplexMode

โหมดพิมพ์ 2 ด้าน

Enum
DUPLEX_MODE_UNSPECIFIED ไม่ระบุ
ONE_SIDED ด้านเดียว
TWO_SIDED_LONG_EDGE พลิกกลับด้าน 2 ด้านตามขอบด้านยาว
TWO_SIDED_SHORT_EDGE พลิกกลับด้าน 2 ด้านตามขอบด้านสั้น