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

يسرد عمليات ضبط خادم الطباعة.

طلب HTTP

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

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

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

المعلمات
parent

string

مطلوب. المعرّف الفريد لحساب العميل على Google Workspace.

تنسيق الملف: customers/{id}

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

المعلمات
pageSize

integer

الحد الأقصى لعدد العناصر المطلوب عرضها (القيمة التلقائية 100، الحد الأقصى 100). قد تعرض الخدمة أقل من هذه القيمة.

pageToken

string

رمز مميّز تم إنشاؤه لتقسيم النتائج على صفحات (nextPageToken من استدعاء سابق).

orgUnitId

string

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

إذا لم يتم تحديد orgUnitId في الطلب، يتم عرض جميع خوادم الطباعة أو الفلترة حسبها.

filter

string

طلب البحث في بنية لغة التعبير الشائعة. الفلاتر المتوافقة هي displayName وdescription وuri.

مثال: printServer.displayName=='marketing-queue'

orderBy

string

ترتيب النتائج والقيم المسموح بإدراجها هي displayName أو description أو createTime.

الترتيب التلقائي تصاعدي، لكن يمكن عرض الترتيب التنازلي من خلال إلحاق "تنازلي" إلى الحقل orderBy. على سبيل المثال، تعرض orderBy=='description desc' خوادم الطباعة المرتّبة حسب الوصف تنازليًا.

نص الطلب

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

نص الاستجابة

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

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

object (PrintServer)

قائمة بخوادم الطباعة:

nextPageToken

string

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

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

يتطلب هذا الإعداد أحد نطاقات OAuth التالية:

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

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