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

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