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.