نماذج التعليمات البرمجية لواجهة برمجة التطبيقات Chrome Management Reports 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"
      ]
    },
  ]
}

عد الأجهزة التي تحتوي على تطبيق مثبَّت

أظهر المثال السابق تطبيقًا تم تثبيته على جهازين. لعرض الأجهزة التي تم تثبيت هذا التطبيق عليها، يمكنك استخدام طريقة مخصّصة واحدة (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