Chrome Management Reports API için Kod Örnekleri

API özelliklerine genel bir bakış için Chrome Management Reports API sayfasını ziyaret edin.

Aşağıda gösterilen tüm isteklerde şu değişkenler kullanılır:

  • $TOKEN - OAuth 2 jetonu
  • $CUSTOMER - Müşterinin kimliği veya değişmez değer my_customer
  • $ORG_UNIT_ID - İstek oluşturmak istediğiniz belirli bir kuruluş biriminin kimliği.

Tarih aralığında etkin olan Chrome sürümlerinin sayısı

Belirli bir zaman aralığında hangi Chrome sürümlerinin etkin olduğunu görmek için filter parametresinde last_active_date değerini kullanın. pageSize ve pageToken parametrelerini kullanarak sonuçların sayfalandırılmasını kontrol edebilirsiniz.

İstek

  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"

Yanıt

{
  "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
}

Uygulama yüklemelerinin izin sayısına göre dağılımını sayma

Belirli bir uygulamayı belirli sayıda izinle yükleyen cihazların sayısını görüntülemek için filter parametresinde number_of_permissions değerini kullanın. pageSize ve pageToken parametrelerini kullanarak sonuçların sayfalandırılmasını kontrol edebilirsiniz.

Daha fazla filtre parametresi için referans sayfasını ziyaret edin.

İstek

  curl -X GET \
  -H "Authorization: Bearer $TOKEN" \
  "https://chromemanagement.googleapis.com/v1/customers/$CUSTOMER/reports:countInstalledApps?filter=number_of_permissions>6"

Yanıt

{
  "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"
      ]
    },
  ]
}

Yüklü uygulaması olan cihazları sayma

Önceki örnekte, 2 cihaza yüklenmiş bir uygulama gösteriliyordu. Bu uygulamayı yükleyen cihazları görüntülemek için findInstalledAppDevices özel yöntemini kullanabilirsiniz. pageSize ve pageToken parametrelerini kullanarak sonuçların sayfalandırılmasını kontrol edebilirsiniz.

İstek

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

Yanıt

{
  "totalSize": 2,
  "devices": [
    {
      "machine": "MACHINEA-A",
      "deviceId": "b472473e-fe50-4c6e-9ac3-03fe0d0753ce"
    },
    {
      "machine": "MACHINE-B",
      "deviceId": "a5f49e54-b07b-409f-bc5c-aaf27c483249"
    }
  ]
}

Takip isteği

Önceki örnekte döndürülen cihaz kimliğini göz önünde bulundurarak Chrome Tarayıcılar için Admin SDK Directory API'sini kullanarak uygulamayı yükleyen cihaz hakkında daha fazla bilgi edinebilirsiniz.

Yüklü uygulaması olan profilleri sayma

Bir uygulamayı yükleyen profillerin listesini görüntülemek için findInstalledAppProfiles özel yöntemini kullanabilirsiniz. pageSize ve pageToken parametrelerini kullanarak sonuçların sayfalandırılmasını kontrol edebilirsiniz.

İstek

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

Yanıt

{
  "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"
    },
  ]
}

Takip isteği

Önceki örnekte döndürülen profil kalıcı kimliği göz önüne alındığında, Chrome Management Profiles API'yi kullanarak uygulamayı yükleyen profil hakkında daha fazla bilgi edinebilirsiniz.