דוגמאות קוד עבור Chrome Management Reports API

במאמר Chrome Management Reports API יש סקירה כללית של תכונות ה-API.

כל הבקשות שמוצגות בהמשך משתמשות במשתנים הבאים:

• ‫$TOKEN – טוקן OAuth 2
• ‫$CUSTOMER - ID of the customer or literal 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.

ספירת פרופילים שבהם מותקנת אפליקציה

כדי לראות את רשימת הפרופילים שבהם האפליקציה מותקנת, אפשר להשתמש ב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.