نماذج التعليمات البرمجية لواجهة برمجة التطبيقات 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.