Method: customers.reports.findInstalledAppProfiles

إنشاء تقرير عن ملفات Chrome الشخصية المُدارة التي تم تثبيت تطبيق محدّد عليها

طلب HTTP

GET https://chromemanagement.googleapis.com/v1/{customer=customers/*}/reports:findInstalledAppProfiles

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

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

المعلمات
customer

string

الحقل مطلوب. رقم تعريف العميل أو my_customer لاستخدام العميل المرتبط بالحساب الذي يقدّم الطلب

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

المعلمات
orgUnitId

string

اختياريّ. معرّف الوحدة التنظيمية
appId

string

الحقل مطلوب. المعرّف الفريد للتطبيق، وهو يتألف من 32 حرفًا (مثل ehoadneljpdggcbbknedodolkkjodefl) بالنسبة إلى تطبيقات Chrome وإضافاته. بالنسبة إلى تطبيقات Android، يكون اسم الحزمة (مثل com.evernote).
pageSize

integer

اختياريّ. تعرض هذه المَعلمة أكبر عدد ممكن من النتائج. الحد الأقصى والقيمة التلقائية هما 100.
pageToken

string

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

string

اختياريّ. الحقل المستخدَم لترتيب النتائج

الحقول المتاحة للترتيب حسب:

  • البريد الإلكتروني
  • profileId
  • profilePermanentId
filter

string

اختياريّ. سلسلة طلب البحث لفلترة النتائج، والحقول المفصولة بـ AND في بنية EBNF

ملاحظة: عمليات OR غير متاحة في هذا الفلتر.

حقول الفلاتر المتوافقة:

  • last_active_date
appType

enum (AppType)

نوع التطبيق (اختياري) في حال عدم توفّره، سيتم استنتاج نوع التطبيق من تنسيق معرّف التطبيق.

نص الطلب

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

نص الاستجابة

ردّ يحتوي على قائمة بالملفات الشخصية التي تم تثبيت التطبيق المطلوب عليها.

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

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

object (ProfileAppInstallInstance)

قائمة بالملفات الشخصية التي تم تثبيت التطبيق عليها يتم ترتيبها أبجديًا تصاعديًا حسب حقل profile.Email.
nextPageToken

string

رمز مميز لتحديد الصفحة التالية من الطلب.
totalSize

integer

إجمالي عدد الملفات الشخصية المطابقة للطلب

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

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

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

ProfileAppInstallInstance

تصف هذه السمة ملفًا شخصيًا يعرض معلومات ملف Chrome الشخصي.

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

string

النتائج فقط. معرّف ملف Chrome الشخصي من جهة العميل
profilePermanentId

string

النتائج فقط. المعرّف الدائم للملف الشخصي هو المعرّف الفريد لملف شخصي ضمن حساب عميل واحد.
email

string

النتائج فقط. عنوان البريد الإلكتروني للملف الشخصي
profileOrgUnitId

string

النتائج فقط. رقم تعريف الوحدة التنظيمية للملف الشخصي.