Method: enterprises.devices.list
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
يسرد الأجهزة لشركة معيّنة. لا يتم عرض الأجهزة المحذوفة في الاستجابة.
طلب HTTP
GET https://androidmanagement.googleapis.com/v1/{parent=enterprises/*}/devices
يستخدِم عنوان URL بنية تحويل ترميز gRPC.
مَعلمات المسار
| المعلمات |
parent |
string
اسم المؤسسة بالتنسيق enterprises/{enterpriseId}.
|
مَعلمات طلب البحث
| المعلمات |
pageSize |
integer
حجم الصفحة المطلوب قد يكون حجم الصفحة الفعلي ثابتًا على قيمة دنيا أو قصوى.
|
pageToken |
string
رمز مميّز يحدِّد صفحة من النتائج التي يعرضها الخادم
|
نص الطلب
يجب أن يكون نص الطلب فارغًا.
نص الاستجابة
ردّ على طلب بعرض الأجهزة لمؤسسة معيّنة
إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:
| تمثيل JSON |
{
"devices": [
{
object (Device)
}
],
"nextPageToken": string
} |
| الحقول |
devices[] |
object (Device)
قائمة الأجهزة
|
nextPageToken |
string
إذا كانت هناك نتائج أخرى، رمز مميّز لاسترداد الصفحة التالية من النتائج
|
نطاقات التفويض
يجب توفير نطاق OAuth التالي:
https://www.googleapis.com/auth/androidmanagement
لمزيد من المعلومات، يُرجى الاطّلاع على OAuth 2.0 Overview.
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-07-26 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-07-26 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eLists all devices for a given enterprise, excluding deleted ones.\u003c/p\u003e\n"],["\u003cp\u003eRequires \u003ccode\u003eGET\u003c/code\u003e request to the specified URL with \u003ccode\u003eenterpriseId\u003c/code\u003e as a path parameter.\u003c/p\u003e\n"],["\u003cp\u003eSupports pagination using \u003ccode\u003epageSize\u003c/code\u003e and \u003ccode\u003epageToken\u003c/code\u003e for retrieving results.\u003c/p\u003e\n"],["\u003cp\u003eResponse includes a list of devices and a token for the next page if available.\u003c/p\u003e\n"],["\u003cp\u003eNeeds \u003ccode\u003ehttps://www.googleapis.com/auth/androidmanagement\u003c/code\u003e OAuth scope for authorization.\u003c/p\u003e\n"]]],["This document details how to list devices for an enterprise using a `GET` request to the specified URL. The request uses path parameter `parent` (enterprise name) and optional query parameters `pageSize` and `pageToken` for pagination. The request body should be empty. The successful response body contains a list of `devices` and a `nextPageToken` for retrieving subsequent pages. This process requires `https://www.googleapis.com/auth/androidmanagement` authorization scope.\n"],null,["# Method: enterprises.devices.list\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Query parameters](#body.QUERY_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n - [JSON representation](#body.ListDevicesResponse.SCHEMA_REPRESENTATION)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nLists devices for a given enterprise. Deleted devices are not returned in the response.\n\n### HTTP request\n\n`GET https://androidmanagement.googleapis.com/v1/{parent=enterprises/*}/devices`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|----------|-------------------------------------------------------------------------------|\n| `parent` | `string` The name of the enterprise in the form `enterprises/{enterpriseId}`. |\n\n### Query parameters\n\n| Parameters ||\n|-------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `pageSize` | `integer` The requested page size. If unspecified, at most 10 devices will be returned. The maximum value is 100; values above 100 will be coerced to 100. The limits can change over time. |\n| `pageToken` | `string` A token identifying a page of results returned by the server. |\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nResponse to a request to list devices for a given enterprise.\n\nIf successful, the response body contains data with the following structure:\n\n| JSON representation |\n|-----------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"devices\": [ { object (/android/management/reference/rest/v1/enterprises.devices#Device) } ], \"nextPageToken\": string } ``` |\n\n| Fields ||\n|-----------------|--------------------------------------------------------------------------------------------------------------|\n| `devices[]` | `object (`[Device](/android/management/reference/rest/v1/enterprises.devices#Device)`)` The list of devices. |\n| `nextPageToken` | `string` If there are more results, a token to retrieve next page of results. |\n\n### Authorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/androidmanagement`\n\nFor more information, see the [OAuth 2.0 Overview](/identity/protocols/OAuth2)."]]
