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.