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
  • الولاية
  • 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) "زولو" بدقة نانوثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: "2014-10-02T15:01:23Z" و"2014-10-02T15:01:23.045123456Z".
completeTime

string (Timestamp format)

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

طابع زمني بتنسيق RFC3339 حسب التوقيت العالمي المنسَّق (UTC) "زولو" بدقة نانوثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: "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

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

الحالة

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

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