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

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

string

لترتيب النتائج حسبها. يجب أن يكون أحد الأسماء التالية: displayName أو الوصف أو 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

لمزيد من المعلومات، راجِع دليل التفويض.