Devices

Bu kaynağa yönelik yöntem listesi için bu sayfanın sonuna bakın.

Kaynak temsilleri

Cihazlar kaynağı, EMM tarafından yönetilen ve belirli bir kurumsal kullanıcıya ait 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
  },
  "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 onaltılık dize olarak kodlanır. Örneğin, "123456789abcdef0".
device string Cihazın dahili donanım kod adı. Kaynak: android.os.Build.DEVICE. (günlükler/wireless/android/android_checkin.proto başına "device" adlı alan)
kind string
latestBuildFingerprint string Biliniyorsa cihazın yapı parmak izi.
maker string Cihazın üreticisi. Kaynak: android.os.Build.MANUFACTURER.
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:
  • EMM'nin cihaz politikası denetleyicisinin (DPC) cihaz sahibi "managedDevice" olan cihaz.
  • "managedProfile": DPC tarafından yönetilen bir profile (DPC tarafından yönetilen bir profil sahibidir) ve DPC'nin kullanımına sunulmayan ayrı bir kişisel profile sahip bir cihaz.
  • "containerApp", artık kullanılmıyor (desteği sonlandırılmış).
  • "unmanagedProfile" adlı cihaz.
ziyaret edin.

Kabul edilebilir değerler şunlardır:
  • "containerApp"
  • "managedDevice"
  • "managedProfile"
  • "unmanagedProfile"
model string Cihazın model adı. Kaynak: android.os.Build.MODEL.
policy nested object Politika, cihazda zorunlu kılındı.
policy.autoUpdatePolicy string Cihazda 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 işleminin herhangi bir etkisi olmaz.

"choiceToTheUser" Cihaz kullanıcısının uygulama güncelleme politikasını yapılandırmasına olanak tanır. "her zaman" otomatik güncellemeleri etkinleştirir. "hiçbir zaman" otomatik güncellemeleri devre dışı bırakır. "Yalnızca kablosuz" 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ğini belirler. Varsayılan değer "devicereportDisabled" şeklindedir.

Kabul edilen değerler şunlardır:
  • "deviceReportDisabled"
  • "deviceReportEnabled"
policy.maintenanceWindow nested object Ön planda çalışan uygulamaların ne zaman çalışacağını tanımlayan bakım dönemi güncellenmelidir.
policy.maintenanceWindow.durationMs long Bakım dönemi süresi (milisaniye cinsinden). Süre 30 dakika ile 24 saat (dahil) arasında olmalıdır.
policy.maintenanceWindow.startTimeAfterMidnightMs long Bakım döneminin başlangıç zamanı (cihazda gece yarısından sonra milisaniye cinsinden). Pencereler gece yarısını kapsayabilir.
policy.productAvailabilityPolicy string Belirtilen ürünler için cihaza verilen kullanılabilirlik durumu. "tümü" cihazın, onay durumundan bağımsız olarak tüm ürünlere erişmesine izin verir. "tümü" "alfa"nın otomatik görünürlüğünü etkinleştirmez veya "beta" izler. "beyaz liste" cihazın productPolicy[] politikasında belirtilen ürünlere erişmesine izin verir. Yalnızca kuruluş tarafından onaylanan veya daha önce onaylanmış ürünler (onay iptal edilmiş ürünler) beyaz listeye eklenebilir. Herhangi bir değer sağlanmazsa kullanıcı düzeyinde ayarlanan kullanılabilirlik 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üklenmesiyle ilgili 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. Politika ayarlanmazsa varsayılan olarak "doNotAutoLoad" kullanılır. Uygulamalar, belirli bir bakım dönemi dikkate alınmaksızın otomatik olarak yüklenir.

Kabul edilen değerler şunlardır:
  • "autoInstallOnce"
  • "doNotAutoInstall"
  • "forceAutoInstall"
policy.productPolicy[].autoInstallPolicy.autoInstallPriority integer İmzalanmamış bir tam sayı olarak yüklemenin önceliği. Düşük bir sayı, daha yüksek öncelik anlamına gelir.
policy.productPolicy[].autoInstallPolicy.minimumVersionCode integer Uygulamanın minimum sürümü. Uygulamanın daha eski bir sürümü yüklenirse 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 yoksayı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 işlem, Android WebView kullanılarak özel bir uygulamada gerçekleşen kimlik doğrulama işlemi sırasında kimlik sağlayıcının kimlik doğrulayıcı uygulamasının başlatılmasına yardımcı olur. Authenticator uygulamasının zaten cihazdaki kimlik doğrulama URL'si için varsayılan işleyici olması gerekir.
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ımlanmış 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ının kimliği.
policy.productPolicy[].managedConfiguration.configurationVariables.variableSet[] list Kullanıcıyla ilişkilendirilen değişken kümesi.
policy.productPolicy[].managedConfiguration.configurationVariables.variableSet[].kind string
policy.productPolicy[].managedConfiguration.configurationVariables.variableSet[].placeholder string Yer tutucu dizesi; EMM tarafından tanımlanmıştır.
policy.productPolicy[].managedConfiguration.configurationVariables.variableSet[].userValue string Yer tutucunun kullanıcıya özel değeri.
policy.productPolicy[].managedConfiguration.kind string Kullanımdan kaldırıldı.

policy.productPolicy[].managedConfiguration.managedProperty[] list Bu yapılandırma için yönetilen özellikler grubu.
policy.productPolicy[].managedConfiguration.managedProperty[].key string Mülkü tanımlayan benzersiz anahtar.
policy.productPolicy[].managedConfiguration.managedProperty[].valueBool boolean Boole değeri - Bu, yalnızca özelliğin türü bool olduğunda bulunur.
policy.productPolicy[].managedConfiguration.managedProperty[].valueBundle nested object Yönetilen mülkler grubu - Bu özellik yalnızca mülkün türünün grup olması durumunda bulunur.
policy.productPolicy[].managedConfiguration.managedProperty[].valueBundle.managedProperty[] list Yönetilen mülklerin listesi.
policy.productPolicy[].managedConfiguration.managedProperty[].valueBundleArray[] list Tesis gruplarının listesi. Bu yalnızca özellik türü Bundle_array olduğunda bulunur.
policy.productPolicy[].managedConfiguration.managedProperty[].valueBundleArray[].managedProperty[] list Yönetilen mülklerin listesi.
policy.productPolicy[].managedConfiguration.managedProperty[].valueInteger integer Tam sayı değeri - bu yalnızca özelliğin türü tam sayı olduğunda bulunur.
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ıldığı ü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 trackIds tarafından tanımlanan, belirtilen ürün sürüm kanallarına cihaz görünürlüğü verir. Bir ürünün sürüm kanalları listesine Products.Get araması yapılarak ulaşılabilir.
policy.productPolicy[].tracks[] list Kullanımdan kaldırıldı. Bunun yerine trackIds politikasını kullanın.
product string Cihazın ürün adı. Kaynak: android.os.Build.PRODUCT.
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 mevcut olacaktır.
report.appState[].keyedAppState[] list Anahtarlı uygulama durumlarının listesi. Bu alan her zaman mevcut olacaktır.
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, görüntülemeden önce verilerden tüm HTML'leri 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 ayarlanır. XSS'yi önlemek için, görüntülemeden önce anahtardaki tüm HTML'leri kaldırmanızı öneririz. Bu alan her zaman mevcut olacaktır.
report.appState[].keyedAppState[].message string Uygulama durumunu açıklayan, kullanıcıların okuyabileceği serbest biçimli mesaj. Örneğin, bir hata mesajı. XSS'yi önlemek için, iletiyi görüntülemeden önce iletideki tüm HTML'yi kaldırmanızı öneririz.
report.appState[].keyedAppState[].severity string Uygulama durumunun önem derecesi. Bu alan her zaman mevcut olacaktır.

Kabul edilen değerler şunlardır:
  • "severityError"
  • "severityInfo"
report.appState[].keyedAppState[].stateTimestampMillis long Uygulamanın, epoch'tan bu yana durumu milisaniye cinsinden ayarladığı zaman damgası. Bu alan her zaman mevcut olacaktır.
report.appState[].packageName string Uygulamanın paket adı. Bu alan her zaman mevcut olacaktır.
report.lastUpdatedTimestampMillis long Dönemden beri geçen son rapor güncellemesinin milisaniye cinsinden zaman damgası. Bu alan her zaman mevcut olacaktır.
retailBrand string Ayarlanmışsa cihazın perakende markası. Bkz. android.os.Build.BRAND
sdkVersion integer API uyumluluk sürümü.

Yöntemler

forceReportUpload
Cihazın uygulama durumlarında gerçekleşen değişiklikleri içeren bir rapor yükler son rapor oluşturuldu. Bu yöntemi her 3 defaya kadar çağırabilirsiniz Belirli bir cihaz için 24 saat.
al
Bir cihazın ayrıntılarını getirir.
getState
Bir cihazın Google hizmetlerine erişiminin etkin olup olmadığını veya devre dışı bırakıldı. Cihaz durumu yalnızca Android'de EMM politikaları zorunlu kılındığında geçerli olur cihazlarınızın Google Yönetici Konsolu'ndan etkinleştirilmiş olduğundan emin olun. Aksi takdirde, cihaz durumu yoksayılır ve tüm cihazların erişmesine izin verilir Google hizmetlerine. 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 Android'de EMM politikaları zorunlu kılındığında geçerli olur cihazlarınızın Google Yönetici Konsolu'ndan etkinleştirilmiş olduğundan emin olun. Aksi takdirde, cihaz durumu yoksayılır ve tüm cihazların erişmesine izin verilir Google hizmetlerine. Bu özellik yalnızca Google tarafından yönetilen kullanıcılar için desteklenir.
güncelle
Cihaz politikasını günceller.

Politikanın doğru şekilde uygulandığından emin olmak için yönetilmeyenleri engellemeniz gerekir Google Play'e erişmesini engellemenize olanak tanır. Google için yönetilen yapılandırmada allowed_accounts Play paketi. Kısıtlamaya bakın. hesap.