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

عدد الملفات الشخصية التي تم تثبيت تطبيق عليها

للاطّلاع على قائمة الملفات الشخصية التي ثبّتت تطبيقًا، يمكنك استخدام الطريقة المخصّصة findInstalledAppProfiles. يمكنك التحكّم في تقسيم النتائج إلى صفحات باستخدام المَعلمتَين pageSize وpageToken.

طلب

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

الردّ

{
  "totalSize": 2,
  "profiles": [
    {
      "email": "<email1>",
      "profileId": "ca847f92-7988-4ac8-a5a3-d0b8473c8bce",
      "profilePermanentId": "agio5SHt1rlQz3WlnKV41z5Fzxw",
      "profileOrgUnitId": "org_unit_id_1"
    },
    {
      "email": "<email2>",
      "profileId": "g472473e-fe50-4c6e-2ac3-53fe0d0753ce",
      "profilePermanentId": "pgeo2SHt1rlQz1WlnKV41z3Fzxw",
      "profileOrgUnitId": "org_unit_id_2"
    },
  ]
}

طلب متابعة

بالنظر إلى المعرّف الدائم للملف الشخصي الذي تم عرضه في المثال السابق، يمكنك الحصول على مزيد من المعلومات حول الملف الشخصي الذي ثبَّت التطبيق باستخدام Chrome Management Profiles API.