Method: customers.apps.fetchDevicesRequestingExtension

يمكنك الحصول على قائمة بالأجهزة التي طلبت تثبيت إضافة معيّنة.

طلب HTTP

GET https://chromemanagement.googleapis.com/v1/{customer=customers/*}/apps:fetchDevicesRequestingExtension

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

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

المعلمات
customer

string

مطلوب. رقم تعريف العميل أو "my_customer" مسبوقًا بـ "customers/"

مَعلمات طلب البحث

المعلمات
extensionId

string

مطلوب. الإضافة التي نريد العثور على الأجهزة التي تطلب ذلك.
pageSize

integer

اختياريّ. الحد الأقصى لعدد النتائج المطلوب عرضها. الحد الأقصى والتلقائي هو 50. سيتم ضبط أي حجم صفحة أكبر من 50 على 50.
pageToken

string

اختياريّ. رمز مميز لتحديد صفحة الطلب التي سيتم عرضها. تنتهي صلاحية الرمز المميّز بعد يوم واحد.
orgUnitId

string

رقم تعريف الوحدة التنظيمية. لا تأخذ في الاعتبار سوى الأجهزة التي تنتمي مباشرةً إلى هذه الوحدة التنظيمية، أي أنّه لا يتم احتساب الوحدات التنظيمية الفرعية. وفي حال حذفها، سيتم عرض جميع البيانات.

نص الطلب

يجب أن يكون نص الطلب فارغًا.

نص الاستجابة

ردّ يحتوي على قائمة بالأجهزة التي طلبت الإضافة التي تم طلبها.

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

تمثيل JSON 
{
  "deviceDetails": [
    {
      object (DeviceRequestingExtensionDetails)
    }
  ],
  "totalSize": integer,
  "nextPageToken": string
}
الحقول
deviceDetails[]

object (DeviceRequestingExtensionDetails)

تفاصيل الأجهزة التي طلبت الإضافة التي تم الاستعلام عنها
totalSize

integer

اختياريّ. إجمالي عدد الأجهزة التي تمّت معالجتها
nextPageToken

string

اختياريّ. رمز مميّز لتحديد الصفحة التالية في القائمة تنتهي صلاحية الرمز المميّز بعد يوم واحد.

نطاقات التفويض

يجب توفير نطاق OAuth التالي:

  • https://www.googleapis.com/auth/chrome.management.appdetails.readonly

DeviceRequestingExtensionDetails

تفاصيل جهاز يطلب تمديد فترة الاشتراك، بما في ذلك اسم الجهاز وسبب الطلب

تمثيل JSON 
{
  "deviceName": string,
  "justification": string
}
الحقول
deviceName

string

اسم جهاز طلب الإضافة
justification

string

تبرير الطلب على النحو الذي أدخله المستخدم.