نمونه کد برای Chrome Management Reports API

برای مروری بر ویژگی‌های API، از Chrome Management Reports API دیدن کنید.

تمام درخواست های نشان داده شده در زیر از متغیرهای زیر استفاده می کنند:

  • $TOKEN - نشانه OAuth 2
  • $CUSTOMER - شناسه مشتری یا به معنای واقعی کلمه my_customer
  • $ORG_UNIT_ID - شناسه یک واحد سازمانی خاص که می‌خواهید برای آن درخواست ایجاد کنید.

شمارش نسخه‌های Chrome فعال در محدوده تاریخ

برای مشاهده اینکه کدام نسخه‌های Chrome در یک بازه زمانی مشخص فعال بوده‌اند، از مقدار last_active_date در پارامتر filter استفاده کنید. می توانید صفحه بندی نتایج را با استفاده از پارامترهای pageSize و pageToken کنترل کنید.

درخواست کنید 

  curl -X GET \
  -H "Authorization: Bearer $TOKEN" \
  "https://chromemanagement.googleapis.com/v1/customers/$CUSTOMER/reports:countChromeVersions?filter=last_active_date<2020-11-06+AND+last_active_date>2020-11-04"

پاسخ 

{
  "browserVersions": [
    {
      "count": "1",
      "version": "85.0.4183.83",
      "system": "SYSTEM_MAC",
      "channel": "STABLE"
    },
    {
      "count": "1",
      "version": "85.0.4183.102",
      "system": "SYSTEM_WINDOWS",
      "channel": "STABLE"
    },
    {
      "count": "13697",
      "version": "71.0.3578.96",
      "system": "SYSTEM_MAC",
      "channel": "STABLE"
    },
    {
      "count": "1",
      "version": "87.0.4280.40",
      "system": "SYSTEM_MAC",
      "channel": "BETA"
    },
    {
      "count": "1",
      "version": "88.0.4314.0",
      "system": "SYSTEM_MAC",
      "channel": "CANARY"
    },
    {
      "count": "1718"
    },
  ],
  "totalSize": 5
}

شمارش توزیع نصب های برنامه با تعدادی مجوز

برای مشاهده تعداد دستگاه هایی که یک برنامه خاص را با تعداد مشخصی مجوز نصب کرده اند، از مقدار number_of_permissions در پارامتر filter استفاده کنید. می توانید صفحه بندی نتایج را با استفاده از پارامترهای pageSize و pageToken کنترل کنید.

برای پارامترهای فیلتر بیشتر، به مرجع مراجعه کنید.

درخواست کنید 

  curl -X GET \
  -H "Authorization: Bearer $TOKEN" \
  "https://chromemanagement.googleapis.com/v1/customers/$CUSTOMER/reports:countInstalledApps?filter=number_of_permissions>6"

پاسخ 

{
  "totalSize": 1,
  "installedApps": [
    {
      "browserDeviceCount": "2",
      "appSource": "CHROME_WEBSTORE",
      "displayName": "Secure Shell App",
      "description": "Terminal emulator and SSH and SFTP client.",
      "appType": "APP",
      "appInstallType": "ADMIN",
      "appId": "pnhechapfaindjhompbnflcldabbghjo",
      "homepageUri": "https://chrome.google.com/webstore/detail/pnhechapfaindjhompbnflcldabbghjo",
      "permissions": [
        "clipboardRead",
        "clipboardWrite",
        "crashReportPrivate",
        "idle",
        "metricsPrivate",
        "notifications",
        "storage",
        "unlimitedStorage"
      ]
    },
  ]
}

شمارش دستگاه هایی که برنامه نصب شده دارند

مثال قبلی برنامه ای را نشان می دهد که روی 2 دستگاه نصب شده است. برای مشاهده دستگاه هایی که این برنامه را نصب کرده اند، می توانید از روش سفارشی findInstalledAppDevices استفاده کنید. می توانید صفحه بندی نتایج را با استفاده از پارامترهای pageSize و pageToken کنترل کنید.

درخواست کنید 

  curl -X GET \
  -H "Authorization: Bearer $TOKEN" \
  "https://chromemanagement.googleapis.com/v1/customers/$CUSTOMER/reports:findInstalledAppDevices?appType=app&appId=pnhechapfaindjhompbnflcldabbghjo"

پاسخ 

{
  "totalSize": 2,
  "devices": [
    {
      "machine": "MACHINEA-A",
      "deviceId": "b472473e-fe50-4c6e-9ac3-03fe0d0753ce"
    },
    {
      "machine": "MACHINE-B",
      "deviceId": "a5f49e54-b07b-409f-bc5c-aaf27c483249"
    }
  ]
}

درخواست پیگیری

با توجه به شناسه دستگاهی که در مثال قبلی برگردانده شده است، می‌توانید با استفاده از Admin SDK Directory API برای مرورگرهای Chrome اطلاعات بیشتری در مورد دستگاهی که برنامه را نصب کرده است، دریافت کنید.