REST Resource: enterprises.devices

Kaynak: Cihaz

Bir kuruluşa ait cihaz. Aksi belirtilmedikçe tüm alanlar salt okunurdur ve enterprises.devices.patch tarafından değiştirilemez.

JSON gösterimi
{
  "name": string,
  "userName": string,
  "managementMode": enum (ManagementMode),
  "state": enum (DeviceState),
  "appliedState": enum (DeviceState),
  "policyCompliant": boolean,
  "nonComplianceDetails": [
    {
      object (NonComplianceDetail)
    }
  ],
  "enrollmentTime": string,
  "lastStatusReportTime": string,
  "lastPolicyComplianceReportTime": string,
  "lastPolicySyncTime": string,
  "policyName": string,
  "appliedPolicyName": string,
  "appliedPolicyVersion": string,
  "apiLevel": integer,
  "enrollmentTokenData": string,
  "enrollmentTokenName": string,
  "disabledReason": {
    object (UserFacingMessage)
  },
  "softwareInfo": {
    object (SoftwareInfo)
  },
  "hardwareInfo": {
    object (HardwareInfo)
  },
  "displays": [
    {
      object (Display)
    }
  ],
  "applicationReports": [
    {
      object (ApplicationReport)
    }
  ],
  "previousDeviceNames": [
    string
  ],
  "networkInfo": {
    object (NetworkInfo)
  },
  "memoryInfo": {
    object (MemoryInfo)
  },
  "memoryEvents": [
    {
      object (MemoryEvent)
    }
  ],
  "powerManagementEvents": [
    {
      object (PowerManagementEvent)
    }
  ],
  "hardwareStatusSamples": [
    {
      object (HardwareStatus)
    }
  ],
  "deviceSettings": {
    object (DeviceSettings)
  },
  "user": {
    object (User)
  },
  "systemProperties": {
    string: string,
    ...
  },
  "securityPosture": {
    object (SecurityPosture)
  },
  "ownership": enum (Ownership),
  "commonCriteriaModeInfo": {
    object (CommonCriteriaModeInfo)
  },
  "appliedPasswordPolicies": [
    {
      object (PasswordRequirements)
    }
  ],
  "dpcMigrationInfo": {
    object (DpcMigrationInfo)
  }
}
Alanlar
name

string

Cihazın enterprises/{enterpriseId}/devices/{deviceId} biçimindeki adı.

userName

string

Bu cihazın sahibi olan kullanıcının enterprises/{enterpriseId}/users/{userId} biçimindeki kaynak adı.

managementMode

enum (ManagementMode)

Android Device Policy'nin cihazda aldığı yönetim modunun türü. Bu, hangi politika ayarlarının desteklendiğini etkiler.

state

enum (DeviceState)

Cihaza uygulanacak durum. Bu alan, bir yama isteği ile değiştirilebilir. enterprises.devices.patch çağrılırken, izin verilen tek değerlerin ACTIVE ve DISABLED değerleri olduğunu unutmayın. Cihazı DELETED durumuna girmek için enterprises.devices.delete numaralı telefonu arayın.

appliedState

enum (DeviceState)

Cihaza uygulanan durum.

policyCompliant

boolean

Cihazın, politikasına uygun olup olmadığı.

nonComplianceDetails[]

object (NonComplianceDetail)

Cihazın uyumlu olmadığı politika ayarlarıyla ilgili ayrıntılar.

enrollmentTime

string (Timestamp format)

Cihaz kaydının zamanı.

RFC3339 UTC "Zulu" zaman damgası biçiminde olmalıdır. Örnekler: "2014-10-02T15:01:23Z" ve "2014-10-02T15:01:23.045123456Z".

lastStatusReportTime

string (Timestamp format)

Cihazın en son durum raporu gönderdiği zaman.

RFC3339 UTC "Zulu" zaman damgası biçiminde olmalıdır. Örnekler: "2014-10-02T15:01:23Z" ve "2014-10-02T15:01:23.045123456Z".

lastPolicyComplianceReportTime
(deprecated)

string (Timestamp format)

Kullanımdan kaldırıldı.

RFC3339 UTC "Zulu" zaman damgası biçiminde olmalıdır. Örnekler: "2014-10-02T15:01:23Z" ve "2014-10-02T15:01:23.045123456Z".

lastPolicySyncTime

string (Timestamp format)

Cihazın, politikayı en son ne zaman getirdiği.

RFC3339 UTC "Zulu" zaman damgası biçiminde olmalıdır. Örnekler: "2014-10-02T15:01:23Z" ve "2014-10-02T15:01:23.045123456Z".

policyName

string

Cihaza uygulanan politikanın enterprises/{enterpriseId}/policies/{policyId} biçimindeki adı. Belirtilmezse cihaz kullanıcısı için policyName uygulanır. Bu alan, bir yama isteği ile değiştirilebilir. enterprises.devices.patch çağrısında, policyId eğik çizgi içermediği sürece yalnızca policyId öğesini belirtebilirsiniz. Politika adının geri kalanı tahmin edilmiştir.

appliedPolicyName

string

Cihaza uygulanan politikanın adı.

appliedPolicyVersion

string (int64 format)

Cihaza uygulanan politikanın sürümü.

apiLevel

integer

Cihazda çalışan Android platform sürümünün API düzeyi.

enrollmentTokenData

string

Cihaz, ek verilerin sağlandığı bir kayıt jetonuyla kaydedilmişse bu alan söz konusu verileri içerir.

enrollmentTokenName

string

Cihaz bir kayıt jetonuyla kaydedildiyse bu alanda jetonun adı yer alır.

disabledReason

object (UserFacingMessage)

Cihaz durumu DISABLED ise cihazda, devre dışı bırakılma nedenini belirten isteğe bağlı bir mesaj gösterilir. Bu alan, bir yama isteği ile değiştirilebilir.

softwareInfo

object (SoftwareInfo)

Cihaz yazılımı hakkında ayrıntılı bilgiler. Bu bilgiler yalnızca cihazın politikasında softwareInfoEnabled doğruysa kullanılabilir.

hardwareInfo

object (HardwareInfo)

Cihaz donanımıyla ilgili ayrıntılı bilgiler.

displays[]

object (Display)

Cihazdaki ekranlar hakkında ayrıntılı bilgiler. Bu bilgiler yalnızca cihazın politikasında displayInfoEnabled doğruysa kullanılabilir.

applicationReports[]

object (ApplicationReport)

Cihazda yüklü uygulamalarla ilgili raporlar. Bu bilgiler yalnızca cihazın politikasında applicationReportsEnabled doğru olduğunda kullanılabilir.

previousDeviceNames[]

string

Aynı fiziksel cihaz birden çok kez kaydedildiyse bu alan önceki cihaz adlarını içerir. Seri numarası, aynı fiziksel cihazın daha önce kaydettirilip kaydedilmediğini belirlemek için benzersiz tanımlayıcı olarak kullanılır. Adlar kronolojik sıradadır.

networkInfo

object (NetworkInfo)

Cihaz ağ bilgileri. Bu bilgiler yalnızca cihazın politikasında networkInfoEnabled doğruysa kullanılabilir.

memoryInfo

object (MemoryInfo)

Bellek bilgileri: Cihaz belleği ve depolama alanıyla ilgili bilgileri içerir.

memoryEvents[]

object (MemoryEvent)

Kronolojik sırayla bellek ve depolama alanı ölçümleriyle ilgili etkinlikler. Bu bilgiler yalnızca cihazın politikasında memoryInfoEnabled doğruysa kullanılabilir.

Etkinlikler belirli bir süre boyunca saklanır ve eski etkinlikler silinir.

powerManagementEvents[]

object (PowerManagementEvent)

Cihazdaki güç yönetimi etkinlikleri kronolojik sırayla. Bu bilgiler yalnızca cihazın politikasında powerManagementEventsEnabled doğruysa kullanılabilir.

hardwareStatusSamples[]

object (HardwareStatus)

Kronolojik sırada donanım durumu örnekleri. Bu bilgiler yalnızca cihazın politikasında hardwareStatusEnabled doğruysa kullanılabilir.

deviceSettings

object (DeviceSettings)

Cihaz ayarlarıyla ilgili bilgiler. Bu bilgiler yalnızca cihazın politikasında deviceSettingsEnabled doğruysa kullanılabilir.

user

object (User)

Cihazın sahibi olan kullanıcı.

systemProperties

map (key: string, value: string)

Seçilen sistem özelliklerinin adı ve değeriyle ilgili harita. Bu bilgiler yalnızca cihazın politikasında systemPropertiesEnabled doğruysa kullanılabilir.

"key": value çiftlerinin listesini içeren bir nesne. Örnek: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

securityPosture

object (SecurityPosture)

Cihazın ne kadar güvenli olduğunu yansıtan güvenlik düzeyi değeri.

ownership

enum (Ownership)

Yönetilen cihazın sahipliği.

commonCriteriaModeInfo

object (CommonCriteriaModeInfo)

Ortak Kriterler Modu hakkında bilgi: Bilgi Teknolojisi Güvenlik Değerlendirmesi İçin Ortak Kriterler (CC) belgesinde tanımlanan güvenlik standartları.

Bu bilgi yalnızca cihaz politikasında statusReportingSettings.commonCriteriaModeEnabled adlı cihaz şirkete aitse true ise kullanılabilir.

appliedPasswordPolicies[]

object (PasswordRequirements)

Cihaz için geçerli olan şifre gereksinimleri.

  • Uygulanan şartlar, bazı durumlarda passwordPolicies özelliğinde belirtilenlerden biraz farklı olabilir.
  • fieldPath, passwordPolicies temel alınarak ayarlandı.
dpcMigrationInfo

object (DpcMigrationInfo)

Yalnızca çıkış. Bu cihazın başka bir Cihaz Politikası Denetleyicisi (DPC) tarafından yönetilip taşınıp taşınmadığıyla ilgili bilgiler.

DeviceState

Cihaza uygulanabilecek durumlar.

Sıralamalar
DEVICE_STATE_UNSPECIFIED Bu değere izin verilmiyor.
ACTIVE Cihaz etkin.
DISABLED Cihaz devre dışı.
DELETED Cihaz silindi. Bu durum hiçbir zaman bir API çağrısı tarafından döndürülmez, ancak cihaz silme işlemini onayladığında son durum raporunda kullanılır. Cihaz, API çağrısı aracılığıyla silinirse bu durum Pub/Sub'a yayınlanır. Kullanıcı iş profilini siler veya cihazı sıfırlarsa cihaz, sunucu tarafından tanınmaz.
PROVISIONING Cihazın temel hazırlığı yapılıyor. Yeni kaydedilen cihazlar, bir politika uygulanana kadar bu durumda kalır.
LOST Cihaz kayboldu. Bu durum yalnızca kuruluşa ait cihazlarda kullanılabilir.
PREPARING_FOR_MIGRATION Cihaz, Android Management API'ye taşınmaya hazırlanıyor. Taşıma işleminin devam etmesi için başka bir işlem yapmanız gerekmez.
DEACTIVATED_BY_DEVICE_FINANCE Bu, "kilitlenmiş", finanse edilmiş bir cihaz tarafından gerçekleştirilmesi. Bu, cihazın "kilidi açılana" kadar cihaz işlevlerini sınırlayan belirli politika ayarlarının uygulandığı anlamına gelir. tarafından gerçekleştirilmesi. Cihaz, finans aracısı tarafından geçersiz kılınan ayarlar hariç olmak üzere politika ayarlarını uygulamaya devam eder. Cihaz "kilitlendiğinde", appliedState üzerinde durum DEACTIVATED_BY_DEVICE_FINANCE olarak bildirilir.

NonComplianceDetail

Bir politika ayarıyla uyumsuzluk hakkında ayrıntılı bilgi sağlar.

JSON gösterimi
{
  "settingName": string,
  "nonComplianceReason": enum (NonComplianceReason),
  "packageName": string,
  "fieldPath": string,
  "currentValue": value,
  "installationFailureReason": enum (InstallationFailureReason),
  "specificNonComplianceReason": enum (SpecificNonComplianceReason),
  "specificNonComplianceContext": {
    object (SpecificNonComplianceContext)
  }
}
Alanlar
settingName

string

Politika ayarının adı. Bu, üst düzey bir Policy alanının JSON alan adıdır.

nonComplianceReason

enum (NonComplianceReason)

Cihazın ayara uygun olmamasının nedeni.

packageName

string

Uygunsa hangi uygulamanın uygun olmadığını gösteren paket adı.

fieldPath

string

İç içe yerleştirilmiş alanlara sahip ayarlarda, belirli bir iç içe yerleştirilmiş alanın uyumsuz olması durumunda, sorun teşkil eden alanın tam yolu belirtilir. Yol, JavaScript'te politika JSON alanına başvurulacağı şekilde biçimlendirilir, yani: 1) Nesne türünde alanlarda, alan adının ardından bir nokta gelir ve ardından bir alt alan adı gelir. 2) Dizi türü alanlarda, alan adından sonra parantez içinde dizi dizini gelir. Örneğin, 3. uygulamanın externalData alanındaki url alanında bir sorun olduğunu göstermek için yol applications[2].externalData.url olur.

currentValue

value (Value format)

Politika ayarı uygulanamadıysa ayarın cihazdaki mevcut değeri.

installationFailureReason

enum (InstallationFailureReason)

packageName ayarlanmışsa ve uyumsuzluk nedeni APP_NOT_INSTALLED ya da APP_NOT_UPDATED ise uygulamanın yüklenememesini veya güncellenememesinin ayrıntılı nedeni.

specificNonComplianceReason

enum (SpecificNonComplianceReason)

Cihazın politikayla uyumlu olmamasının, politikaya özel nedeni.

specificNonComplianceContext

object (SpecificNonComplianceContext)

specificNonComplianceReason için ek içerik.

InstallationFailureReason

Bir uygulamanın yüklenmesinin başarısız olmasının nedenleri.

Sıralamalar
INSTALLATION_FAILURE_REASON_UNSPECIFIED Bu değere izin verilmiyor.
INSTALLATION_FAILURE_REASON_UNKNOWN Bilinmeyen bir durum, uygulamanın yüklenmesini engelliyor. Bu durumun olası nedenleri arasında cihazda yeterli depolama alanı bulunmaması, ağ bağlantısının güvenilir olmaması veya yükleme işleminin beklenenden uzun sürmesi yer alır. Yükleme işlemi otomatik olarak yeniden denenecek.
IN_PROGRESS Yükleme işlemi hâlâ devam ediyor.
NOT_FOUND Uygulama Play'de bulunamadı.
NOT_COMPATIBLE_WITH_DEVICE Uygulama cihazla uyumlu değil.
NOT_APPROVED Uygulama yönetici tarafından onaylanmadı.
PERMISSIONS_NOT_ACCEPTED Uygulamada, yönetici tarafından kabul edilmemiş yeni izinler var.
NOT_AVAILABLE_IN_COUNTRY Uygulama, kullanıcının ülkesinde kullanıma sunulmamış olabilir.
NO_LICENSES_REMAINING Kullanıcıya atanabilecek lisans yok.
NOT_ENROLLED Kuruluş artık Managed Google Play'e kayıtlı değil veya yönetici en son Managed Google Play Hizmet Şartları'nı kabul etmedi.
USER_INVALID Kullanıcı artık geçerli değil. Kullanıcı silinmiş veya devre dışı bırakılmış olabilir.
NETWORK_ERROR_UNRELIABLE_CONNECTION

Kullanıcının cihazındaki bir ağ hatası, yüklemenin başarılı olmasını engelledi. Bu durum genellikle cihazın internet bağlantısı zayıf olduğunda, kullanılamadığında veya ağ yapılandırmasında sorun olduğunda yaşanır. Lütfen cihazın, Android Enterprise Network Requirements koşullarını karşılayan bir ağda tam internet bağlantısına erişebildiğinden emin olun. Bu durumda uygulama yükleme veya güncelleme otomatik olarak devam eder.

INSUFFICIENT_STORAGE Kullanıcının cihazında uygulamayı yüklemek için yeterli depolama alanı yok. Bu sorun, cihazdaki depolama alanında yer açarak çözülebilir. Cihaz yeterli depolama alanına sahip olduğunda uygulama yükleme veya güncelleme işlemi otomatik olarak devam eder.

SpecificNonComplianceReason

Cihazın bir politika ayarına uygun olmamasının nedenleri hakkında daha fazla bilgi. İleride sıralamaya yeni değerler eklenebilir.

Sıralamalar
SPECIFIC_NON_COMPLIANCE_REASON_UNSPECIFIED Belirli bir uyumsuzluk nedeni belirtilmedi. specificNonComplianceContext alanındaki alanlar ayarlanmamış.
PASSWORD_POLICIES_USER_CREDENTIALS_CONFIRMATION_REQUIRED Kullanıcının, ekran kilidini girerek kimlik bilgilerini onaylaması gerekir. specificNonComplianceContext alanındaki alanlar ayarlanmamış. nonComplianceReason, USER_ACTION olarak ayarlandı.
PASSWORD_POLICIES_PASSWORD_EXPIRED Cihaz veya profil şifresinin süresi doldu. passwordPoliciesContext ayarlandı. nonComplianceReason, USER_ACTION olarak ayarlandı.
PASSWORD_POLICIES_PASSWORD_NOT_SUFFICIENT Cihaz şifresi, şifre gereksinimlerini karşılamıyor. passwordPoliciesContext ayarlandı. nonComplianceReason, USER_ACTION olarak ayarlandı.
ONC_WIFI_INVALID_VALUE ONC kablosuz yapılandırmasında yanlış bir değer var. fieldPath, hangi alan değerinin yanlış olduğunu belirtir. oncWifiContext ayarlandı. nonComplianceReason, INVALID_VALUE olarak ayarlandı.
ONC_WIFI_API_LEVEL ONC Wi-Fi ayarı, cihazda çalışan Android sürümünün API düzeyinde desteklenmiyor. fieldPath, hangi alan değerinin desteklenmediğini belirtir. oncWifiContext ayarlandı. nonComplianceReason, API_LEVEL olarak ayarlandı.
ONC_WIFI_INVALID_ENTERPRISE_CONFIG Kurumsal kablosuz ağda kök CA veya alan adı eksik. nonComplianceReason, INVALID_VALUE olarak ayarlandı.
ONC_WIFI_USER_SHOULD_REMOVE_NETWORK Kullanıcının yapılandırılmış kablosuz ağı manuel olarak kaldırması gerekiyor. Bu yalnızca kişiye ait cihazlardaki iş profilleri için geçerlidir. nonComplianceReason, USER_ACTION olarak ayarlandı.
ONC_WIFI_KEY_PAIR_ALIAS_NOT_CORRESPONDING_TO_EXISTING_KEY openNetworkConfiguration içindeki ClientCertKeyPairAlias alanında belirtilen anahtar çifti takma adı, cihazda yüklü mevcut bir anahtara karşılık gelmiyor. nonComplianceReason, INVALID_VALUE olarak ayarlandı.

SpecificNonComplianceContext

SpecificNonComplianceReason için ek içerik.

JSON gösterimi
{
  "oncWifiContext": {
    object (OncWifiContext)
  },
  "passwordPoliciesContext": {
    object (PasswordPoliciesContext)
  }
}
Alanlar
oncWifiContext

object (OncWifiContext)

Kablosuz yapılandırmasıyla ilgili uyumsuzluk hakkında ek bilgiler. Bkz. ONC_WIFI_INVALID_VALUE ve ONC_WIFI_API_LEVEL

passwordPoliciesContext

object (PasswordPoliciesContext)

Şifre politikalarıyla ilgili uyumsuzluk hakkında ek bilgiler. PASSWORD_POLICIES_PASSWORD_EXPIRED ve PASSWORD_POLICIES_PASSWORD_NOT_SUFFICIENT hükümlerini inceleyin.

OncWifiContext

Kablosuz yapılandırmasıyla ilgili uyumsuzluk hakkında ek bilgiler.

JSON gösterimi
{
  "wifiGuid": string
}
Alanlar
wifiGuid

string

Uyumlu olmayan kablosuz ağ yapılandırmasının GUID'si.

PasswordPoliciesContext

Şifre politikalarıyla ilgili uyumsuzluk hakkında ek bilgiler.

JSON gösterimi
{
  "passwordPolicyScope": enum (PasswordPolicyScope)
}
Alanlar
passwordPolicyScope

enum (PasswordPolicyScope)

Uyumlu olmayan şifrenin kapsamı.

SoftwareInfo

Cihaz yazılımı hakkında bilgiler.

JSON gösterimi
{
  "androidVersion": string,
  "androidDevicePolicyVersionCode": integer,
  "androidDevicePolicyVersionName": string,
  "androidBuildNumber": string,
  "deviceKernelVersion": string,
  "bootloaderVersion": string,
  "androidBuildTime": string,
  "securityPatchLevel": string,
  "primaryLanguageCode": string,
  "deviceBuildSignature": string,
  "systemUpdateInfo": {
    object (SystemUpdateInfo)
  }
}
Alanlar
androidVersion

string

Kullanıcının görebildiği Android sürümü dizesi. Örneğin, 6.0.1.

androidDevicePolicyVersionCode

integer

Android Device Policy uygulamasının sürüm kodu.

androidDevicePolicyVersionName

string

Kullanıcıya gösterilen Android Device Policy uygulaması sürümü.

androidBuildNumber

string

Kullanıcıya gösterilmesi için tasarlanmış Android derleme kimliği dizesi. Örneğin, shamu-userdebug 6.0.1 MOB30I 2756745 dev-keys.

deviceKernelVersion

string

Çekirdek sürümü, örneğin, 2.6.32.9-g103d848.

bootloaderVersion

string

Sistem bootloader sürüm numarası, ör. 0.6.7

androidBuildTime

string (Timestamp format)

Derleme zamanı.

RFC3339 UTC "Zulu" zaman damgası biçiminde olmalıdır. Örnekler: "2014-10-02T15:01:23Z" ve "2014-10-02T15:01:23.045123456Z".

securityPatchLevel

string

Güvenlik yaması düzeyi, ör. 2016-05-01

primaryLanguageCode

string

Cihazdaki birincil yerel ayar için bir IETF BCP 47 dil kodu.

deviceBuildSignature

string

Sistem paketiyle ilişkilendirilmiş android.content.pm.Signature SHA-256 karması. Bu karma, sistem derlemesinin değiştirilmediğini doğrulamak için kullanılabilir.

systemUpdateInfo

object (SystemUpdateInfo)

Beklemedeki olası bir sistem güncellemesiyle ilgili bilgiler.

SystemUpdateInfo

Beklemedeki olası bir sistem güncellemesiyle ilgili bilgiler.

JSON gösterimi
{
  "updateStatus": enum (UpdateStatus),
  "updateReceivedTime": string
}
Alanlar
updateStatus

enum (UpdateStatus)

Bir güncellemenin durumu: güncellemenin mevcut olup olmadığı ve türü.

updateReceivedTime

string (Timestamp format)

Güncellemenin ilk kullanılabilir olduğu zaman. Sıfır değeri, bu alanın ayarlanmadığını gösterir. Bu alan, yalnızca güncelleme varsa ayarlanır (yani updateStatus, UPDATE_STATUS_UNKNOWN veya UP_TO_DATE değilse).

RFC3339 UTC "Zulu" zaman damgası biçiminde olmalıdır. Örnekler: "2014-10-02T15:01:23Z" ve "2014-10-02T15:01:23.045123456Z".

UpdateStatus

Bir güncellemenin durumu: güncellemenin mevcut olup olmadığı ve türü.

Sıralamalar
UPDATE_STATUS_UNKNOWN Bekleyen bir sistem güncellemesi olup olmadığı bilinmiyor. Bu durum, örneğin, cihaz API düzeyi 26'nın altında olduğunda veya Android Device Policy sürümünün güncel olmadığı durumlarda yaşanır.
UP_TO_DATE Cihazda beklemede olan bir sistem güncellemesi yok.
UNKNOWN_UPDATE_AVAILABLE Bekleyen bir sistem güncellemesi var, ancak türü bilinmiyor.
SECURITY_UPDATE_AVAILABLE Bekleyen güvenlik güncellemesi var.
OS_UPDATE_AVAILABLE Bekleyen bir işletim sistemi güncellemesi var.

HardwareInfo

Cihaz donanımı hakkında bilgiler. Sıcaklık eşikleriyle ilgili alanlar yalnızca cihaz politikasında hardwareStatusEnabled doğru olduğunda kullanılabilir.

JSON gösterimi
{
  "brand": string,
  "hardware": string,
  "deviceBasebandVersion": string,
  "manufacturer": string,
  "serialNumber": string,
  "model": string,
  "batteryShutdownTemperatures": [
    number
  ],
  "batteryThrottlingTemperatures": [
    number
  ],
  "cpuShutdownTemperatures": [
    number
  ],
  "cpuThrottlingTemperatures": [
    number
  ],
  "gpuShutdownTemperatures": [
    number
  ],
  "gpuThrottlingTemperatures": [
    number
  ],
  "skinShutdownTemperatures": [
    number
  ],
  "skinThrottlingTemperatures": [
    number
  ],
  "enterpriseSpecificId": string
}
Alanlar
brand

string

Cihazın markası. Örneğin, Google.

hardware

string

Donanımın adı. Örneğin, Angler.

deviceBasebandVersion

string

Ana bant sürümü. Örneğin, MDM9625_104662.22.05.34p.

manufacturer

string

Üretici. Örneğin, Motorola.

serialNumber

string

Cihazın seri numarası.

model

string

Cihazın modeli. Örneğin, Asus Nexus 7.

batteryShutdownTemperatures[]

number

Cihazdaki her bir pil için pilin kapanması sıcaklık eşikleri Santigrat cinsinden.

batteryThrottlingTemperatures[]

number

Cihazdaki her bir pil için pil kısıtlama sıcaklık eşikleri, Santigrat cinsinden belirtilir.

cpuShutdownTemperatures[]

number

Cihazdaki her CPU için Santigrat cinsinden CPU kapatma sıcaklık eşikleri.

cpuThrottlingTemperatures[]

number

Cihazdaki her CPU için Santigrat cinsinden CPU kısıtlama sıcaklık eşikleri.

gpuShutdownTemperatures[]

number

Cihazdaki her GPU için Santigrat cinsinden GPU kapatma sıcaklık eşikleri.

gpuThrottlingTemperatures[]

number

Cihazdaki her GPU için Santigrat cinsinden GPU kısıtlama sıcaklık eşikleri.

skinShutdownTemperatures[]

number

Cihazın dış görünümünü kapatma sıcaklık eşikleri (Santigrat).

skinThrottlingTemperatures[]

number

Celsius cinsinden cihaz deri kısıtlama sıcaklık eşikleri.

enterpriseSpecificId

string

Yalnızca çıkış. Belirli bir kuruluştaki bir kişiye ait cihazı benzersiz şekilde tanımlayan kimlik. Aynı kuruluşla kaydettirildiğinde aynı fiziksel cihazda bu kimlik, kurulumlarda, hatta fabrika ayarlarına sıfırlama işlemlerinde de aynı kalır. Bu kimlik, Android 12 ve sonraki sürümleri çalıştıran cihazlardaki iş profili bulunan kişisel cihazlarda kullanılabilir.

Görüntülü Reklam Ağı

Cihaz görüntüleme bilgileri.

JSON gösterimi
{
  "name": string,
  "displayId": integer,
  "refreshRate": integer,
  "state": enum (DisplayState),
  "width": integer,
  "height": integer,
  "density": integer
}
Alanlar
name

string

Ekranın adı.

displayId

integer

Benzersiz görünen kimlik.

refreshRate

integer

Görüntünün saniyedeki kare sayısı (kare) cinsinden yenileme hızı.

state

enum (DisplayState)

Ekranın durumu.

width

integer

Piksel cinsinden görüntü genişliği.

height

integer

Yüksekliği piksel cinsinden görüntüleyin.

density

integer

İnç başına nokta olarak ifade edilen görüntü yoğunluğu.

DisplayState

Ekranın durumu.

Sıralamalar
DISPLAY_STATE_UNSPECIFIED Bu değere izin verilmiyor.
OFF Ekran kapalı.
ON Ekran açık.
DOZE Ekran, düşük güç durumunda donuyor
SUSPENDED Ekran, askıya alınmış düşük güç durumunda uykuya geçiyor.

ApplicationReport

Yüklü bir uygulamayla ilgili bildirilen bilgiler.

JSON gösterimi
{
  "packageName": string,
  "versionName": string,
  "versionCode": integer,
  "events": [
    {
      object (ApplicationEvent)
    }
  ],
  "displayName": string,
  "packageSha256Hash": string,
  "signingKeyCertFingerprints": [
    string
  ],
  "installerPackageName": string,
  "applicationSource": enum (ApplicationSource),
  "state": enum (ApplicationState),
  "keyedAppStates": [
    {
      object (KeyedAppState)
    }
  ],
  "userFacingType": enum (UserFacingType)
}
Alanlar
packageName

string

Uygulamanın paket adı.

versionName

string

Kullanıcıya gösterilen uygulama sürümü.

versionCode

integer

Bir sürümün diğerinden daha yeni olup olmadığını belirlemek için kullanılabilecek uygulama sürüm kodu.

events[]

object (ApplicationEvent)

Son 30 saat içinde gerçekleşen uygulama etkinliklerinin listesi.

displayName

string

Uygulamanın görünen adı.

packageSha256Hash

string

Uygulamanın APK dosyasının SHA-256 karması. Bu karma, uygulamanın değiştirilmediğini doğrulamak için kullanılabilir. Karma değerin her baytı, iki basamaklı onaltılık bir sayı olarak temsil edilir.

signingKeyCertFingerprints[]

string

Uygulama paketiyle ilişkilendirilmiş her android.content.pm.Signature öğesinin SHA-1 karması. Karma değerin her bir baytı, iki basamaklı onaltılık bir sayı olarak temsil edilir.

installerPackageName

string

Bu uygulamayı yükleyen uygulamanın paket adı.

applicationSource

enum (ApplicationSource)

Paketin kaynağı.

state

enum (ApplicationState)

Uygulama durumu.

keyedAppStates[]

object (KeyedAppState)

Uygulama tarafından bildirilen anahtarlı uygulama durumlarının listesi.

userFacingType

enum (UserFacingType)

Uygulamanın kullanıcılara yönelik olup olmadığı.

ApplicationEvent

Uygulamayla ilgili bir etkinlik.

JSON gösterimi
{
  "eventType": enum (ApplicationEventType),
  "createTime": string
}
Alanlar
eventType

enum (ApplicationEventType)

Uygulama etkinliği türü.

createTime

string (Timestamp format)

Etkinliğin oluşturulma zamanı.

RFC3339 UTC "Zulu" zaman damgası biçiminde olmalıdır. Örnekler: "2014-10-02T15:01:23Z" ve "2014-10-02T15:01:23.045123456Z".

ApplicationEventType

Uygulamayla ilgili bir etkinlik türü.

Sıralamalar
APPLICATION_EVENT_TYPE_UNSPECIFIED Bu değere izin verilmiyor.
INSTALLED Uygulama yüklendi.
CHANGED Uygulama değiştirildi (örneğin, bir bileşen etkinleştirildi veya devre dışı bırakıldı).
DATA_CLEARED Uygulama verileri temizlendi.
REMOVED Uygulama kaldırıldı.
REPLACED Uygulamanın, eski sürümün yerini alan yeni bir sürümü yüklendi.
RESTARTED Uygulama yeniden başlatıldı.
PINNED Uygulama ön plana sabitlendi.
UNPINNED Uygulamanın sabitlemesi kaldırıldı.

ApplicationSource

Uygulamayı sağlayan kaynak.

Sıralamalar
APPLICATION_SOURCE_UNSPECIFIED Uygulama, belirtilmemiş bir kaynaktan başka cihazdan yüklenmiştir.
SYSTEM_APP_FACTORY_VERSION Bu, cihazın fabrika görüntüsünden alınan bir sistem uygulamasıdır.
SYSTEM_APP_UPDATED_VERSION Bu, güncellenmiş bir sistem uygulamasıdır.
INSTALLED_FROM_PLAY_STORE Uygulama, Google Play Store'dan yüklenmiştir.

ApplicationState

Mevcut yükleme durumu.

Sıralamalar
APPLICATION_STATE_UNSPECIFIED Uygulama durumu belirtilmedi
REMOVED Uygulama cihazdan kaldırıldı
INSTALLED Uygulama cihazda yüklü

KeyedAppState

Uygulama tarafından bildirilen anahtarlı uygulama durumu.

JSON gösterimi
{
  "key": string,
  "severity": enum (Severity),
  "message": string,
  "data": string,
  "createTime": string,
  "lastUpdateTime": string
}
Alanlar
key

string

Uygulama durumunun anahtarı. Uygulamanın ne için bilgi sağladığı konusunda bir referans noktası işlevi görür. Örneğin, yönetilen yapılandırma geri bildirimi sağlarken bu anahtar, yönetilen yapılandırma anahtarı olabilir.

severity

enum (Severity)

Uygulama durumunun önem derecesi.

message

string

İsteğe bağlı olarak, uygulama durumunu açıklayan serbest biçimli bir mesaj dizesi. Durum, belirli bir değer (ör. yönetilen bir yapılandırma değeri) tarafından tetiklendiyse mesaja eklenmelidir.

data

string

İsteğe bağlı olarak, EMM tarafından okunacak, makine tarafından okunabilen bir değer. Örneğin, yöneticinin EMM konsolunda sorgulamayı seçebileceği değerleri (ör. "Battery_warning verisi < 10" ise bana bildir") ayarlama.

createTime

string (Timestamp format)

Cihazdaki uygulama durumunun oluşturulma zamanı.

RFC3339 UTC "Zulu" zaman damgası biçiminde olmalıdır. Örnekler: "2014-10-02T15:01:23Z" ve "2014-10-02T15:01:23.045123456Z".

lastUpdateTime

string (Timestamp format)

Uygulama durumunun en son güncellendiği zaman.

RFC3339 UTC "Zulu" zaman damgası biçiminde olmalıdır. Örnekler: "2014-10-02T15:01:23Z" ve "2014-10-02T15:01:23.045123456Z".

Önem derecesi

Uygulama durumunun önem derecesi.

Sıralamalar
SEVERITY_UNSPECIFIED Belirtilmemiş önem düzeyi.
INFO Bilgilerin önem düzeyi.
ERROR Hata önem düzeyi. Bu yalnızca, bir yönetim kuruluşunun düzeltmek üzere işlem yapması gereken gerçek hata durumları için ayarlanmalıdır.

UserFacingType

Uygulamanın kullanıcılara yönelik olup olmadığı.

Sıralamalar
USER_FACING_TYPE_UNSPECIFIED Uygulamanın kullanıcıya yönelik türü belirtilmedi.
NOT_USER_FACING Uygulama kullanıcıya yönelik değil.
USER_FACING Uygulama kullanıcılara yönelik.

NetworkInfo

Cihaz ağ bilgileri'ne dokunun.

JSON gösterimi
{
  "imei": string,
  "meid": string,
  "wifiMacAddress": string,
  "networkOperatorName": string,
  "telephonyInfos": [
    {
      object (TelephonyInfo)
    }
  ]
}
Alanlar
imei

string

GSM cihazının IMEI numarası. Örneğin, A1000031212.

meid

string

CDMA cihazının MEID numarası. Örneğin, A00000292788E1.

wifiMacAddress

string

Cihazın Wi-Fi MAC adresi. Örneğin, 7c:11:11:11:11:11.

networkOperatorName
(deprecated)

string

Kayıtlı mevcut operatörün alfabetik adı. Örneğin, Vodafone.

telephonyInfos[]

object (TelephonyInfo)

Cihazdaki SIM kartlarla ilişkili telefon bilgilerini sağlar. Yalnızca Android API düzeyi 23'ten itibaren tümüyle yönetilen cihazlarda desteklenir.

TelephonyInfo

Cihazdaki belirli bir SIM kartla ilişkili telefon bilgileri. Yalnızca Android API düzeyi 23'ten itibaren tümüyle yönetilen cihazlarda desteklenir.

JSON gösterimi
{
  "phoneNumber": string,
  "carrierName": string
}
Alanlar
phoneNumber

string

Bu SIM kartla ilişkilendirilmiş telefon numarası.

carrierName

string

Bu SIM kartla ilişkilendirilmiş operatörün adı.

MemoryInfo

Cihaz belleği ve depolama alanı ile ilgili bilgiler.

JSON gösterimi
{
  "totalRam": string,
  "totalInternalStorage": string
}
Alanlar
totalRam

string (int64 format)

Cihazdaki toplam RAM (bayt cinsinden).

totalInternalStorage

string (int64 format)

Cihazdaki bayt cinsinden toplam dahili depolama alanı.

MemoryEvent

Bellek ve depolama alanı ölçümleriyle ilgili bir etkinlik.

Yeni ve eski etkinlikleri birbirinden ayırt etmek için createTime alanını kullanmanızı öneririz.

JSON gösterimi
{
  "eventType": enum (MemoryEventType),
  "createTime": string,
  "byteCount": string
}
Alanlar
eventType

enum (MemoryEventType)

Etkinlik türü.

createTime

string (Timestamp format)

Etkinliğin oluşturulma zamanı.

RFC3339 UTC "Zulu" zaman damgası biçiminde olmalıdır. Örnekler: "2014-10-02T15:01:23Z" ve "2014-10-02T15:01:23.045123456Z".

byteCount

string (int64 format)

Ortamdaki ücretsiz bayt sayısı veya EXTERNAL_STORAGE_DETECTED için depolama ortamının bayt cinsinden toplam kapasitesi.

MemoryEventType

Etkinliğin türü.

Sıralamalar
MEMORY_EVENT_TYPE_UNSPECIFIED Belirtilmedi. Bu türde etkinlik yok.
RAM_MEASURED RAM cinsinden boş alan ölçüldü.
INTERNAL_STORAGE_MEASURED Dahili depolama alanındaki boş alan ölçüldü.
EXTERNAL_STORAGE_DETECTED Yeni bir harici depolama ortamı algılandı. Raporlanan bayt sayısı, depolama ortamının toplam kapasitesidir.
EXTERNAL_STORAGE_REMOVED Harici depolama ortamı kaldırıldı. Raporlanan bayt sayısı sıfır.
EXTERNAL_STORAGE_MEASURED Harici bir depolama ortamındaki boş alan ölçüldü.

PowerManagementEvent

Güç yönetimi etkinliği.

JSON gösterimi
{
  "eventType": enum (PowerManagementEventType),
  "createTime": string,
  "batteryLevel": number
}
Alanlar
eventType

enum (PowerManagementEventType)

Etkinlik türü.

createTime

string (Timestamp format)

Etkinliğin oluşturulma zamanı.

RFC3339 UTC "Zulu" zaman damgası biçiminde olmalıdır. Örnekler: "2014-10-02T15:01:23Z" ve "2014-10-02T15:01:23.045123456Z".

batteryLevel

number

BATTERY_LEVEL_COLLECTED etkinlikleri için yüzde olarak pil seviyesi.

PowerManagementEventType

Etkinliğin türü.

Sıralamalar
POWER_MANAGEMENT_EVENT_TYPE_UNSPECIFIED Belirtilmedi. Bu türde etkinlik yok.
BATTERY_LEVEL_COLLECTED Pil seviyesi ölçüldü.
POWER_CONNECTED Cihaz şarj olmaya başladı.
POWER_DISCONNECTED Cihaz şarjı durdu.
BATTERY_LOW Cihaz, düşük güç moduna girdi.
BATTERY_OKAY Cihaz, düşük güç modundan çıktı.
BOOT_COMPLETED Cihaz başlatıldı.
SHUTDOWN Cihaz kapandı.

HardwareStatus

Donanım durumu. Donanım sağlığını belirlemek için sıcaklıklar, hardwareInfo içindeki sıcaklık eşikleriyle karşılaştırılabilir.

JSON gösterimi
{
  "createTime": string,
  "batteryTemperatures": [
    number
  ],
  "cpuTemperatures": [
    number
  ],
  "gpuTemperatures": [
    number
  ],
  "skinTemperatures": [
    number
  ],
  "fanSpeeds": [
    number
  ],
  "cpuUsages": [
    number
  ]
}
Alanlar
createTime

string (Timestamp format)

Ölçümlerin yapıldığı zaman.

RFC3339 UTC "Zulu" zaman damgası biçiminde olmalıdır. Örnekler: "2014-10-02T15:01:23Z" ve "2014-10-02T15:01:23.045123456Z".

batteryTemperatures[]

number

Cihazdaki her pil için geçerli pil sıcaklıkları Celsius cinsindendir.

cpuTemperatures[]

number

Cihazdaki her CPU için mevcut CPU sıcaklıkları Celsius cinsindendir.

gpuTemperatures[]

number

Cihazdaki her GPU için Santigrat cinsinden mevcut GPU sıcaklıkları.

skinTemperatures[]

number

Celsius cinsinden mevcut cihaz deri sıcaklıkları.

fanSpeeds[]

number

Cihazdaki her fan için BGBG cinsinden fan hızı. Boş dizi, sistemde fan olmadığı veya fan hızının desteklenmediği anlamına gelir.

cpuUsages[]

number

Cihazda mevcut olan her çekirdek için yüzde cinsinden CPU kullanımları. Takılmamış her çekirdek için kullanım 0'dır. Boş dizi, CPU kullanımının sistemde desteklenmediği anlamına gelir.

DeviceSettings

Cihazdaki güvenlikle ilgili cihaz ayarları hakkında bilgiler.

JSON gösterimi
{
  "isDeviceSecure": boolean,
  "unknownSourcesEnabled": boolean,
  "developmentSettingsEnabled": boolean,
  "adbEnabled": boolean,
  "isEncrypted": boolean,
  "encryptionStatus": enum (EncryptionStatus),
  "verifyAppsEnabled": boolean
}
Alanlar
isDeviceSecure

boolean

Cihazın PIN/şifre ile güvenliğinin sağlanıp sağlanmadığı.

unknownSourcesEnabled

boolean

Bilinmeyen kaynaklardan uygulama yüklemenin etkin olup olmadığı.

developmentSettingsEnabled

boolean

Cihazda geliştirici modunun etkin olup olmadığı.

adbEnabled

boolean

Cihazda ADB'nin etkin olup olmadığı.

isEncrypted

boolean

Depolama alanı şifrelemesinin etkinleştirilip etkinleştirilmediği.

encryptionStatus

enum (EncryptionStatus)

DevicePolicyManager'dan alınan şifreleme durumu.

verifyAppsEnabled

boolean

Google Play Protect doğrulamasının cihazda zorunlu kılınıp kılınmadığı.

EncryptionStatus

Cihazın şifreleme durumu.

Sıralamalar
ENCRYPTION_STATUS_UNSPECIFIED Belirtilmedi. Hiçbir cihaz bu türde olmamalıdır.
UNSUPPORTED Cihaz, şifrelemeyi desteklemiyor.
INACTIVE Şifreleme cihaz tarafından destekleniyor, ancak şu anda etkin değil.
ACTIVATING Şifreleme şu anda etkin değil, ancak şu anda etkinleştiriliyor.
ACTIVE Şifreleme etkin.
ACTIVE_DEFAULT_KEY Şifreleme etkin ancak kullanıcı tarafından bir şifreleme anahtarı ayarlanmamış.
ACTIVE_PER_USER Şifreleme etkin ve şifreleme anahtarı kullanıcı profiline bağlı.

SecurityPosture

Cihazın, geçerli cihaz durumuna ve uygulanan politikalara göre belirlenen güvenlik durumu.

JSON gösterimi
{
  "devicePosture": enum (DevicePosture),
  "postureDetails": [
    {
      object (PostureDetail)
    }
  ]
}
Alanlar
devicePosture

enum (DevicePosture)

Cihazın güvenlik durumu değeri.

postureDetails[]

object (PostureDetail)

Cihazın güvenlik durumu ile ilgili ek bilgiler.

DevicePosture

Yönetim kapsamındaki bir cihazın olası güvenlik durumu değerleri.

Sıralamalar
POSTURE_UNSPECIFIED Belirtilmedi. Bu duruş değeri için duruş ayrıntısı yok.
SECURE Bu cihaz güvenli.
AT_RISK Bu cihaz, şirket verileriyle kullanılması önerilenden daha kötü amaçlı kişilere karşı daha savunmasız olabilir.
POTENTIALLY_COMPROMISED Bu cihazın güvenliği ihlal edilebilir ve yetkisiz kişiler şirket verilerine erişebilir.

PostureDetail

Cihazın güvenlik durumu ile ilgili ek bilgiler.

JSON gösterimi
{
  "securityRisk": enum (SecurityRisk),
  "advice": [
    {
      object (UserFacingMessage)
    }
  ]
}
Alanlar
securityRisk

enum (SecurityRisk)

Cihazın güvenlik düzeyini olumsuz etkileyen belirli bir güvenlik riski.

advice[]

object (UserFacingMessage)

Bu güvenlik riskini azaltmak ve cihazın güvenlik önlemlerini iyileştirmek için yöneticiye yönelik öneriler.

SecurityRisk

Cihazın en güvenli durumda olmamasına yol açan risk.

Sıralamalar
SECURITY_RISK_UNSPECIFIED Belirtilmedi.
UNKNOWN_OS Play Integrity API, cihazın bilinmeyen bir işletim sistemi çalıştırdığını tespit etti (basicIntegrity kontrolü başarılı olur, ctsProfileMatch başarısız olur).
COMPROMISED_OS Play Integrity API, cihazda güvenliği ihlal edilmiş bir işletim sistemi çalıştırdığını tespit etti (basicIntegrity denetimi başarısız oluyor).
HARDWARE_BACKED_EVALUATION_FAILED Cihaz bütünlüğü alanında MEETS_STRONG_INTEGRITY etiketi görünmüyorsa Play Integrity API, cihazın sistem bütünlüğü konusunda güçlü bir garantiye sahip olmadığını algılar.

CommonCriteriaModeInfo

Ortak Kriterler Modu hakkında bilgi: Bilgi Teknolojisi Güvenlik Değerlendirmesi İçin Ortak Kriterler (CC) belgesinde tanımlanan güvenlik standartları.

Bu bilgiler yalnızca, cihazın politikasında statusReportingSettings.commonCriteriaModeEnabled true değerine sahipse kullanılabilir.

JSON gösterimi
{
  "commonCriteriaModeStatus": enum (CommonCriteriaModeStatus)
}
Alanlar
commonCriteriaModeStatus

enum (CommonCriteriaModeStatus)

Ortak Kriterler Modu'nun etkinleştirilip etkinleştirilmediği.

CommonCriteriaModeStatus

Ortak Kriterler Modu'nun etkinleştirilip etkinleştirilmediği.

Sıralamalar
COMMON_CRITERIA_MODE_STATUS_UNKNOWN Durum bilinmiyor.
COMMON_CRITERIA_MODE_DISABLED Ortak Kriterler Modu şu anda devre dışı.
COMMON_CRITERIA_MODE_ENABLED Ortak Kriterler Modu şu anda etkin.

DpcMigrationInfo

Bu cihazın başka bir Cihaz Politikası Denetleyicisi (DPC) tarafından yönetilip taşınıp taşınmadığıyla ilgili bilgiler.

JSON gösterimi
{
  "previousDpc": string,
  "additionalData": string
}
Alanlar
previousDpc

string

Yalnızca çıkış. Bu cihaz başka bir DPC'den taşındıysa paket adıdır. Aksi takdirde doldurulmaz.

additionalData

string

Yalnızca çıkış. Bu cihaz başka bir DPC'den taşındıysa taşıma jetonunun additionalData alanı burada doldurulur.

Yöntemler

delete

Cihaz silinir.

get

Bir cihaz alır.

issueCommand

Bir cihaza komut gönderir.

list

Belirli bir kuruluşa ait cihazları listeler.

patch

Bir cihazı günceller.