Method: partners.devices.findByIdentifier

للبحث عن الأجهزة حسب معرّفات الأجهزة، مثل IMEI.

طلب HTTP

POST https://androiddeviceprovisioning.googleapis.com/v1/partners/{partnerId}/devices:findByIdentifier

يستخدم عنوان URL بنية تحويل ترميز gRPC.

معلمات المسار

المعلَمات
partnerId

string (int64 format)

مطلوبة. رقم تعريف الشريك المورّد

نص الطلب

يحتوي نص الطلب على بيانات بالبنية التالية:

تمثيل JSON 
{
  "pageToken": string,
  "limit": string,
  "deviceIdentifier": {
    object (DeviceIdentifier)
  }
}
الحقول
pageToken

string

رمز مميز يحدد صفحة النتائج المراد عرضها.
limit

string (int64 format)

مطلوبة. الحد الأقصى لعدد الأجهزة التي يتم عرضها في صفحة النتائج. يجب أن تتراوح القيمة بين 1 و100.
deviceIdentifier

object (DeviceIdentifier)

مطلوبة. مطلوبة. معرّف الجهاز المطلوب البحث عنه.

نص الاستجابة

إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:

تتضمّن الاستجابة أجهزة تم العثور عليها.

تمثيل 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.