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

إدراج إعدادات الطابعات

طلب HTTP

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

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

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

المعلمات
parent

string

مطلوب. اسم العميل الذي يملك مجموعة الطابعات هذه. التنسيق: customer/{customer_id}

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

المعلمات
pageSize

integer

الحد الأقصى لعدد العناصر التي سيتم عرضها قد تعرض الخدمة عددًا أقل من هذه القيمة.
pageToken

string

رمز مميّز للصفحة، تمّ تلقّيه من طلب سابق
orgUnitId

string

الوحدة التنظيمية التي نريد إدراج الطابعات لها. عندما لا يكون org_unit متوفّرًا في الطلب، يتم عرض جميع الطابعات للعميل (أو فلترتها).

عندما يكون org_unit متوفّرًا في الطلب، سيتم عرض الطابعات المتاحة لهذه الوحدة التنظيمية فقط (المملوكة أو المُكتسَبة). يمكنك معرفة ما إذا كانت الطابعة مملوكة أو مكتسَبة لهذه الوحدة التنظيمية من خلال الاطّلاع على Printer.org_unit_id.
filter

string

طلب البحث تتم مشاركة بنية البحث بين واجهة برمجة التطبيقات هذه وصفحات الطابعات في "وحدة تحكّم المشرف".
orderBy

string

الترتيب الذي يتم به ترتيب النتائج. يجب أن تكون إحدى القيم التالية: displayName أو description أو makeAndModel أو createTime. الترتيب التلقائي تصاعدي، ولكن يمكن عرض الترتيب التنازلي من خلال إلحاق "desc" بالحقل orderBy. على سبيل المثال، سيعرض الإعداد "وصف الوصف" الطابعات مرتبة حسب الوصف تنازليًا.

نص الطلب

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

نص الاستجابة

استجابة لسرد الطابعات.

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

تمثيل JSON 
{
  "printers": [
    {
      object (Printer)
    }
  ],
  "nextPageToken": string
}
الحقول
printers[]

object (Printer)

قائمة الطابعات إذا تم تقديم orgUnitId في الطلب، لن يتم عرض سوى الطابعات المرئية لهذه الوحدة التنظيمية. إذا لم يتم تقديم orgUnitId في الطلب، سيتم إرجاع جميع الطابعات.
nextPageToken

string

رمز مميّز يمكن إرساله على شكل pageToken لاسترداد الصفحة التالية. في حال حذف هذا الحقل، لن تكون هناك صفحات لاحقة.

نطاقات التفويض

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

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

لمزيد من المعلومات، يمكنك الاطّلاع على دليل التفويض.