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

مطلوب. اسم العميل الذي يملك مجموعة الطابعات هذه. التنسيق: customers/{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. على سبيل المثال، سيؤدي الطلب "description desc" إلى عرض الطابعات مرتبة تنازليًا حسب الوصف.

نص الطلب

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

نص الاستجابة

ردّ بشأن إدراج الطابعات

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

تمثيل 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

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