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)

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

يجب أن يكون طابعًا زمنيًا بالتنسيق RFC3339 UTC "Zulu"‎ وبدقة تصل إلى نانوثانية وما يصل إلى تسعة أرقام كسور. أمثلة: "2014-10-02T15:01:23Z" و"2014-10-02T15:01:23.045123456Z"
completeTime

string (Timestamp format)

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

يجب أن يكون طابعًا زمنيًا بالتنسيق RFC3339 UTC "Zulu"‎ وبدقة تصل إلى نانوثانية وما يصل إلى تسعة أرقام كسور. أمثلة: "2014-10-02T15:01:23Z" و"2014-10-02T15:01:23.045123456Z".
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 طباعة على الوجهين مع قلب الحافة القصيرة