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.

ملاحظة: العمليات "أو" غير متاحة في هذا الفلتر. ملاحظة: يمكن استخدام أدوات مقارنة >= و <= فقط في completeTime. ملاحظة: فقط = المقارِن متاح لـ userId وprinterId.

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

  • completeTime
  • printerId
  • userId
orderBy

string

الحقل المستخدَم لترتيب النتائج في حال عدم تحديد قيمة، سيتم ترتيب النتائج تنازليًا في الحقل completeTime.

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

  • العنوان
  • state
  • 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 قلب الوجه على حافة قصيرة.