البحث عن الأجهزة التي تمت المطالبة بها للعملاء. لا تحتوي النتائج إلا على الأجهزة المسجَّلة للمورّد والتي تم تحديدها من خلال الوسيطة partnerId
. لا تظهر أجهزة العميل التي تم شراؤها من مورّدين آخرين في النتائج.
طلب HTTP
POST https://androiddeviceprovisioning.googleapis.com/v1/partners/{partnerId}/devices:findByOwner
يستخدم عنوان URL بنية تحويل ترميز gRPC.
معلمات المسار
المعلَمات | |
---|---|
partnerId |
مطلوبة. رقم تعريف الشريك المورّد |
نص الطلب
يحتوي نص الطلب على بيانات بالبنية التالية:
تمثيل JSON |
---|
{
"pageToken": string,
"limit": string,
"sectionType": enum ( |
الحقول | |
---|---|
pageToken |
رمز مميز يحدد صفحة النتائج المراد عرضها. |
limit |
مطلوبة. الحد الأقصى لعدد الأجهزة التي يتم عرضها في صفحة النتائج. يجب أن تتراوح القيمة بين 1 و100. |
sectionType |
مطلوبة. نوع القسم من سجل إدارة حسابات الجهاز. |
customerId[] |
قائمة الأرقام التعريفية للعملاء المراد البحث عنها. |
googleWorkspaceCustomerId[] |
قائمة أرقام تعريف حسابات Google Workspace المطلوب البحث عنها |
نص الاستجابة
إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:
تتضمّن الاستجابة أجهزة تم العثور عليها.
تمثيل JSON |
---|
{
"devices": [
{
object ( |
الحقول | |
---|---|
devices[] |
أجهزة العميل. |
nextPageToken |
رمز مميز يُستخدم للوصول إلى صفحة النتائج التالية. يتم حذفها في حال عدم توفُّر نتائج أخرى. |
totalSize |
إجمالي عدد العناصر في القائمة بغض النظر عن عملية التقسيم على صفحات. |
نطاقات الأذونات
يجب توفير نطاق OAuth التالي:
https://www.googleapis.com/auth/androidworkprovisioning
لمزيد من المعلومات، راجع نظرة عامة على OAuth 2.0.