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, "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 onaltılık dize olarak kodlanı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:
Kabul edilebilir değerler şunlardır:
|
|
model |
string |
Cihazın model adı. Kaynak: android.os.Build.MODEL . |
|
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ın kullanıcısının uygulama güncelleme politikasını yapılandırmasına olanak tanır. "always" (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:
|
|
policy.deviceReportPolicy |
string |
Cihazın, uygulama durumlarını EMM'ye bildirip bildirmeyeceğini belirler. Varsayılan değer "deviceReportDisabled"dir.
Kabul edilen değerler şunlardır:
|
|
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 müsaitlik durumu. "tümü" cihazın, onay durumundan bağımsız olarak tüm ürünlere erişmesine izin verir. "Tümü", "alfa" veya "beta" kanallarının otomatik olarak görünürlüğünü etkinleştirmez. "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:
|
|
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:
|
|
policy.productPolicy[].autoInstallPolicy.autoInstallConstraint[].deviceIdleStateConstraint |
string |
Cihaz boşta kalma durumu kısıtlaması.
Kabul edilen değerler şunlardır:
|
|
policy.productPolicy[].autoInstallPolicy.autoInstallConstraint[].networkTypeConstraint |
string |
Ağ türü kısıtlaması.
Kabul edilen değerler şunlardır:
|
|
policy.productPolicy[].autoInstallPolicy.autoInstallMode |
string |
Otomatik yükleme modu. Ayarlanmazsa varsayılan olarak "doNotAutoInstall" olur. Uygulamalar, belirli bir bakım dönemi dikkate alınmaksızın otomatik olarak yüklenir.
Kabul edilen değerler şunlardır:
|
|
policy.productPolicy[].autoInstallPolicy.autoInstallPriority |
integer |
Yüklemenin önceliği (imzasız tam sayı). 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ü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:
|
|
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. 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ı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ı 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 |
Tesisi 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 paketi: Bu yalnızca mülkün türü paket ise mevcuttur. | |
policy.productPolicy[].managedConfiguration.managedProperty[].valueBundle.managedProperty[] |
list |
Yönetilen mülklerin listesi. | |
policy.productPolicy[].managedConfiguration.managedProperty[].valueBundleArray[] |
list |
Tesis paketlerinin 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 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ürlüğü verir. 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ı. 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 mevcuttur. | |
report.appState[].keyedAppState[] |
list |
Anahtarlı 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, görüntülemeden önce verilerden tüm HTML'leri kaldırmanızı öneririz. | |
report.appState[].keyedAppState[].key |
string |
Uygulamanın hangi durum için durum bilgisi sağladığını belirten anahtar. Anahtarın içeriği, uygulamanın geliştiricisi tarafından ayarlanır. 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, 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 mevcuttur.
Kabul edilen değerler şunlardır:
|
|
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 mevcuttur. | |
report.lastUpdatedTimestampMillis |
long |
Unix başlangıç tarihinden itibaren milisaniye cinsinden son rapor güncellemesinin 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. Belirli bir cihaz için bu yöntemi 24 saat içinde 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 olup olmadığını veya devre dışı bırakılıp bırakılmadığını alır. 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
- Cihazın Google hizmetlerine erişiminin etkin olup olmadığını 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.
- 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ırmadaallowed_accounts
Play paketi. Google Play'de hesapları kısıtlama başlıklı makaleyi inceleyin.