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
لمزيد من المعلومات، يمكنك الاطّلاع على دليل التفويض.
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-07-24 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-07-24 (حسب التوقيت العالمي المتفَّق عليه)"],[],[],null,["# Method: admin.directory.v1.customers.chrome.printers.list\n\nList printers configs.\n\n### HTTP request\n\n`GET https://admin.googleapis.com/admin/directory/v1/{parent=customers/*}/chrome/printers`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|----------|-------------------------------------------------------------------------------------------------------------------|\n| `parent` | `string` Required. The name of the customer who owns this collection of printers. Format: customers/{customer_id} |\n\n### Query parameters\n\n| Parameters ||\n|-------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `pageSize` | `integer` The maximum number of objects to return. The service may return fewer than this value. |\n| `pageToken` | `string` A page token, received from a previous call. |\n| `orgUnitId` | `string` Organization Unit that we want to list the printers for. When org_unit is not present in the request then all printers of the customer are returned (or filtered). When org_unit is present in the request then only printers available to this OU will be returned (owned or inherited). You may see if printer is owned or inherited for this OU by looking at Printer.org_unit_id. |\n| `filter` | `string` Search query. Search syntax is shared between this api and Admin Console printers pages. |\n| `orderBy` | `string` The order to sort results by. Must be one of displayName, description, makeAndModel, or createTime. Default order is ascending, but descending order can be returned by appending \"desc\" to the orderBy field. For instance, \"description desc\" will return the printers sorted by description in descending order. |\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nResponse for listing printers.\n\nIf successful, the response body contains data with the following structure:\n\n| JSON representation |\n|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"printers\": [ { object (/workspace/admin/chrome-printer/reference/rest/v1/admin.directory.v1.customers.chrome.printers#Printer) } ], \"nextPageToken\": string } ``` |\n\n| Fields ||\n|-----------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `printers[]` | `object (`[Printer](/workspace/admin/chrome-printer/reference/rest/v1/admin.directory.v1.customers.chrome.printers#Printer)`)` List of printers. If `orgUnitId` was given in the request, then only printers visible for this OU will be returned. If `orgUnitId` was not given in the request, then all printers will be returned. |\n| `nextPageToken` | `string` A token, which can be sent as `pageToken` to retrieve the next page. If this field is omitted, there are no subsequent pages. |\n\n### Authorization scopes\n\nRequires one of the following OAuth scopes:\n\n- `https://www.googleapis.com/auth/admin.chrome.printers`\n- `\n https://www.googleapis.com/auth/admin.chrome.printers.readonly`\n\nFor more information, see the [Authorization guide](/workspace/guides/configure-oauth-consent)."]]
