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 أو كان صفرًا، سيكون الحجم 50.
pageToken

string

رمز مميّز للصفحة تم استلامه من مكالمة reports.enumeratePrintJobs سابقة قدِّم هذا المرجع لاسترداد الصفحة اللاحقة. وفي حال حذفه، سيتم عرض الصفحة الأولى من النتائج.

عند تقسيم الصفحات، يجب أن تتطابق جميع المَعلمات الأخرى المقدَّمة إلى reports.enumeratePrintJobs مع الطلب الذي قدّم الرمز المميّز للصفحة.
filter

string

سلسلة طلب بحث لفلترة النتائج، الحقول مفصولة بـ "و" في بنية 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)

الطابع الزمني لإنشاء مهمة الطباعة

يستخدم معيار RFC 3339، حيث يكون الناتج الذي يتم إنشاؤه دائمًا مُعدَّلاً وفقًا لقاعدة Z ويستخدم 0 أو 3 أو 6 أو 9 أرقام عشرية. يتم أيضًا قبول العناصر غير "Z". أمثلة: "2014-10-02T15:01:23Z" أو "2014-10-02T15:01:23.045123456Z" أو "2014-10-02T15:01:23+05:30"
completeTime

string (Timestamp format)

الطابع الزمني لإكمال مهمة الطباعة

يستخدم معيار RFC 3339، حيث يكون الناتج الذي يتم إنشاؤه دائمًا مُعدَّلاً وفقًا لقاعدة Z ويستخدم 0 أو 3 أو 6 أو 9 أرقام عشرية. يتم أيضًا قبول العناصر غير "Z". أمثلة: "2014-10-02T15:01:23Z" أو "2014-10-02T15:01:23.045123456Z" أو "2014-10-02T15:01:23+05:30"
documentPageCount

integer

عدد الصفحات في المستند
colorMode

enum (ColorMode)

وضع الألوان
duplexMode

enum (DuplexMode)

وضع "النسخ المتعدّد"
copyCount

integer

عدد النُسخ
printerId

string

رقم تعريف واجهة برمجة التطبيقات للطابعة المستخدَمة للطباعة
printer

string

اسم الطابعة المستخدَمة للطباعة
userEmail

string

عنوان البريد الإلكتروني الأساسي للمستخدم الذي أرسل مهمة الطباعة.
userId

string

المعرّف الفريد لواجهة برمجة التطبيقات Directory API الخاص بالمستخدم الذي أرسل مهمة الطباعة.

الحالة

حالة مهمة الطباعة

عمليات التعداد
STATE_UNSPECIFIED مهمة الطباعة في حالة غير محدّدة.
PRINTED تم طباعة المستند بنجاح.
CANCELLED تم إلغاء مهمة الطباعة.
FAILED تعذّرت مهمة الطباعة.

ColorMode

وضع الألوان في مهمة الطباعة

عمليات التعداد
COLOR_MODE_UNSPECIFIED غير محدد
BLACK_AND_WHITE بالأبيض والأسود
COLOR اللون

DuplexMode

وضع الطباعة المزدوجة لمهمة الطباعة

عمليات التعداد
DUPLEX_MODE_UNSPECIFIED غير محدد
ONE_SIDED وجه واحد
TWO_SIDED_LONG_EDGE طباعة على الوجهين مع قلب الحافة الطويلة
TWO_SIDED_SHORT_EDGE طباعة على الوجهين مع قلب الحافة القصيرة