Method: customers.apps.fetchUsersRequestingExtension

يمكنك الحصول على قائمة بالمستخدمين الذين طلبوا تثبيت إضافة معيّنة.

طلب HTTP

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

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

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

المعلمات
customer

string

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

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

المعلمات
extensionId

string

مطلوب. الإضافة التي نريد العثور على المستخدمين الذين يطلبون استخدامها.
pageSize

integer

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

string

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

string

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

نص الطلب

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

نص الاستجابة

ردّ يحتوي على قائمة بالمستخدمين الذين طلبوا الإضافة التي تم طلبها.

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

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

object (UserRequestingExtensionDetails)

تفاصيل المستخدمين الذين طلبوا الإضافة التي تم طلبها.
totalSize

integer

إجمالي عدد المستخدمين في الاستجابة.
nextPageToken

string

رمز مميز لتحديد الصفحة التالية في القائمة.

نطاقات الأذونات

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

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

UserRequestingExtensionDetails

تفاصيل المستخدم الذي يطلب تمديدًا، بما في ذلك الرسالة الإلكترونية والمبرّر

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

string

عنوان البريد الإلكتروني للمستخدم الذي طلب الإضافة.
justification

string

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