Method: admin.chrome.v1.customers.chrome.printers.printJobs.list

إدراج مهام الطباعة.

طلب HTTP

GET https://admin.googleapis.com/admin/chrome/v1/{parent=customers/*/chrome/printers/*}/printJobs

يستخدم عنوان URL بنية تحويل ترميز gRPC.

معلمات المسار

المعلَمات
parent

string

مطلوبة. العنصر الرئيسي الذي يمتلك هذه المجموعة من مهام الطباعة. التنسيق: customer/{customer-id}/chrome/printers/{printer-id} يمكن أن يكون معرّف الطابعة - لإدراج مهام الطباعة على مستوى جميع الطابعات.

معامِلات طلب البحث

المعلَمات
pageSize

integer

عدد مهام الطباعة في الصفحة من 0 إلى 100، إذا لم يتم تحديد pageSize أو كان صفرًا، يكون الحجم 50.
pageToken

string

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

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

string

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

عمليات "أو" غير متاحة في هذا الفلتر. لا تتم إتاحة سوى مقارنات >= و== لـ completionTime. فقط = أداة المقارنة متوافقة مع userEmail وorgUnitId. لا تتوفر الفلترة حسب userEmail أو orgUnitId إلا عندما تكون قيمة {printer-id} هي "-". ويشير orgUnitId إلى الحقل orgUnitId للطابعة الرئيسية.

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

  • completionTime
  • orgUnitId
  • userEmail
orderBy

string

تم استخدام هذا الحقل لترتيب النتائج. وفي حال عدم تحديد هذه القيمة، يتم ترتيب النتائج حسب completionTime.

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

  • device
  • pageCount
  • creationTime
  • completionTime
  • status
  • printer
  • userEmail
  • title
  • color
  • duplex

نص الطلب

يجب أن يكون نص الطلب فارغًا.

نص الاستجابة

إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:

تتضمّن الاستجابة قائمة بمهام الطباعة.

تمثيل JSON 
{
  "printJobs": [
    {
      object (PrintJob)
    }
  ],
  "nextPageToken": string,
  "totalSize": integer
}
الحقول
printJobs[]

object (PrintJob)

قائمة مهام الطباعة المطلوبة.
nextPageToken

string

رمز مميز يمكن استخدامه في طلب لاحق لاسترداد الصفحة التالية. إذا تم حذف هذا الحقل، فلن تظهر أية صفحات لاحقة.
totalSize

integer

إجمالي عدد النتائج.

نطاقات الأذونات

يتطلب أحد نطاقات OAuth التالية:

  • https://www.googleapis.com/auth/admin.chrome.printers
  • https://www.googleapis.com/auth/admin.chrome.printers.readonly

لمزيد من المعلومات، راجع نظرة عامة على OAuth 2.0.

مهمة الطباعة

يمثل PrintJob طلبًا لطباعة مستند تم إرساله إلى طابعة.

تمثيل JSON 
{
  "name": string,
  "title": string,
  "state": enum (State),
  "creationTime": string,
  "completionTime": string,
  "pageCount": integer,
  "color": enum (ColorMode),
  "duplex": enum (DuplexMode),
  "mediaSize": {
    object (MediaSize)
  },
  "copyCount": integer,
  "printerId": string,
  "printer": string,
  "userId": string,
  "userEmail": string,
  "deviceId": string
}
الحقول
name

string

اسم مورد مهمة الطباعة. التنسيق: customers/{customer-id}/printers/{printer-id}/printJobs/{print-job-id}
title

string

عنوان المستند.
state

enum (State)

الحالة النهائية للوظيفة.
creationTime

string (Timestamp format)

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

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

string (Timestamp format)

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

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

integer

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

enum (ColorMode)

وضع الألوان.
duplex

enum (DuplexMode)

وضع "Duplex".
mediaSize

object (MediaSize)

حجم وسائط مهمة الطباعة.
copyCount

integer

عدد النُسخ.
printerId

string

رقم تعريف واجهة برمجة تطبيقات الطابعة.
printer

string

اسم الطابعة المستخدمة للطباعة.
userId

string

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

string

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

string

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

الحالة

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

عمليات التعداد
STATE_UNSPECIFIED مهمة الطباعة في حالة غير محدّدة.
STATE_PRINTED تمت طباعة المستند بنجاح.
STATE_CANCELED تم إلغاء مهمة الطباعة.
STATE_FAILED أخفقت مهمة الطباعة.

وضع الألوان

وضع لون مهمة الطباعة.

عمليات التعداد
COLOR_MODE_UNSPECIFIED غير محدد
COLOR_MODE_BLACK_AND_WHITE أبيض وأسود.
COLOR_MODE_COLORED ملونة.

وضع Duplex

وضع "Duplex على مهمة الطباعة".

عمليات التعداد
DUPLEX_MODE_UNSPECIFIED غير محدد
DUPLEX_MODE_ONE_SIDED جانب واحد.
DUPLEX_MODE_TWO_SIDED_LONG_EDGE قلبان على جانب طويل من حافة طويلة
DUPLEX_MODE_TWO_SIDED_SHORT_EDGE قلبان على حافة قصيرة.

حجم الوسائط

حجم وسائط مهمة الطباعة.

تمثيل JSON 
{
  "width": integer,
  "height": integer,
  "vendorId": string
}
الحقول
width

integer

العرض (بالميكرومتر)
height

integer

الارتفاع (بالميكرومتر)
vendorId

string

رقم تعريف مقدّم من المورّد، مثل iso_a3_297x420mm أو na_index-3x5_3x5in القيم المحتملة هي قيم سمة IPP media. لمزيد من المعلومات، راجع تسجيلات بروتوكول IPP.