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_id}

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

المعلمات
pageSize

integer

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

pageToken

string

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

orgUnitId

string

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

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

filter

string

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

orderBy

string

الترتيب الذي يتم به ترتيب النتائج. يجب أن يكون أحد القيم التالية: displayName أو description أو makeAndModel أو createTime. يكون الترتيب التلقائي تصاعديًا، ولكن يمكن عرض الترتيب التنازلي من خلال إلحاق "تنازلي". إلى الحقل 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

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