Önemli: Artık Play EMM API için yeni kayıtlar kabul edilmemektedir. Daha fazla bilgi edinin.

Bu sayfa, Cloud Translation API ile çevrilmiştir.

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
`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.