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:
Kabul edilebilir değerler şunlardır:
|
|
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.
Kabul edilen değerler şunlardır:
|
|
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:
|
|
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:
|
|
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. Uygulama, belirlenen bakım döneminden bağımsız olarak otomatik olarak yüklenir.
Kabul edilen değerler şunlardır:
|
|
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:
|
|
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:
|
|
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ındaallowed_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.