يعثر على الأجهزة التي تمت المطالبة بها للعملاء. لا تتضمّن النتائج سوى الأجهزة المسجَّلة للمورّد والتي تم تحديدها من خلال الوسيطة 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.