نماذج التعليمات البرمجية لواجهة برمجة التطبيقات 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:countChromeProfileVersions?filter=last_active_date<2020-11-06+AND+last_active_date>2020-11-04"

الردّ

{
  "profileBrowserVersions": [
    {
      "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": 6
}

عدد إصدارات 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.