MCP Tools Reference: Android Device Management MCP Server

Araç: list_devices

Belirli bir kuruluşa ait cihazları listeler. Üst alanda kuruluş kimliği (ör. enterprises/{enterpriseId}) gereklidir.

Aşağıdaki örnekte, curl kullanılarak list_devices MCP aracının nasıl çağrılacağı gösterilmektedir.

Curl Request 
                  
curl --location 'https://androidmanagement.googleapis.com/mcp' \
--header 'content-type: application/json' \
--header 'accept: application/json, text/event-stream' \
--data '{
  "method": "tools/call",
  "params": {
    "name": "list_devices",
    "arguments": {
      // provide these details according to the tool's MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

Giriş Şeması

Belirli bir kuruluş için cihazları listeleme isteği.

ListDevicesRequest

JSON gösterimi 
{
  "parent": string,
  "pageSize": integer,
  "pageToken": string
}
Alanlar
parent

string

İşletmenin adı enterprises/{enterpriseId} biçiminde.
pageSize

integer

İstenen sayfa boyutu. Belirtilmemesi halinde en fazla 10 cihaz döndürülür. Maksimum değer 100'dür. 100'ün üzerindeki değerler 100'e zorlanır. Sınırlar zaman içinde değişebilir.
pageToken

string

Sunucu tarafından döndürülen sonuç sayfasını tanımlayan bir jeton.

Çıkış Şeması

Belirli bir işletme için cihazları listeleme isteğine verilen yanıt.

ListDevicesResponse

JSON gösterimi 
{
  "devices": [
    {
      object (Device)
    }
  ],
  "nextPageToken": string
}
Alanlar
devices[]

object (Device)

Cihazların listesi.
nextPageToken

string

Daha fazla sonuç varsa sonuçların bir sonraki sayfasını almak için kullanılan jeton.

Cihaz

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)
  },
  "defaultApplicationInfo": [
    {
      object (DefaultApplicationInfo)
    }
  ]
}
Alanlar
name

string

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

string

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

enum (ManagementMode)

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

enum (DeviceState)

Cihaza uygulanacak durum. Bu alan, yama isteğiyle değiştirilebilir. enterprises.devices.patch çağrılırken yalnızca ACTIVE ve DISABLED değerlerine izin verildiğini unutmayın. Cihazı DELETED durumuna getirmek için enterprises.devices.delete'ı arayın.
appliedState

enum (DeviceState)

Cihaza şu anda uygulanan durum.
policyCompliant

boolean

Cihazın politikasına uygun olup olmadığı.
nonComplianceDetails[]

object (NonComplianceDetail)

Cihazın uymadığı politika ayarlarıyla ilgili ayrıntılar.
enrollmentTime

string (Timestamp format)

Cihaz kaydının yapıldığı zaman.

Zaman damgasında RFC 3339 kullanılır. Yani oluşturulan çıkış her zaman Z ile normalleştirilir ve 0, 3, 6 veya 9 kesirli basamak kullanılır. "Z" dışındaki zaman farkları da kabul edilir. Örnekler: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" veya "2014-10-02T15:01:23+05:30".
lastStatusReportTime

string (Timestamp format)

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

Zaman damgasında RFC 3339 kullanılır. Yani oluşturulan çıkış her zaman Z ile normalleştirilir ve 0, 3, 6 veya 9 kesirli basamak kullanılır. "Z" dışındaki zaman farkları da kabul edilir. Örnekler: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" veya "2014-10-02T15:01:23+05:30".
lastPolicyComplianceReportTime
(deprecated)

string (Timestamp format)

Kullanımdan kaldırıldı.

Zaman damgasında RFC 3339 kullanılır. Yani oluşturulan çıkış her zaman Z ile normalleştirilir ve 0, 3, 6 veya 9 kesirli basamak kullanılır. "Z" dışındaki zaman farkları da kabul edilir. Örnekler: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" veya "2014-10-02T15:01:23+05:30".
lastPolicySyncTime

string (Timestamp format)

Cihazın politikasını en son aldığı zaman.

Zaman damgasında RFC 3339 kullanılır. Yani oluşturulan çıkış her zaman Z ile normalleştirilir ve 0, 3, 6 veya 9 kesirli basamak kullanılır. "Z" dışındaki zaman farkları da kabul edilir. Örnekler: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" veya "2014-10-02T15:01:23+05:30".
policyName

string

Cihaza uygulanan politikanın adı, enterprises/{enterpriseId}/policies/{policyId} biçiminde. Belirtilmezse cihaz kullanıcısının policy_name uygulanır. Bu alan, yama isteğiyle değiştirilebilir. policyId eğik çizgi içermediği sürece enterprises.devices.patch'u ararken yalnızca policyId'u belirtebilirsiniz. Politika adının geri kalanı tahmin edilir.
appliedPolicyName

string

Cihaza şu anda uygulanan politikanın adı.
appliedPolicyVersion

string (int64 format)

Cihaza şu anda uygulanan politika sürümü.
apiLevel

integer

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

string

Cihaz, ek veriler sağlanarak kayıt jetonuyla kaydedildiyse bu alan, söz konusu verileri içerir.
enrollmentTokenName

string

Cihaz, kayıt jetonuyla kaydedilmişse bu alan jetonun adını içerir.
disabledReason

object (UserFacingMessage)

Cihaz durumu DISABLED ise cihazda gösterilen ve cihazın devre dışı bırakılma nedenini belirten isteğe bağlı bir mesaj. Bu alan, yama isteğiyle 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ı hakkında ayrıntılı bilgiler.
displays[]

object (Display)

Cihazdaki ekranlarla ilgili 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 application_reports_enabled doğru olduğunda kullanılabilir.
previousDeviceNames[]

string

Aynı fiziksel cihaz birden çok kez kaydedildiyse bu alanda cihazın önceki adları yer alır. Seri numarası, aynı fiziksel cihazın daha önce kaydedilip kaydedilmediğini belirlemek için benzersiz tanımlayıcı olarak kullanılır. Adlar kronolojik sırayla gösterilir.
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ı ile ilgili bilgileri içerir.
memoryEvents[]

object (MemoryEvent)

Bellek ve depolama ölçümleriyle ilgili etkinlikler kronolojik sırayla gösterilir. 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ıraya göre donanım durumu örnekleri. Bu bilgiler yalnızca cihazın politikasında hardwareStatusEnabled doğruysa kullanılabilir.
deviceSettings

object (DeviceSettings)

Cihaz ayarları bilgileri 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)

Cihazla ilgili seçili sistem özelliklerinin ad ve değer haritası. 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 durumu değeri.
ownership

enum (Ownership)

Yönetilen cihazın sahipliği.
commonCriteriaModeInfo

object (CommonCriteriaModeInfo)

Ortak Kriterler Modu hakkında bilgiler: Bilgi Teknolojisi Güvenliği Değerlendirmesi için Ortak Kriterler'de (CC) tanımlanan güvenlik standartları.

Bu bilgiler yalnızca cihazın politikası statusReportingSettings.commonCriteriaModeEnabled ise ve cihaz şirkete aitse kullanılabilir.true
appliedPasswordPolicies[]

object (PasswordRequirements)

Cihaza şu anda uygulanan şifre koşulları.

  • Bu alanın nedeni, uygulanan koşulların bazı durumlarda passwordPolicies içinde belirtilenlerden biraz farklı olabilmesidir.
  • Bu alanın, şifreye uygunluk hakkında bilgi sağlamadığını unutmayın. Uygunluk dışı durumlarla ilgili bilgiler için nonComplianceDetails başlıklı makaleyi inceleyin.
  • NonComplianceDetail.fieldPath, bu alana göre değil, passwordPolicies'ye göre ayarlanır.
dpcMigrationInfo

object (DpcMigrationInfo)

Yalnızca çıkış. Bu cihazın başka bir cihaz politikası denetleyicisi (DPC) tarafından yönetilirken taşınıp taşınmadığıyla ilgili bilgiler.
defaultApplicationInfo[]

object (DefaultApplicationInfo)

Yalnızca çıkış. DefaultApplicationType için varsayılan uygulama bilgileri. Bu bilgiler yalnızca cihazın politikasında defaultApplicationInfoReportingEnabled doğruysa kullanılabilir. Android 16 ve sonraki sürümlerde kullanılabilir.

Tüm uygulama türleri, tamamen yönetilen cihazlarda raporlanır. Şirkete ait cihazlarda iş profili ve kişisel cihazlardaki iş profilleri için DEFAULT_BROWSER, DEFAULT_CALL_REDIRECTION, DEFAULT_CALL_SCREENING ve DEFAULT_DIALER türleri raporlanır. DEFAULT_WALLET, iş profili olan şirkete ait cihazlar için de bildirilir ancak yalnızca iş profili bilgilerini içerir.

NonComplianceDetail

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 Policy alanının JSON alan adıdır.
nonComplianceReason

enum (NonComplianceReason)

Cihazın ayara uygun olmama nedeni.
packageName

string

Varsa hangi uygulamanın uyumlu olmadığını belirten paket adı.
fieldPath

string

İç içe yerleştirilmiş alanlara sahip ayarlarda, belirli bir iç içe yerleştirilmiş alan uyumlu değilse bu alan, ihlalde bulunan alanın tam yolunu belirtir. Yol, politika JSON alanına JavaScript'te referans verilecek şekilde biçimlendirilir. Yani: 1) Nesne türündeki alanlarda, alan adından sonra nokta ve ardından alt alan adı gelir. 2) Dizi türündeki alanlarda, alan adından sonra köşeli parantez içinde dizi dizini gelir. Örneğin, 3. uygulamadaki externalData alanında url alanıyla ilgili bir sorun olduğunu belirtmek için yol applications[2].externalData.url olur.
currentValue

value (Value format)

Politika ayarı uygulanamadıysa cihazdaki ayarın geçerli değeri.
installationFailureReason

enum (InstallationFailureReason)

package_name ayarlanmışsa ve uygunsuzluk nedeni APP_NOT_INSTALLED veya APP_NOT_UPDATED ise uygulamanın yüklenememesinin ya da güncellenememesinin ayrıntılı nedeni.
specificNonComplianceReason

enum (SpecificNonComplianceReason)

Cihazın, ayarla uyumlu olmamasının politikaya özgü nedeni.
specificNonComplianceContext

object (SpecificNonComplianceContext)

specific_non_compliance_reason için ek bağlam bilgisi.

Değer

JSON gösterimi 
{

  // Union field kind can be only one of the following:
  "nullValue": null,
  "numberValue": number,
  "stringValue": string,
  "boolValue": boolean,
  "structValue": {
    object
  },
  "listValue": array
  // End of list of possible types for union field kind.
}
Alanlar
kind birleşik alanı. Değer türü. kind aşağıdakilerden yalnızca biri olabilir:
nullValue

null

Boş değeri temsil eder.
numberValue

number

Çift değeri temsil eder.
stringValue

string

Bir dize değerini temsil eder.
boolValue

boolean

Boole değerini gösterir.
structValue

object (Struct format)

Yapılandırılmış bir değeri temsil eder.
listValue

array (ListValue format)

Tekrarlanan Value öğesini temsil eder.

Struct

JSON gösterimi 
{
  "fields": {
    string: value,
    ...
  }
}
Alanlar
fields

map (key: string, value: value (Value format))

Dinamik olarak türü belirlenmiş değerlerin sırasız haritası.

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

FieldsEntry

JSON gösterimi 
{
  "key": string,
  "value": value
}
Alanlar
key

string
value

value (Value format)

ListValue

JSON gösterimi 
{
  "values": [
    value
  ]
}
Alanlar
values[]

value (Value format)

Dinamik olarak türü belirlenen değerlerin tekrar eden alanı.

SpecificNonComplianceContext

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

object (OncWifiContext)

Kablosuz yapılandırmayla ilgili olmayan uygunsuzluklar için ek bağlam. ONC_WIFI_INVALID_VALUE ve ONC_WIFI_API_LEVEL hükümlerini inceleyin.
passwordPoliciesContext

object (PasswordPoliciesContext)

Şifre politikalarına uyulmamasıyla ilgili ek bağlam. PASSWORD_POLICIES_PASSWORD_EXPIRED ve PASSWORD_POLICIES_PASSWORD_NOT_SUFFICIENT hükümlerini inceleyin.
defaultApplicationContext

object (DefaultApplicationContext)

Yalnızca çıkış. Varsayılan uygulama ayarlarıyla ilgili uyumsuzluk için ek bağlam. Şu sayfaya göz atın: DEFAULT_APPLICATION_SETTING_FAILED_FOR_SCOPE.

OncWifiContext

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

string

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

PasswordPoliciesContext

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

enum (PasswordPolicyScope)

Uygun olmayan şifrenin kapsamı.

DefaultApplicationContext

JSON gösterimi 
{
  "defaultApplicationScope": enum (DefaultApplicationScope)
}
Alanlar
defaultApplicationScope

enum (DefaultApplicationScope)

Yalnızca çıkış. Uygun olmayan varsayılan uygulama ayarının kapsamı.

Zaman damgası

JSON gösterimi 
{
  "seconds": string,
  "nanos": integer
}
Alanlar
seconds

string (int64 format)

Unix sıfır zamanı 1970-01-01T00:00:00Z'den itibaren UTC zamanının saniyelerini gösterir. -62135596800 ile 253402300799 arasında olmalıdır (0001-01-01T00:00:00Z ile 9999-12-31T23:59:59Z'ye karşılık gelir).
nanos

integer

Nanosaniye çözünürlüğünde, negatif olmayan saniyenin kesirleri. Bu alan, sürenin nanosaniye kısmıdır ve saniyenin alternatifi değildir. Kesirli negatif saniye değerleri, zaman içinde ileriye doğru sayılan negatif olmayan nanos değerlerine sahip olmalıdır. 0 ile 999.999.999 arasında olmalıdır (bu değerler dahil).

UserFacingMessage

JSON gösterimi 
{
  "localizedMessages": {
    string: string,
    ...
  },
  "defaultMessage": string
}
Alanlar
localizedMessages

map (key: string, value: string)

Yerel ayarın, en-US, es-ES veya fr gibi iyi biçimlendirilmiş bir BCP 47 dil kodu olduğu <locale, message> çiftlerini içeren bir harita.

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

string

Yerelleştirilmiş mesaj belirtilmediğinde veya kullanıcının yerel ayarı yerelleştirilmiş mesajlardan herhangi biriyle eşleşmediğinde gösterilen varsayılan mesaj. Yerelleştirilmiş mesajlar sağlanıyorsa varsayılan bir mesaj sağlanmalıdır.

LocalizedMessagesEntry

JSON gösterimi 
{
  "key": string,
  "value": string
}
Alanlar
key

string
value

string

SoftwareInfo

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ı tarafından görülebilen Android sürümü dizesi. Örneğin, 6.0.1.
androidDevicePolicyVersionCode

integer

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

string

Android Device Policy uygulamasının kullanıcıya gösterilen sürümü.
androidBuildNumber

string

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

string

Çekirdek sürümü (ör. 2.6.32.9-g103d848)
bootloaderVersion

string

Sistemin önyükleyici sürüm numarası (ör. 0.6.7).
androidBuildTime

string (Timestamp format)

Derleme süresi.

Zaman damgasında RFC 3339 kullanılır. Yani oluşturulan çıkış her zaman Z ile normalleştirilir ve 0, 3, 6 veya 9 kesirli basamak kullanılır. "Z" dışındaki zaman farkları da kabul edilir. Örnekler: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" veya "2014-10-02T15:01:23+05:30".
securityPatchLevel

string

Güvenlik yaması düzeyi (ör. 2016-05-01).
primaryLanguageCode

string

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

string

Sistem paketiyle ilişkili android.content.pm.Signature öğesinin SHA-256 hash değeri. Bu değer, sistem derlemesinin değiştirilmediğini doğrulamak için kullanılabilir.
systemUpdateInfo

object (SystemUpdateInfo)

Beklemede olan olası bir sistem güncellemesi hakkında bilgi.

SystemUpdateInfo

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

enum (UpdateStatus)

Güncellemenin durumu: Güncelleme olup olmadığı ve türü.
updateReceivedTime

string (Timestamp format)

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

Zaman damgasında RFC 3339 kullanılır. Yani oluşturulan çıkış her zaman Z ile normalleştirilir ve 0, 3, 6 veya 9 kesirli basamak kullanılır. "Z" dışındaki zaman farkları da kabul edilir. Örnekler: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" veya "2014-10-02T15:01:23+05:30".

HardwareInfo

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,
  "euiccChipInfo": [
    {
      object (EuiccChipInfo)
    }
  ]
}
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ı. Ancak Android 12 ve sonraki sürümleri çalıştıran kişisel cihazlarda bu, enterpriseSpecificId ile aynıdır.
model

string

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

number

Cihazdaki her pil için santigrat cinsinden pil kapatma sıcaklığı eşikleri.
batteryThrottlingTemperatures[]

number

Cihazdaki her pil için santigrat cinsinden pil sınırlama sıcaklığı eşikleri.
cpuShutdownTemperatures[]

number

Cihazdaki her CPU için santigrat cinsinden CPU kapatma sıcaklığı eşikleri.
cpuThrottlingTemperatures[]

number

Cihazdaki her CPU için santigrat cinsinden CPU sınırlama sıcaklığı eşikleri.
gpuShutdownTemperatures[]

number

Cihazdaki her GPU için santigrat cinsinden GPU kapatma sıcaklığı eşikleri.
gpuThrottlingTemperatures[]

number

Cihazdaki her GPU için santigrat cinsinden GPU hızını sınırlama sıcaklığı eşikleri.
skinShutdownTemperatures[]

number

Cihazın dış yüzeyinin kapanma sıcaklığı eşikleri (santigrat derece).
skinThrottlingTemperatures[]

number

Cihazın deri sıcaklığı sınırlama eşikleri (santigrat derece).
enterpriseSpecificId

string

Yalnızca çıkış. Belirli bir kuruluştaki kişisel olarak sahip olunan bir cihazı benzersiz şekilde tanımlayan kimlik. Aynı kuruluşla kaydedilen aynı fiziksel cihazda bu kimlik, kurulumlar ve hatta fabrika ayarlarına sıfırlama işlemleri boyunca kalıcı olur. Bu kimlik, Android 12 ve sonraki sürümlerin yüklü olduğu, iş profili bulunan kişisel cihazlarda kullanılabilir.
euiccChipInfo[]

object (EuiccChipInfo)

Yalnızca çıkış. eUICC çipiyle ilgili bilgiler.

EuiccChipInfo

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

string

Yalnızca çıkış. Cihazdaki her eUICC çipinin eUICC çipini tanımlayan Yerleşik Kimlik Belgesi (EID). Bu özellik, Android 13 ve sonraki sürümlerin yüklü olduğu şirkete ait cihazlarda kullanılabilir.

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

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österim kimliği.
refreshRate

integer

Ekranın saniyedeki kare sayısı cinsinden yenileme hızı.
state

enum (DisplayState)

Ekranın durumu.
width

integer

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

integer

Piksel cinsinden ekran yüksekliği.
density

integer

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

ApplicationReport

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

Uygulama sürümü, kullanıcıya gösterildiği şekliyle.
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 değiştirilmediğini doğrulamak için kullanılabilecek, uygulamanın APK dosyasının SHA-256 karması. Karma değerinin her baytı iki basamaklı onaltılık sayı olarak gösterilir.
signingKeyCertFingerprints[]

string

Uygulama paketiyle ilişkili her android.content.pm.Signature öğesinin SHA-1 hash değeri. Her karma değerinin her baytı, iki basamaklı on altılı sayı olarak gösterilir.
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ıya yönelik olup olmadığı.

ApplicationEvent

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ı.

Zaman damgasında RFC 3339 kullanılır. Yani oluşturulan çıkış her zaman Z ile normalleştirilir ve 0, 3, 6 veya 9 kesirli basamak kullanılır. "Z" dışındaki zaman farkları da kabul edilir. Örnekler: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" veya "2014-10-02T15:01:23+05:30".

KeyedAppState

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

string

Uygulama durumu için anahtar. Uygulamanın hangi eyalette hizmet verdiğine dair referans noktası olarak kullanılı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, uygulamanın durumunu açıklayan serbest biçimli bir mesaj dizesi. Durum belirli bir değer (ör. yönetilen yapılandırma değeri) tarafından tetiklendiyse bu değer mesaja dahil edilmelidir.
data

string

İsteğe bağlı olarak, EMM tarafından okunacak makine tarafından okunabilir bir değer. Örneğin, yöneticinin EMM konsolunda sorgu oluşturmak için seçebileceği değerleri ayarlama (ör. "battery_warning verileri < 10 ise beni bilgilendir").
createTime

string (Timestamp format)

Cihazdaki uygulama durumunun oluşturulma zamanı.

Zaman damgasında RFC 3339 kullanılır. Yani oluşturulan çıkış her zaman Z ile normalleştirilir ve 0, 3, 6 veya 9 kesirli basamak kullanılır. "Z" dışındaki zaman farkları da kabul edilir. Örnekler: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" veya "2014-10-02T15:01:23+05:30".
lastUpdateTime

string (Timestamp format)

Uygulama durumunun en son güncellendiği zaman.

Zaman damgasında RFC 3339 kullanılır. Yani oluşturulan çıkış her zaman Z ile normalleştirilir ve 0, 3, 6 veya 9 kesirli basamak kullanılır. "Z" dışındaki zaman farkları da kabul edilir. Örnekler: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" veya "2014-10-02T15:01:23+05:30".

NetworkInfo

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 kablosuz MAC adresi. Örneğin, 7c:11:11:11:11:11.
networkOperatorName
(deprecated)

string

Mevcut kayıtlı operatörün alfabetik adı. Örneğin, Vodafone.
telephonyInfos[]

object (TelephonyInfo)

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

TelephonyInfo

JSON gösterimi 
{
  "phoneNumber": string,
  "carrierName": string,
  "iccId": string,
  "activationState": enum (ActivationState),
  "configMode": enum (ConfigMode)
}
Alanlar
phoneNumber

string

Bu SIM kartla ilişkili telefon numarası.
carrierName

string

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

string

Yalnızca çıkış. Bu SIM kartla ilişkili ICCID.
activationState

enum (ActivationState)

Yalnızca çıkış. Cihazdaki SIM kartın etkinleştirme durumu. Bu yalnızca eSIM'ler için geçerlidir. Bu özellik, API düzeyi 35 ve sonraki sürümlerde tüm cihazlarda desteklenir. Bu, fiziksel SIM'ler ve API düzeyi 35'ten düşük cihazlar için her zaman ACTIVATION_STATE_UNSPECIFIED olur.
configMode

enum (ConfigMode)

Yalnızca çıkış. Cihazdaki SIM kartın yapılandırma modu. Bu yalnızca eSIM'ler için geçerlidir. Bu özellik, API düzeyi 35 ve sonraki sürümlerde tüm cihazlarda desteklenir. Bu, fiziksel SIM'ler ve API düzeyi 35'in altındaki cihazlar için her zaman CONFIG_MODE_UNSPECIFIED olur.

MemoryInfo

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

string (int64 format)

Cihazdaki toplam RAM (bayt cinsinden).
totalInternalStorage

string (int64 format)

Cihazdaki toplam dahili depolama alanı (bayt cinsinden).

MemoryEvent

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ı.

Zaman damgasında RFC 3339 kullanılır. Yani oluşturulan çıkış her zaman Z ile normalleştirilir ve 0, 3, 6 veya 9 kesirli basamak kullanılır. "Z" dışındaki zaman farkları da kabul edilir. Örnekler: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" veya "2014-10-02T15:01:23+05:30".
byteCount

string (int64 format)

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

PowerManagementEvent

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ı.

Zaman damgasında RFC 3339 kullanılır. Yani oluşturulan çıkış her zaman Z ile normalleştirilir ve 0, 3, 6 veya 9 kesirli basamak kullanılır. "Z" dışındaki zaman farkları da kabul edilir. Örnekler: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" veya "2014-10-02T15:01:23+05:30".
batteryLevel

number

BATTERY_LEVEL_COLLECTED etkinlikleri için pil seviyesi yüzdesi.

HardwareStatus

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.

Zaman damgasında RFC 3339 kullanılır. Yani oluşturulan çıkış her zaman Z ile normalleştirilir ve 0, 3, 6 veya 9 kesirli basamak kullanılır. "Z" dışındaki zaman farkları da kabul edilir. Örnekler: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" veya "2014-10-02T15:01:23+05:30".
batteryTemperatures[]

number

Cihazdaki her pilin mevcut sıcaklığı (santigrat derece).
cpuTemperatures[]

number

Cihazdaki her CPU'nun mevcut CPU sıcaklığı (santigrat cinsinden).
gpuTemperatures[]

number

Cihazdaki her GPU'nun mevcut GPU sıcaklıkları (santigrat cinsinden).
skinTemperatures[]

number

Mevcut cihaz yüzey sıcaklıkları (santigrat derece).
fanSpeeds[]

number

Cihazdaki her fanın RPM cinsinden fan hızları. Boş dizi, sistemde fan olmadığı veya fan hızının desteklenmediği anlamına gelir.
cpuUsages[]

number

Cihazda bulunan her çekirdek için CPU kullanımı yüzdesi. Fişi çekilen her çekirdek için kullanım 0'dır. Boş dizi, sistemde CPU kullanımının desteklenmediği anlamına gelir.

DeviceSettings

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

boolean

Cihazın güvenliğinin PIN/şifre ile 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ığını belirler.
isEncrypted

boolean

Depolama şifrelemenin etkin olup olmadığı.
encryptionStatus

enum (EncryptionStatus)

DevicePolicyManager'dan alınan şifreleme durumu.
verifyAppsEnabled

boolean

Cihazda Google Play Protect doğrulaması'nın zorunlu olup olmadığı

Kullanıcı

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

string

Bu kullanıcı için oluşturduğunuz benzersiz tanımlayıcı (ör. user342 veya asset#44418). Bu alan, kullanıcı oluşturulurken ayarlanmalı ve güncellenememelidir. Bu alan, kimliği tanımlayabilecek bilgiler (PII) içermemelidir. Bu tanımlayıcı en fazla 1.024 karakter uzunluğunda olmalıdır. Aksi takdirde, güncelleme politikası isteği başarısız olur.

SystemPropertiesEntry

JSON gösterimi 
{
  "key": string,
  "value": string
}
Alanlar
key

string
value

string

SecurityPosture

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 durumuyla ilgili ek ayrıntılar.

PostureDetail

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

enum (SecurityRisk)

Cihazın güvenlik durumunu olumsuz etkileyen belirli bir güvenlik riski.
advice[]

object (UserFacingMessage)

Bu güvenlik riskini azaltmak ve cihazın güvenlik durumunu iyileştirmek için yöneticilere yönelik ilgili tavsiyeler.

CommonCriteriaModeInfo

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

enum (CommonCriteriaModeStatus)

Ortak Kriterler Modu'nun etkin olup olmadığı.
policySignatureVerificationStatus

enum (PolicySignatureVerificationStatus)

Yalnızca çıkış. Politika imzası doğrulamasının durumu.

PasswordRequirements

JSON gösterimi 
{
  "passwordMinimumLength": integer,
  "passwordMinimumLetters": integer,
  "passwordMinimumLowerCase": integer,
  "passwordMinimumNonLetter": integer,
  "passwordMinimumNumeric": integer,
  "passwordMinimumSymbols": integer,
  "passwordMinimumUpperCase": integer,
  "passwordQuality": enum (PasswordQuality),
  "passwordHistoryLength": integer,
  "maximumFailedPasswordsForWipe": integer,
  "passwordExpirationTimeout": string,
  "passwordScope": enum (PasswordPolicyScope),
  "requirePasswordUnlock": enum (RequirePasswordUnlock),
  "unifiedLockSettings": enum (UnifiedLockSettings)
}
Alanlar
passwordMinimumLength

integer

İzin verilen minimum şifre uzunluğu. 0 değeri, kısıtlama olmadığını gösterir. Yalnızca password_quality değeri NUMERIC, NUMERIC_COMPLEX, ALPHABETIC, ALPHANUMERIC veya COMPLEX olduğunda zorunlu kılınır.
passwordMinimumLetters

integer

Şifrede bulunması gereken minimum harf sayısı. Yalnızca password_quality COMPLEX olduğunda zorunlu kılınır.
passwordMinimumLowerCase

integer

Şifrede bulunması gereken minimum küçük harf sayısı. Yalnızca password_quality COMPLEX olduğunda zorunlu kılınır.
passwordMinimumNonLetter

integer

Şifrede kullanılması zorunlu olan minimum harf dışı karakter sayısı (rakamlar veya semboller). Yalnızca password_quality COMPLEX olduğunda zorunlu kılınır.
passwordMinimumNumeric

integer

Şifrede bulunması gereken minimum sayısal basamak sayısı. Yalnızca password_quality COMPLEX olduğunda zorunlu kılınır.
passwordMinimumSymbols

integer

Şifrede kullanılması zorunlu olan minimum sembol sayısı. Yalnızca password_quality COMPLEX olduğunda zorunlu kılınır.
passwordMinimumUpperCase

integer

Şifrede bulunması gereken minimum büyük harf sayısı. Yalnızca password_quality COMPLEX olduğunda zorunlu kılınır.
passwordQuality

enum (PasswordQuality)

Gerekli şifre kalitesi.
passwordHistoryLength

integer

Şifre geçmişinin uzunluğu. Bu alan ayarlandıktan sonra kullanıcı, geçmişteki şifrelerle aynı olan yeni bir şifre giremez. 0 değeri, kısıtlama olmadığını gösterir.
maximumFailedPasswordsForWipe

integer

Cihaz temizlenmeden önce girilebilecek yanlış cihaz kilidi açma şifrelerinin sayısı. 0 değeri, kısıtlama olmadığını gösterir.
passwordExpirationTimeout

string (Duration format)

Şifre süre sonu zaman aşımı.

En fazla dokuz kesirli basamak içeren ve "s" ile biten, saniye cinsinden süre. Örnek: "3.5s".
passwordScope

enum (PasswordPolicyScope)

Şifre koşulunun geçerli olduğu kapsam.
requirePasswordUnlock

enum (RequirePasswordUnlock)

Cihazın veya iş profilinin güçlü bir kimlik doğrulama yöntemi (şifre, PIN, desen) kullanılarak kilidi açıldıktan sonra başka bir kimlik doğrulama yöntemi (ör. parmak izi, güvenilir aracılar, yüz) kullanılarak kilidinin açılabileceği süre. Belirtilen süre geçtikten sonra cihazın veya iş profilinin kilidini açmak için yalnızca güçlü kimlik doğrulama yöntemleri kullanılabilir.
unifiedLockSettings

enum (UnifiedLockSettings)

Android 9 ve sonraki sürümlerin yüklü olduğu, iş profili içeren cihazlarda cihaz ve iş profili için birleşik kilit kullanılıp kullanılamayacağını kontrol eder. Bu politika yalnızca password_scope, SCOPE_PROFILE olarak ayarlanmışsa ayarlanabilir. Aksi takdirde politika reddedilir. Kullanıcı ayrı bir iş kilidi ayarlamadıysa ve bu alan REQUIRE_SEPARATE_WORK_LOCK olarak ayarlanmışsa nonComplianceReason değeri USER_ACTION olarak ayarlanmış bir NonComplianceDetail bildirilir.

Süre

JSON gösterimi 
{
  "seconds": string,
  "nanos": integer
}
Alanlar
seconds

string (int64 format)

Zaman aralığının imzalı saniye değeri. -315.576.000.000 ile +315.576.000.000 arasında olmalıdır (bu değerler dahil). Not: Bu sınırlar şu şekilde hesaplanır: 60 sn/dk * 60 dk/sa * 24 sa/gün * 365,25 gün/yıl * 10.000 yıl
nanos

integer

Zaman aralığının nanosaniye çözünürlüğünde, saniyenin işaretli kesirleri. Bir saniyeden kısa süreler, 0 seconds alanı ve pozitif veya negatif nanos alanı ile gösterilir. Bir saniye veya daha uzun süreler için nanos alanının sıfır olmayan değeri, seconds alanıyla aynı işarete sahip olmalıdır. -999.999.999 ile +999.999.999 arasında (bu değerler dahil) olmalıdır.

DpcMigrationInfo

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

string

Yalnızca çıkış. Bu cihaz başka bir DPC'den taşındıysa bu, cihazın 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.

DefaultApplicationInfo

JSON gösterimi 
{
  "defaultApplicationType": enum (DefaultApplicationType),
  "packageName": string,
  "defaultApplicationSettingAttempts": [
    {
      object (DefaultApplicationSettingAttempt)
    }
  ]
}
Alanlar
defaultApplicationType

enum (DefaultApplicationType)

Yalnızca çıkış. Varsayılan uygulama türü.
packageName

string

Yalnızca çıkış. Mevcut varsayılan uygulamanın paket adı.
defaultApplicationSettingAttempts[]

object (DefaultApplicationSettingAttempt)

Yalnızca çıkış. Varsayılan uygulama ayarı denemeleriyle ilgili ayrıntılar, defaultApplications bölümünde listelenen sırayla.

DefaultApplicationSettingAttempt

JSON gösterimi 
{
  "packageName": string,
  "attemptOutcome": enum (AttemptOutcome)
}
Alanlar
packageName

string

Yalnızca çıkış. Deneme yapılan uygulamanın paket adı.
attemptOutcome

enum (AttemptOutcome)

Yalnızca çıkış. Uygulamayı varsayılan olarak ayarlamanın sonucu.

Araç Ek Açıklamaları

Yıkıcı İpucu: ❌ | İdempotent İpucu: ✅ | Salt Okunur İpucu: ✅ | Açık Dünya İpucu: ❌