Method: partners.devices.findByOwner
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
يعثر على الأجهزة التي تمت المطالبة بها للعملاء. لا تتضمّن النتائج سوى الأجهزة المسجَّلة للمورّد والتي تم تحديدها من خلال الوسيطة partnerId. لا تظهر أجهزة العميل التي تم شراؤها من مورّدين آخرين في النتائج.
طلب HTTP
POST https://androiddeviceprovisioning.googleapis.com/v1/partners/{partnerId}/devices:findByOwner
يستخدِم عنوان URL بنية تحويل ترميز gRPC.
مَعلمات المسار
| المعلمات |
partnerId |
string (int64 format)
مطلوب. رقم تعريف شريك المورِّد.
|
نص الطلب
يحتوي نص الطلب على بيانات بالبنية التالية:
| تمثيل JSON |
{
"pageToken": string,
"limit": string,
"sectionType": enum (DeviceProvisioningSectionType),
"customerId": [
string
],
"googleWorkspaceCustomerId": [
string
]
} |
| الحقول |
pageToken |
string
رمز مميز يحدد صفحة النتائج التي سيتم عرضها.
|
limit |
string (int64 format)
مطلوب. الحد الأقصى لعدد الأجهزة المطلوب عرضها في صفحة من النتائج. يجب أن تتراوح القيمة بين 1 و100.
|
sectionType |
enum (DeviceProvisioningSectionType)
مطلوب. نوع القسم لسجلّ توفير المتطلبات اللازمة للجهاز
|
customerId[] |
string (int64 format)
قائمة الأرقام التعريفية للعملاء المطلوب البحث عنها.
|
googleWorkspaceCustomerId[] |
string
قائمة أرقام تعريف حسابات Google Workspace المطلوب البحث عنها
|
نص الاستجابة
إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:
ردّ يتضمّن الأجهزة التي تم العثور عليها
| تمثيل JSON |
{
"devices": [
{
object (Device)
}
],
"nextPageToken": string,
"totalSize": integer
} |
| الحقول |
devices[] |
object (Device)
أجهزة العميل
|
nextPageToken |
string
يشير ذلك المصطلح إلى رمز مميّز يُستخدَم للوصول إلى الصفحة التالية من النتائج. يتم حذفها في حال عدم توفُّر نتائج إضافية.
|
totalSize |
integer
إجمالي عدد العناصر في القائمة بغض النظر عن التقسيم على صفحات.
|
نطاقات التفويض
يجب توفير نطاق OAuth التالي:
https://www.googleapis.com/auth/androidworkprovisioning
لمزيد من المعلومات، يُرجى الاطِّلاع على نظرة عامة على OAuth 2.0.
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-07-25 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-07-25 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eThis API endpoint finds devices claimed by customers, specifically those registered to the reseller identified by the \u003ccode\u003epartnerId\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eThe HTTP request is a \u003ccode\u003ePOST\u003c/code\u003e method to \u003ccode\u003ehttps://androiddeviceprovisioning.googleapis.com/v1/partners/{partnerId}/devices:findByOwner\u003c/code\u003e, utilizing gRPC Transcoding syntax.\u003c/p\u003e\n"],["\u003cp\u003eThe request body requires parameters such as \u003ccode\u003elimit\u003c/code\u003e, and \u003ccode\u003esectionType\u003c/code\u003e, and includes optional fields for filtering by \u003ccode\u003ecustomerId\u003c/code\u003e and \u003ccode\u003egoogleWorkspaceCustomerId\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eThe response body returns a list of \u003ccode\u003edevices\u003c/code\u003e, and information about pagination through \u003ccode\u003enextPageToken\u003c/code\u003e, along with the \u003ccode\u003etotalSize\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eAuthorization for this API requires the \u003ccode\u003ehttps://www.googleapis.com/auth/androidworkprovisioning\u003c/code\u003e OAuth scope.\u003c/p\u003e\n"]]],["This describes an API endpoint to find devices claimed by customers, specifically those registered to a given reseller. The API uses a `POST` request to `https://androiddeviceprovisioning.googleapis.com/v1/partners/{partnerId}/devices:findByOwner`, with `partnerId` specifying the reseller. The request body requires a page limit, section type, and optional customer IDs and/or google workspace id to search by. The response contains a list of devices, a next page token if more results are available, and total size. OAuth scope `https://www.googleapis.com/auth/androidworkprovisioning` is needed.\n"],null,["# Method: partners.devices.findByOwner\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Request body](#body.request_body)\n - [JSON representation](#body.request_body.SCHEMA_REPRESENTATION)\n- [Response body](#body.response_body)\n - [JSON representation](#body.FindDevicesByOwnerResponse.SCHEMA_REPRESENTATION)\n- [Authorization Scopes](#body.aspect)\n\nFinds devices claimed for customers. The results only contain devices registered to the reseller that's identified by the `partnerId` argument. The customer's devices purchased from other resellers don't appear in the results.\n\n### HTTP request\n\n`POST https://androiddeviceprovisioning.googleapis.com/v1/partners/{partnerId}/devices:findByOwner`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|-------------|-------------------------------------------------------------------------------------------------------------------------------|\n| `partnerId` | `string (`[int64](https://developers.google.com/discovery/v1/type-format)` format)` Required. The ID of the reseller partner. |\n\n### Request body\n\nThe request body contains data with the following structure:\n\n| JSON representation |\n|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"pageToken\": string, \"limit\": string, \"sectionType\": enum (/zero-touch/reference/reseller/rest/v1/partners.devices#DeviceProvisioningSectionType), \"customerId\": [ string ], \"googleWorkspaceCustomerId\": [ string ] } ``` |\n\n| Fields ||\n|-------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `pageToken` | `string` A token specifying which result page to return. |\n| `limit` | `string (`[int64](https://developers.google.com/discovery/v1/type-format)` format)` Required. The maximum number of devices to show in a page of results. Must be between 1 and 100 inclusive. |\n| `sectionType` | `enum (`[DeviceProvisioningSectionType](/zero-touch/reference/reseller/rest/v1/partners.devices#DeviceProvisioningSectionType)`)` Required. The section type of the device's provisioning record. |\n| `customerId[]` | `string (`[int64](https://developers.google.com/discovery/v1/type-format)` format)` The list of customer IDs to search for. |\n| `googleWorkspaceCustomerId[]` | `string` The list of IDs of Google Workspace accounts to search for. |\n\n### Response body\n\nIf successful, the response body contains data with the following structure:\nResponse containing found devices.\n\n| JSON representation |\n|-------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"devices\": [ { object (/zero-touch/reference/reseller/rest/v1/partners.devices#Device) } ], \"nextPageToken\": string, \"totalSize\": integer } ``` |\n\n| Fields ||\n|-----------------|---------------------------------------------------------------------------------------------------------------|\n| `devices[]` | `object (`[Device](/zero-touch/reference/reseller/rest/v1/partners.devices#Device)`)` The customer's devices. |\n| `nextPageToken` | `string` A token used to access the next page of results. Omitted if no further results are available. |\n| `totalSize` | `integer` The total count of items in the list irrespective of pagination. |\n\n### Authorization Scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/androidworkprovisioning`\n\nFor more information, see the [OAuth 2.0 Overview](https://developers.google.com/identity/protocols/OAuth2)."]]
