Method: customers.reports.findInstalledAppProfiles

گزارش پروفایل‌های مدیریت‌شده‌ی کروم که برنامه‌ی مشخصی روی آن‌ها نصب شده است را ایجاد کنید.

درخواست HTTP

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

این URL از سینتکس Transcoding در gRPC استفاده می‌کند.

پارامترهای مسیر

پارامترها
customer

string

الزامی. شناسه مشتری یا "my_customer" برای استفاده از مشتری مرتبط با حساب کاربری که درخواست را ارسال می‌کند.

پارامترهای پرس و جو

پارامترها
orgUnitId

string

اختیاری. شناسه واحد سازمانی.

appId

string

الزامی. شناسه منحصر به فرد برنامه. برای برنامه‌ها و افزونه‌های کروم، شناسه ۳۲ کاراکتری (مثلاً ehoadneljpdggcbbknedodolkkjodefl). برای برنامه‌های اندروید، نام بسته (مثلاً com.evernote).

pageSize

integer

اختیاری. حداکثر تعداد نتایج برای برگرداندن. حداکثر و پیش‌فرض ۱۰۰ است.

pageToken

string

اختیاری. توکنی برای مشخص کردن صفحه درخواستی که قرار است برگردانده شود.

orderBy

string

اختیاری. فیلدی که برای مرتب‌سازی نتایج استفاده می‌شود.

مرتب‌سازی پشتیبانی‌شده بر اساس فیلدها:

  • ایمیل
  • شناسه پروفایل
  • شناسه دائمی پروفایل
filter

string

اختیاری. رشته پرس‌وجو برای فیلتر کردن نتایج، فیلدهای جدا شده با AND در سینتکس EBNF.

نکته: عملیات OR در این فیلتر پشتیبانی نمی‌شود.

فیلدهای فیلتر پشتیبانی شده:

  • آخرین_تاریخ_فعالیت
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

نمونه نصب برنامه پروفایل

نمایه‌ای را توصیف می‌کند که اطلاعات نمایه Chrome را گزارش می‌دهد.

نمایش JSON 
{
  "profileId": string,
  "profilePermanentId": string,
  "email": string,
  "profileOrgUnitId": string
}
فیلدها
profileId

string

فقط خروجی. شناسه پروفایل سمت کلاینت کروم.

profilePermanentId

string

فقط خروجی. شناسه دائمی پروفایل، شناسه منحصر به فرد یک پروفایل در یک مشتری است.

email

string

فقط خروجی. ایمیل پروفایل.

profileOrgUnitId

string

فقط خروجی. شناسه واحد سازمانی نمایه.