Ö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 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
`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. (logs/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: "`managedDevice`", cihaz sahibi olarak EMM'nin cihaz politikası denetleyicisine (DPC) sahip bir cihaz. "`managedProfile`": DPC tarafından yönetilen bir profilin (DPC, profil sahibidir) yanı sıra DPC'nin kullanamadığı ayrı bir kişisel profilin bulunduğu cihaz. "`containerApp`", artık kullanılmıyor (desteği sonlandırıldı). "`unmanagedProfile`": Yönetilen Google Play'in kullanılmasına izin verilen (alan yöneticisi tarafından, ayrıcalığı etkinleştirmek için Yönetici Konsolu kullanılarak) ancak profilin sahibi bir DPC olmayan bir cihaz. Kabul edilen değerler şunlardır: "`containerApp`" "`managedDevice`" "`managedProfile`" "`unmanagedProfile`"
`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. `choiceToTheUser`, cihazın kullanıcısının uygulama güncelleme politikasını yapılandırmasına olanak tanır. `always`, otomatik güncellemeleri etkinleştirir. `never` otomatik güncellemeleri devre dışı bırakır. `wifiOnly`, otomatik güncellemeleri yalnızca cihaz kablosuz ağa bağlıyken etkinleştirir. Önemli: Uygulama güncelleme politikalarında yapılan değişiklikler, devam eden güncellemeleri etkilemez. Politika değişiklikleri, sonraki uygulama güncellemeleri için geçerli olur. Kabul edilen değerler şunlardır: "`always`" "`choiceToTheUser`" "`never`" "`wifiOnly`"
`policy.deviceReportPolicy`	`string`	Cihazın uygulama durumlarını EMM'ye bildirip bildirmeyeceğini belirtir. Varsayılan değer "deviceReportDisabled"dir. Kabul edilen değerler şunlardır: "`deviceReportDisabled`" "`deviceReportEnabled`"
`policy.maintenanceWindow`	`nested object`	Ön planda çalışan uygulamaların ne zaman güncellenmesi gerektiğini tanımlayan bakım dönemi.
`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ı. Windows, gece yarısına kadar sürebilir.
`policy.policyId`	`string`	Play Store'dan gönderilen uygulama yükleme geri bildirimiyle birlikte iletilecek politikanın tanımlayıcısıdır.
`policy.productAvailabilityPolicy`	`string`	Belirtilen ürünler için cihaza verilen müsaitlik durumu. "all", cihaza onay durumundan bağımsız olarak tüm ürünlere erişim izni verir. "Tümü", "alfa" veya "beta" kanallarının otomatik olarak 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: "`all`" "`whitelist`"
`policy.productPolicy[]`	`list`	Ürün politikalarının listesi. Ürün politikalarının uygulanması için `productAvailabilityPolicy`'ü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ü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: "`chargingNotRequired`" "`chargingRequired`"
`policy.productPolicy[].autoInstallPolicy.autoInstallConstraint[].deviceIdleStateConstraint`	`string`	Cihazın 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. 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: "`autoInstallOnce`" "`doNotAutoInstall`" "`forceAutoInstall`"
`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: "`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, 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`	Tesisi 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 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`	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 ise bulunur.
`policy.productPolicy[].managedConfiguration.managedProperty[].valueStringArray[]`	`list`	Dize değerlerinin listesi. Bu yalnızca mülkün türü çoklu seçimse mevcuttur.
`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 hangi durum için durum bilgisi sağladığını belirten 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 mevcuttur.
`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: "`severityError`" "`severityInfo`"
`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ı. `android.os.Build.BRAND` adresine göz atın.
`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. 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 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.
list: Bir 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 düzgün şekilde uygulandığından emin olmak için Google Play paketinin yönetilen yapılandırmasında allowed_accounts ayarını yaparak yönetilmeyen hesapların Google Play'e erişmesini engellemeniz gerekir. Google Play'de hesapları kısıtlama başlıklı makaleyi inceleyin.