Devices

Bu kaynak için yöntemlerin listesi bu sayfanın sonuna verilmiştir.

Kaynak temsilleri

Cihazlar kaynağı, EMM tarafından yönetilen ve belirli bir kurumsal kullanıcıya ait bir mobil cihazı temsil eder.

{
  "kind": "androidenterprise#device",
  "androidId": string,
  "managementType": string,
  "policy": {
    "autoUpdatePolicy": string,
    "productAvailabilityPolicy": string,
    "productPolicy": [
      {
        "productId": string,
        "tracks": [
          string
        ],
        "trackIds": [
          string
        ],
        "managedConfiguration": {
          "kind": string,
          "productId": string,
          "managedProperty": [
            {
              "key": string,
              "valueBool": boolean,
              "valueInteger": integer,
              "valueString": string,
              "valueStringArray": [
                string
              ],
              "valueBundle": {
                "managedProperty": [
                  (ManagedProperty)
                ]
              },
              "valueBundleArray": [
                {
                  "managedProperty": [
                    (ManagedProperty)
                  ]
                }
              ]
            }
          ],
          "configurationVariables": {
            "kind": "androidenterprise#configurationVariables",
            "mcmId": string,
            "variableSet": [
              {
                "kind": "androidenterprise#variableSet",
                "placeholder": string,
                "userValue": string
              }
            ]
          }
        },
        "autoInstallPolicy": {
          "autoInstallMode": string,
          "autoInstallPriority": integer,
          "autoInstallConstraint": [
            {
              "networkTypeConstraint": string,
              "chargingStateConstraint": string,
              "deviceIdleStateConstraint": string
            }
          ],
          "minimumVersionCode": integer
        },
        "autoUpdateMode": string,
        "enterpriseAuthenticationAppLinkConfigs": [
          {
            "uri": string
          }
        ]
      }
    ],
    "maintenanceWindow": {
      "startTimeAfterMidnightMs": long,
      "durationMs": long
    },
    "deviceReportPolicy": string,
    "policyId": string
  },
  "report": {
    "lastUpdatedTimestampMillis": long,
    "appState": [
      {
        "packageName": string,
        "keyedAppState": [
          {
            "key": string,
            "stateTimestampMillis": long,
            "severity": string,
            "message": string,
            "data": string
          }
        ]
      }
    ]
  },
  "latestBuildFingerprint": string,
  "sdkVersion": integer,
  "maker": string,
  "model": string,
  "device": string,
  "product": string,
  "retailBrand": string
}
Mülk adı Değer Açıklama Notlar
androidId string Cihazın Google Play Hizmetleri Android kimliği, küçük harfli bir onaltılık dize olarak kodlanmıştır. Örneğin, "123456789abcdef0".
device string Cihazın dahili donanım kod adı. Bu, android.os.Build.DEVICE tarafından gönderilmiştir. (günlükler/wireless/android/android_checkin.proto başına "device" adlı alan)
kind string
latestBuildFingerprint string Biliniyorsa cihazın derleme parmak izi.
maker string Cihazın üreticisi. Bu, android.os.Build.MANUFACTURER tarafından gönderilmiştir.
managementType string Cihazın çeşitli dağıtım yapılandırmalarında Managed Google Play EMM tarafından ne ölçüde kontrol edildiğini tanımlar.

Olası değerler şunları içerir:
  • "managedDevice", cihaz sahibi olarak EMM'nin cihaz politikası denetleyicisine (DPC) sahip bir cihaz.
  • "managedProfile": DPC tarafından yönetilen bir profilin (DPC, profil sahibidir) yanı sıra DPC'nin kullanamadığı ayrı bir kişisel profilin bulunduğu cihaz.
  • "containerApp", artık kullanılmıyor (desteği sonlandırılmış).
  • "unmanagedProfile": Yönetilen Google Play'in kullanılmasına izin verilen (alan yöneticisi tarafından, ayrıcalığı etkinleştirmek için Yönetici Konsolu kullanılarak) ancak profilin kendisi bir DPC'ye ait olmayan bir cihaz.


Kabul edilebilir değerler şunlardır:
  • "containerApp"
  • "managedDevice"
  • "managedProfile"
  • "unmanagedProfile"
model string Cihazın model adı. Bu, android.os.Build.MODEL tarafından gönderilmiştir.
policy nested object Cihazda zorunlu olarak uygulanan politika.
policy.autoUpdatePolicy string Cihazdaki otomatik uygulama güncellemelerinin ne zaman uygulanabileceğini kontrol eder.

Önerilen alternatif: Uygulama başına ayarlanan autoUpdateMode, güncelleme sıklığı konusunda daha fazla esneklik sağlar.

autoUpdateMode AUTO_UPDATE_POSTPONED veya AUTO_UPDATE_HIGH_PRIORITY olarak ayarlandığında autoUpdatePolicy'in hiçbir etkisi olmaz.
  • choiceToTheUser, cihaz kullanıcısının uygulama güncelleme politikasını yapılandırmasına izin verir.
  • always, otomatik güncellemeleri etkinleştirir.
  • never özelliği otomatik güncellemeleri devre dışı bırakır.
  • wifiOnly, otomatik güncellemeleri yalnızca cihaz kablosuz ağa bağlıyken etkinleştirir.


Kabul edilen değerler şunlardır:
  • "always"
  • "choiceToTheUser"
  • "never"
  • "wifiOnly"
policy.deviceReportPolicy string Cihazın uygulama durumlarını EMM'ye bildirip bildirmeyeceği. Varsayılan değer "deviceReportDisabled"dir.

Kabul edilen değerler şunlardır:
  • "deviceReportDisabled"
  • "deviceReportEnabled"
policy.maintenanceWindow nested object Ön planda çalışan uygulamaların ne zaman çalıştırılacağını tanımlayan bakım dönemi güncellenmelidir.
policy.maintenanceWindow.durationMs long Bakım döneminin milisaniye cinsinden süresi. Süre 30 dakika ile 24 saat arasında (bu değerler dahil) olmalıdır.
policy.maintenanceWindow.startTimeAfterMidnightMs long Cihazın gece yarısından sonraki milisaniye cinsinden bakım döneminin başlangıç zamanı. Pencereler gece yarısına kadar sürebilir.
policy.policyId string Play Store'dan gönderilen uygulama yükleme geri bildirimiyle iletilecek politika tanımlayıcısı.
policy.productAvailabilityPolicy string Belirtilen ürünler için cihaza verilen kullanılabilirlik durumu. "all", cihaza onay durumundan bağımsız olarak tüm ürünlere erişim verir. "all" seçeneği, "alfa" veya "beta" kanalların otomatik görünürlüğünü etkinleştirmez. "whitelist", cihaza productPolicy[] içinde belirtilen ürünlere erişim izni verir. Yalnızca onaylanmış veya daha önce onaylanmış ürünler (onayları iptal edilmiş ürünler) beyaz listeye eklenebilir. Herhangi bir değer sağlanmazsa kullanıcı düzeyinde ayarlanan müsaitlik durumu varsayılan olarak uygulanır.

Kabul edilen değerler şunlardır:
  • "all"
  • "whitelist"
policy.productPolicy[] list Ürün politikalarının listesi. Ürün politikalarının uygulanabilmesi için productAvailabilityPolicy, WHITELIST veya ALL olarak ayarlanmalıdır.
policy.productPolicy[].autoInstallPolicy nested object Ürünün otomatik yükleme politikası.
policy.productPolicy[].autoInstallPolicy.autoInstallConstraint[] list Uygulamanın otomatik olarak yüklenmesi için kısıtlamalar. En fazla bir kısıtlama belirtebilirsiniz.

policy.productPolicy[].autoInstallPolicy.autoInstallConstraint[].chargingStateConstraint string Şarj durumu kısıtlaması.

Kabul edilen değerler şunlardır:
  • "chargingNotRequired"
  • "chargingRequired"
policy.productPolicy[].autoInstallPolicy.autoInstallConstraint[].deviceIdleStateConstraint string Cihaz boşta kalma durumu kısıtlaması.

Kabul edilen değerler şunlardır:
  • "deviceIdleNotRequired"
  • "deviceIdleRequired"
policy.productPolicy[].autoInstallPolicy.autoInstallConstraint[].networkTypeConstraint string Ağ türü kısıtlaması.

Kabul edilen değerler şunlardır:
  • "anyNetwork"
  • "unmeteredNetwork"
policy.productPolicy[].autoInstallPolicy.autoInstallMode string Otomatik yükleme modu. Ayarlanmazsa varsayılan olarak "doNotAutoInstall" olur. Uygulama, belirlenen bakım döneminden bağımsız olarak otomatik olarak yüklenir.

Kabul edilen değerler şunlardır:
  • "autoInstallOnce"
  • "doNotAutoInstall"
  • "forceAutoInstall"
policy.productPolicy[].autoInstallPolicy.autoInstallPriority integer Yüklemenin önceliği, imzasız tam sayı olarak. Sayı ne kadar küçükse öncelik o kadar yüksektir.
policy.productPolicy[].autoInstallPolicy.minimumVersionCode integer Uygulamanın minimum sürümü. Uygulamanın daha eski bir sürümü yüklüyse uygulama, normal otomatik güncellemeyi beklemek yerine otomatik yükleme kısıtlamalarına göre otomatik olarak güncellenir. Cihaz başına en fazla 20 uygulama için minimum sürüm kodu belirleyebilirsiniz.
policy.productPolicy[].autoUpdateMode string Ürünün otomatik güncelleme modu. autoUpdateMode kullanıldığında her zaman kullanıcının seçimine göre öncelikli olur. Bu nedenle, kullanıcı cihaz ayarlarında manuel olarak değişiklik yaptığında bu değişiklikler yok sayılır.

Kabul edilen değerler şunlardır:
  • "autoUpdateDefault"
  • "autoUpdateHighPriority"
  • "autoUpdatePostponed"
policy.productPolicy[].enterpriseAuthenticationAppLinkConfigs[] list Bir kimlik sağlayıcının kimlik doğrulayıcı uygulaması için kimlik doğrulama URL'si yapılandırması. Bu, Android WebView kullanan özel bir uygulamada kimlik doğrulama sırasında kimlik sağlayıcının kimlik doğrulayıcı uygulamasının başlatılmasına yardımcı olur. Kimlik doğrulayıcı uygulaması, cihazdaki kimlik doğrulama URL'si için varsayılan işleyici olmalıdır.
policy.productPolicy[].enterpriseAuthenticationAppLinkConfigs[].uri string Kimlik doğrulama URL'si.
policy.productPolicy[].managedConfiguration nested object Ürünün yönetilen yapılandırması.
policy.productPolicy[].managedConfiguration.configurationVariables nested object Yönetilen yapılandırma profilinin kimliğini ve kullanıcı için tanımlanan yapılandırma değişkenleri grubunu (varsa) içerir.
policy.productPolicy[].managedConfiguration.configurationVariables.kind string
policy.productPolicy[].managedConfiguration.configurationVariables.mcmId string Yönetilen yapılandırma ayarları kimliği.
policy.productPolicy[].managedConfiguration.configurationVariables.variableSet[] list Kullanıcıyla ilişkilendirilen değişken grubu.
policy.productPolicy[].managedConfiguration.configurationVariables.variableSet[].kind string
policy.productPolicy[].managedConfiguration.configurationVariables.variableSet[].placeholder string EMM tarafından tanımlanan yer tutucu dizesi.
policy.productPolicy[].managedConfiguration.configurationVariables.variableSet[].userValue string Kullanıcıya özgü yer tutucunun değeri.
policy.productPolicy[].managedConfiguration.kind string Desteği sonlandırıldı.

policy.productPolicy[].managedConfiguration.managedProperty[] list Bu yapılandırma için yönetilen mülk grubu.
policy.productPolicy[].managedConfiguration.managedProperty[].key string Mülkü tanımlayan benzersiz anahtar.
policy.productPolicy[].managedConfiguration.managedProperty[].valueBool boolean Boole değeri: Bu değer yalnızca mülkün türü boole ise mevcuttur.
policy.productPolicy[].managedConfiguration.managedProperty[].valueBundle nested object Yönetilen mülkler grubu - Bu özellik yalnızca mülkün türünün paket olması durumunda bulunur.
policy.productPolicy[].managedConfiguration.managedProperty[].valueBundle.managedProperty[] list Yönetilen mülklerin listesi.
policy.productPolicy[].managedConfiguration.managedProperty[].valueBundleArray[] list Mülk paketlerinin listesi. Bu yalnızca mülkün türü bundle_array ise mevcuttur.
policy.productPolicy[].managedConfiguration.managedProperty[].valueBundleArray[].managedProperty[] list Yönetilen mülklerin listesi.
policy.productPolicy[].managedConfiguration.managedProperty[].valueInteger integer Tam sayı değeri: Bu değer yalnızca mülkün türü tam sayıysa mevcuttur.
policy.productPolicy[].managedConfiguration.managedProperty[].valueString string Dize değeri: Bu değer, yalnızca özelliğin türü dize, seçim veya gizli olduğunda sunulur.
policy.productPolicy[].managedConfiguration.managedProperty[].valueStringArray[] list Dize değerleri listesi - bu yalnızca özelliğin türü çoklu seçim olduğunda bulunur.
policy.productPolicy[].managedConfiguration.productId string Yönetilen yapılandırmanın kullanılacağı ürünün kimliği (ör. "app:com.google.android.gm").
policy.productPolicy[].productId string Ürünün kimliği. Örneğin, "app:com.google.android.gm".
policy.productPolicy[].trackIds[] list Cihazın, trackIds ile tanımlanan belirli ürün sürüm kanallarına görünür olmasını sağlar. Bir ürünün sürüm kanallarının listesi, Products.Get çağrısı yapılarak elde edilebilir.
policy.productPolicy[].tracks[] list Kullanımdan kaldırıldı. Bunun yerine trackIds politikasını kullanın.
product string Cihazın ürün adı. Bu, android.os.Build.PRODUCT tarafından gönderilmiştir.
report nested object Cihaz raporu, en son uygulama durumlarıyla güncellendi.
report.appState[] list Cihazdaki yönetilen uygulamalar tarafından ayarlanan uygulama durumlarının listesi. Uygulama durumları, uygulamanın geliştiricileri tarafından tanımlanır. Bu alan her zaman mevcuttur.
report.appState[].keyedAppState[] list Anahtarlanmış uygulama durumlarının listesi. Bu alan her zaman mevcuttur.
report.appState[].keyedAppState[].data string Makine tarafından okunabilir veriler için tasarlanmış ek alan. Örneğin, bir sayı veya JSON nesnesi. XSS'yi önlemek için verileri göstermeden önce verilerden HTML'yi kaldırmanızı öneririz.
report.appState[].keyedAppState[].key string Uygulamanın ne için durum sağladığını gösteren anahtar. Anahtarın içeriği, uygulamanın geliştiricisi tarafından belirlenir. XSS'yi önlemek için anahtarı göstermeden önce anahtardan tüm HTML'leri kaldırmanızı öneririz. Bu alan her zaman mevcut olacaktır.
report.appState[].keyedAppState[].message string Uygulama durumunu açıklayan, serbest biçimli, kullanıcıların okuyabileceği bir mesaj. Örneğin, bir hata mesajı. XSS'yi önlemek için mesajı göstermeden önce mesajdaki tüm HTML'leri kaldırmanızı öneririz.
report.appState[].keyedAppState[].severity string Uygulama durumunun önem derecesi. Bu alan her zaman mevcuttur.

Kabul edilen değerler şunlardır:
  • "severityError"
  • "severityInfo"
report.appState[].keyedAppState[].stateTimestampMillis long Uygulamanın durumu ayarlamasının zaman damgası (epoch'tan itibaren milisaniye cinsinden). Bu alan her zaman mevcuttur.
report.appState[].packageName string Uygulamanın paket adı. Bu alan her zaman mevcuttur.
report.lastUpdatedTimestampMillis long Unix başlangıç tarihinden itibaren milisaniye cinsinden son rapor güncellemesinin zaman damgası. Bu alan her zaman mevcuttur.
retailBrand string Ayarlanmışsa cihazın perakende markası. Bkz. android.os.Build.BRAND
sdkVersion integer API uyumluluk sürümü.

Yöntemler

forceReportUpload
Son raporun oluşturulmasından bu yana cihazdaki uygulama durumlarında yapılan değişiklikleri içeren bir rapor yükler. Bu yöntemi belirli bir cihaz için 24 saatte bir en fazla 3 kez çağırabilirsiniz.
get
Bir cihazın ayrıntılarını alır.
getState
Bir cihazın Google hizmetlerine erişiminin etkin mi yoksa devre dışı mı olduğunu alır. Cihaz durumu yalnızca Android cihazlarda EMM politikalarının zorunlu kılınması Google Yönetici Konsolu'nda etkinleştirildiyse geçerli olur. Aksi takdirde cihaz durumu yoksayılır ve tüm cihazların Google hizmetlerine erişmesine izin verilir. Bu özellik yalnızca Google tarafından yönetilen kullanıcılar için desteklenir.
list
Kullanıcının tüm cihazlarının kimliklerini alır.
setState
Bir cihazın Google hizmetlerine erişiminin etkin mi yoksa devre dışı mı olduğunu belirler. Cihaz durumu yalnızca Google Yönetici Konsolu'nda Android cihazlarda EMM politikalarının uygulanması etkinleştirildiyse geçerli olur. Aksi takdirde cihaz durumu yoksayılır ve tüm cihazların Google hizmetlerine erişmesine izin verilir. Bu özellik yalnızca Google tarafından yönetilen kullanıcılar için desteklenir.
update
Cihaz politikasını günceller.

Politikanın düzgün şekilde uygulandığından emin olmak için Google Play paketinin yönetilen yapılandırmasında allowed_accounts ayarını yaparak yönetilmeyen hesapların Google Play'e erişmesini engellemeniz gerekir. Google Play'de hesapları kısıtlama konusuna bakın.