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

प्रिंट जॉब की सूची बनाएं.

एचटीटीपी अनुरोध

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

यह यूआरएल gRPC ट्रांसकोडिंग सिंटैक्स का इस्तेमाल करता है.

पाथ पैरामीटर

पैरामीटर
parent

string

ज़रूरी है. प्रिंट जॉब के इस संग्रह का मालिकाना हक अभिभावक की है. फ़ॉर्मैट: सभी प्रिंटर पर प्रिंट जॉब की सूची बनाने के लिए, customer/{customer-id}/chrome/printers/{printer-id} प्रिंटर आईडी - हो सकता है.

क्वेरी पैरामीटर

पैरामीटर
pageSize

integer

पेज पर 0 से लेकर 100 तक, सभी प्रिंट जॉब की संख्या शामिल है. अगर pageSize मौजूद नहीं है या शून्य है, तो साइज़ 50 है.

pageToken

string

पिछले printJobs.list कॉल से मिला पेज टोकन. अगला पेज पाने के लिए इसे दें. अगर इसे छोड़ा जाता है, तो नतीजों का पहला पेज दिखता है.

पेजों को क्रम में लगाने के दौरान, printJobs.list के लिए दिए गए अन्य सभी पैरामीटर, पेज टोकन देने वाले कॉल से मेल खाने चाहिए.

filter

string

नतीजों को फ़िल्टर करने के लिए क्वेरी स्ट्रिंग, EBNF सिंटैक्स में AND वाले फ़ील्ड.

OR कार्रवाई इस फ़िल्टर में समर्थित नहीं हैं. completionTime के लिए सिर्फ़ >= और <= तुलना करने वालों की सुविधा है. सिर्फ़ = userEmail और orgUnitId के लिए तुलना करने वाला काम करता है. userEmail या orgUnitId की मदद से फ़िल्टर करने की सुविधा सिर्फ़ {printer-id} के '-' में ही इस्तेमाल की जा सकती है. orgUnitId, पैरंट प्रिंटर के orgUnitId फ़ील्ड की जानकारी देता है.

काम करने वाले फ़िल्टर फ़ील्ड:

  • completionTime
  • orgUnitId
  • userEmail
orderBy

string

नतीजों का क्रम तय करने के लिए, फ़ील्ड का इस्तेमाल किया जाता है. अगर कोई जानकारी नहीं दी गई है, तो नतीजों को completionTime ने क्रम में लगाया है.

फ़ील्ड के हिसाब से क्रम:

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

अनुरोध का मुख्य भाग

अनुरोध का मुख्य हिस्सा खाली होना चाहिए.

जवाब का मुख्य भाग

अगर एपीआई सही से जुड़ जाता है, ताे जवाब के मुख्य भाग में नीचे दिए गए स्ट्रक्चर शामिल होता है.

जवाब में प्रिंट जॉब की सूची शामिल है.

जेएसओएन के काेड में दिखाना
{
  "printJobs": [
    {
      object (PrintJob)
    }
  ],
  "nextPageToken": string,
  "totalSize": integer
}
फ़ील्ड
printJobs[]

object (PrintJob)

अनुरोध किए गए प्रिंट जॉब की सूची.

nextPageToken

string

एक टोकन, जिसका इस्तेमाल अगले पेज को फिर से पाने के अनुरोध में किया जा सकता है. अगर इस फ़ील्ड को खाली छोड़ा जाता है, तो कोई पेज नहीं दिखेगा.

totalSize

integer

परिणामों की कुल संख्या.

अनुमति पाने के लिंक

इनमें से किसी एक OAuth दायरे की ज़रूरत होती है:

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

ज़्यादा जानकारी के लिए, OAuth 2.0 की खास जानकारी देखें.

प्रिंट जॉब

PrintJob से, किसी प्रिंटर पर सबमिट किए गए दस्तावेज़ को प्रिंट करने के अनुरोध की जानकारी मिलती है.

जेएसओएन के काेड में दिखाना
{
  "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
}
फ़ील्ड
name

string

प्रिंट जॉब के संसाधन का नाम. फ़ॉर्मैट: customers/{customer-id}/printers/{printer-id}/printJobs/{print-job-id}

title

string

दस्तावेज़ का शीर्षक.

state

enum (State)

काम की आखिरी स्थिति.

creationTime

string (Timestamp format)

प्रिंट जॉब बनाने का टाइमस्टैंप.

RFC3339 यूटीसी के "ज़ूलू" फ़ॉर्मैट में एक टाइमस्टैंप, जिसमें नैनोसेकंड रिज़ॉल्यूशन और ज़्यादा से ज़्यादा नौ भिन्न संख्याएं हैं. उदाहरण: "2014-10-02T15:01:23Z" और "2014-10-02T15:01:23.045123456Z".

completionTime

string (Timestamp format)

प्रिंट जॉब पूरा होने का टाइमस्टैंप.

RFC3339 यूटीसी के "ज़ूलू" फ़ॉर्मैट में एक टाइमस्टैंप, जिसमें नैनोसेकंड रिज़ॉल्यूशन और ज़्यादा से ज़्यादा नौ भिन्न संख्याएं हैं. उदाहरण: "2014-10-02T15:01:23Z" और "2014-10-02T15:01:23.045123456Z".

pageCount

integer

दस्तावेज़ में पेजों की संख्या.

color

enum (ColorMode)

कलर मोड.

duplex

enum (DuplexMode)

डूप्लेक्स मोड.

mediaSize

object (MediaSize)

प्रिंट मीडिया का साइज़.

copyCount

integer

कॉपी की संख्या.

printerId

string

प्रिंटर एपीआई आईडी.

printer

string

प्रिंट करने के लिए इस्तेमाल किए जाने वाले प्रिंटर का नाम.

userId

string

जिस उपयोगकर्ता ने प्रिंट जॉब सबमिट किया है उसका यूनीक डायरेक्ट्री एपीआई आईडी.

userEmail

string

प्रिंट जॉब सबमिट करने वाले उपयोगकर्ता का मुख्य ईमेल पता.

deviceId

string

डिवाइस का यूनीक डायरेक्ट्री एपीआई आईडी, जिसका इस्तेमाल प्रिंट जॉब को सबमिट करने के लिए किया गया था.

स्थिति

प्रिंट जॉब की स्थिति.

Enums
STATE_UNSPECIFIED प्रिंट जॉब तय नहीं किया गया है.
STATE_PRINTED दस्तावेज़ प्रिंट कर लिया गया है.
STATE_CANCELED प्रिंट जॉब रद्द कर दिया गया.
STATE_FAILED प्रिंट जॉब विफल.

कलरमोड

प्रिंट जॉब का रंग मोड.

Enums
COLOR_MODE_UNSPECIFIED नहीं बताया गया है
COLOR_MODE_BLACK_AND_WHITE ब्लैक ऐंड व्हाइट.
COLOR_MODE_COLORED रंगीन.

डूप्लेक्समोड

प्रिंट जॉब डूप्लेक्स मोड.

Enums
DUPLEX_MODE_UNSPECIFIED नहीं बताया गया है
DUPLEX_MODE_ONE_SIDED एक-तरफ़ा.
DUPLEX_MODE_TWO_SIDED_LONG_EDGE लंबे किनारे को पलटते हुए दो-तरफ़ा.
DUPLEX_MODE_TWO_SIDED_SHORT_EDGE छोटे किनारे के ऊपर दो-तरफ़ा फ़्लिप हो रहा है.

मीडिया का साइज़

प्रिंट मीडिया का साइज़.

जेएसओएन के काेड में दिखाना
{
  "width": integer,
  "height": integer,
  "vendorId": string
}
फ़ील्ड
width

integer

चौड़ाई (माइक्रोमीटर में).

height

integer

ऊंचाई (माइक्रोमीटर में).

vendorId

string

वेंडर का दिया गया आईडी—उदाहरण के लिए, iso_a3_297x420mm या na_index-3x5_3x5in. संभावित वैल्यू media आईपीपी एट्रिब्यूट की वैल्यू हैं. ज़्यादा जानकारी के लिए, आईपीपी रजिस्ट्रेशन देखें.