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.