Method: customers.reports.findInstalledAppDevices

گزارشی از دستگاه‌های مرورگر Chrome مدیریت‌شده که برنامه مشخص‌شده‌ای را نصب کرده‌اند، ایجاد کنید.

درخواست HTTP

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

URL از دستور GRPC Transcoding استفاده می کند.

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

پارامترها
customer

string

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

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

پارامترها
orgUnitId

string

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

appId

string

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

pageSize

integer

حداکثر تعداد نتایج برای بازگشت. حداکثر و پیش فرض 100 است.

pageToken

string

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

orderBy

string

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

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

  • دستگاه
  • شناسه دستگاه
filter

string

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

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

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

  • last_active_date
appType

enum ( AppType )

نوع برنامه اختیاری. اگر ارائه نشود، یک نوع برنامه از قالب شناسه برنامه استنتاج می شود.

درخواست بدن

بدنه درخواست باید خالی باشد.

بدن پاسخگو

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

در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی داده هایی با ساختار زیر است:

نمایندگی JSON 
{
  "devices": [
    {
      object (Device)
    }
  ],
  "nextPageToken": string,
  "totalSize": integer
}
فیلدها
devices[]

object ( Device )

لیستی از دستگاه هایی که برنامه را نصب کرده اند. در قسمت Device.machine به ترتیب حروف الفبای صعودی مرتب شده است.

nextPageToken

string

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

totalSize

integer

تعداد کل درخواست مطابقت دستگاه.

محدوده مجوز

به محدوده OAuth زیر نیاز دارد:

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

دستگاه

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

نمایندگی JSON 
{
  "deviceId": string,
  "machine": string
}
فیلدها
deviceId

string

فقط خروجی شناسه دستگاهی که این اطلاعات مرورگر Chrome را گزارش کرده است.

machine

string

فقط خروجی نام دستگاه در شبکه محلی آن.