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

سلسلة طلب البحث لفلترة النتائج، وهي حقول مفصولة بعلامة AND في بنية EBNF.

ملاحظة: لا تتوفّر عمليات OR في هذا الفلتر. ملاحظة: لا تتوفّر إلا أداتا المقارنة >= و<= لـ completeTime. ملاحظة: لا تتوفّر إلا أداة المقارنة = لـ userId وprinterId.

حقول الفلتر المتوفّرة:

  • completeTime
  • printerId
  • userId
orderBy

string

الحقل المستخدَم لترتيب النتائج. إذا لم يتم تحديد هذا الحقل، سيتم ترتيب النتائج بترتيب تنازلي حسب حقل completeTime.

حقول الترتيب حسب المتوفّرة:

  • title
  • state
  • createTime
  • completeTime
  • documentPageCount
  • colorMode
  • duplexMode
  • printer
  • 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

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

الولاية

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

عمليات التعداد
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 الطباعة على الوجهَين مع قلب الورقة من الحافة القصيرة