Bu kaynağa ilişkin yöntemlerin 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 olan 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 }, "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 kodlanmış. Örneğin, "123456789abcdef0" . |
|
device |
string |
Cihazın dahili donanım kod adı. Bu, android.os.Build.DEVICE kaynağından geliyor. (günlükler/kablosuz/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 kaynağından geliyor. |
|
managementType |
string |
Cihazın çeşitli dağıtım yapılandırmalarında bir 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ı. Bu, android.os.Build.MODEL kaynağından geliyor. |
|
policy |
nested object |
Cihazda uygulanan politika. | |
policy.autoUpdatePolicy |
string |
Cihazda otomatik uygulama güncellemelerinin ne zaman uygulanabileceğini kontrol eder. Önerilen alternatif: Uygulama bazında 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 etkili olmaz. "choiceToTheUser", cihaz kullanıcısının uygulama güncelleme politikasını yapılandırmasına izin verir. "her zaman" seçeneği, otomatik güncellemeleri etkinleştirir. "hiçbir zaman" seçeneği otomatik güncellemeleri devre dışı bırakır. "wifiOnly" özelliği, otomatik güncellemeleri yalnızca cihaz kablosuz ağa bağlıyken etkinleştirir. Kabul edilebilir değerler şunlardır:
|
|
policy.deviceReportPolicy |
string |
Cihazın, uygulama durumlarını EMM'ye bildirip bildirmeyeceğini belirler. Varsayılan değer "deviceReportDisabled" şeklindedir.
Kabul edilebilir değerler şunlardır:
|
|
policy.maintenanceWindow |
nested object |
Ön planda çalışan uygulamaların ne zaman güncellenmesi gerektiğini belirleyen bakım dönemi. | |
policy.maintenanceWindow.durationMs |
long |
Bakım döneminin milisaniye cinsinden süresi. 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ına kadar sürebilir. | |
policy.productAvailabilityPolicy |
string |
Belirtilen ürünler için cihaza verilen stok durumu. "tümü", onay durumundan bağımsız olarak cihazın tüm ürünlere erişmesini sağlar. "tümü", "alfa" veya "beta" parçaları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 onaylanmış ürünler 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 müsaitlik durumu varsayılan olarak uygulanır.
Kabul edilebilir değerler şunlardır:
|
|
policy.productPolicy[] |
list |
Ürün politikalarının listesi. Ürün politikalarının uygulanabilmesi için productAvailabilityPolicy politikasının WHITELIST veya ALL olarak ayarlanması gerekir. |
|
policy.productPolicy[].autoInstallPolicy |
nested object |
Ürünün otomatik yükleme politikası. | |
policy.productPolicy[].autoInstallPolicy.autoInstallConstraint[] |
list |
Uygulamanın otomatik olarak yüklenmesine ilişkin kısıtlamalar. En fazla bir kısıtlama belirtebilirsiniz. |
|
policy.productPolicy[].autoInstallPolicy.autoInstallConstraint[].chargingStateConstraint |
string |
Şarj durumu kısıtlaması.
Kabul edilebilir değerler şunlardır:
|
|
policy.productPolicy[].autoInstallPolicy.autoInstallConstraint[].deviceIdleStateConstraint |
string |
Cihaz boşta kalma durumu kısıtlaması.
Kabul edilebilir değerler şunlardır:
|
|
policy.productPolicy[].autoInstallPolicy.autoInstallConstraint[].networkTypeConstraint |
string |
Ağ türü kısıtlaması.
Kabul edilebilir değerler şunlardır:
|
|
policy.productPolicy[].autoInstallPolicy.autoInstallMode |
string |
Otomatik yükleme modu. Politika ayarlanmadan bırakılırsa varsayılan olarak "doNotAutoInstall" değerine ayarlanır. Uygulama, ayarlanan bakım aralığından bağımsız olarak otomatik olarak yüklenir.
Kabul edilebilir değerler şunlardır:
|
|
policy.productPolicy[].autoInstallPolicy.autoInstallPriority |
integer |
Yüklemenin, imzalanmamış bir tam sayı olarak önceliği. Sayı ne kadar düşük olursa öncelik o kadar yüksek olur. | |
policy.productPolicy[].autoInstallPolicy.minimumVersionCode |
integer |
Uygulamanın minimum sürümü. Uygulamanın daha düşük 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çiminden öncelikli olur. Bu nedenle, bir kullanıcı cihaz ayarlarında manuel olarak değişiklik yaptığında bu değişiklikler yoksayılır.
Kabul edilebilir 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 şekilde, Android Web Görünümü kullanan özel bir uygulamada kimlik doğrulama gerçekleştirilirken kimlik sağlayıcının kimlik doğrulayıcı uygulaması başlatılır. Authenticator uygulaması, cihazdaki kimlik doğrulama URL'si için zaten 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ı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 |
EMM tarafından tanımlanan yer tutucu dizesi. | |
policy.productPolicy[].managedConfiguration.configurationVariables.variableSet[].userValue |
string |
Kullanıcıya özel yer tutucunun değeri. | |
policy.productPolicy[].managedConfiguration.kind |
string |
Kullanımdan kaldırıldı. |
|
policy.productPolicy[].managedConfiguration.managedProperty[] |
list |
Bu yapılandırmanın yönetilen özellikleri 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 özellik türü bool ise görünür. | |
policy.productPolicy[].managedConfiguration.managedProperty[].valueBundle |
nested object |
Yönetilen mülk grubu: Bu, yalnızca mülk türü paketse gösterilir. | |
policy.productPolicy[].managedConfiguration.managedProperty[].valueBundle.managedProperty[] |
list |
Yönetilen mülklerin listesi. | |
policy.productPolicy[].managedConfiguration.managedProperty[].valueBundleArray[] |
list |
Özellik grubu listesi. Bu liste yalnızca tesis türü paket_dizisi ise gösterilir. | |
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 özellik türü tam sayıysa mevcuttur. | |
policy.productPolicy[].managedConfiguration.managedProperty[].valueString |
string |
Dize değeri: Bu yalnızca özellik türü dize, seçim veya gizli ise görünür. | |
policy.productPolicy[].managedConfiguration.managedProperty[].valueStringArray[] |
list |
Dize değerleri listesi: Bu liste yalnızca özellik türü çoklu seçimse gösterilir. | |
policy.productPolicy[].managedConfiguration.productId |
string |
Yönetilen yapılandırmanın ait olduğu ü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üğü izni verir. Bir ürünün sürüm kanallarının listesine, Products.Get. |
|
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 kaynağından gelmektedir. |
|
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'i önlemek için, görüntülemeden önce verilerdeki HTML'leri kaldırmanızı öneririz. | |
report.appState[].keyedAppState[].key |
string |
Uygulamanın ne için durum sağladığını belirten anahtar. Anahtarın içeriği, uygulamanın geliştiricisi tarafından ayarlanır. XSS'i önlemek için, görüntülemeden önce anahtardaki HTML'yi 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'i önlemek için, iletideki HTML'leri görüntülemeden önce kaldırmanızı öneririz. | |
report.appState[].keyedAppState[].severity |
string |
Uygulama durumunun önem derecesi. Bu alan her zaman mevcut olacaktır.
Kabul edilebilir değerler şunlardır:
|
|
report.appState[].keyedAppState[].stateTimestampMillis |
long |
Uygulamanın, sıfır zamandan bu yana durumu milisaniye cinsinden ayarladığı zamanı gösteren 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 |
Dönemden bu yana 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ı. Şu sayfaya göz atın: android.os.Build.BRAND |
|
sdkVersion |
integer |
API uyumluluk sürümü. |
Yöntemler
- forceReportUpload
- Son raporun oluşturulmasından bu yana cihazdaki uygulama durumunda gerçekleşen tüm değişiklikleri içeren bir rapor yükler. Belirli bir cihaz için bu yöntemi her 24 saatte en fazla 3 kez çağırabilirsiniz.
- al
- Cihazın ayrıntılarını getirir.
- getState
- Bir cihazın Google hizmetlerine erişiminin etkin veya devre dışı olup olmadığını alır. Cihaz durumu yalnızca Google Yönetici Konsolu'nda Android cihazlarda EMM politikalarının zorunlu kılınması etkinleştirilmişse 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ı olacağını belirler. Cihaz durumu yalnızca Google Yönetici Konsolu'nda Android cihazlarda EMM politikalarının zorunlu kılınması etkinleştirilmişse 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 Google Play paketinin yönetilen yapılandırmasındaallowed_accounts
özelliğini ayarlayarak yönetilmeyen hesapların Google Play'e erişmesini engellemeniz gerekir. Google Play'de hesapları kısıtlama konusuna göz atın.