Method: enterprises.devices.issueCommand

Bir cihaza komut verir. Döndürülen Operation kaynağının metadata alanında bir Command var. Komutun durumunu almak için get operation yöntemini kullanın.

HTTP isteği

POST https://androidmanagement.googleapis.com/v1/{name=enterprises/*/devices/*}:issueCommand

URL, gRPC Kod Dönüştürme söz dizimini kullanır.

Yol parametreleri

Parametreler
name

string

Cihazın adı (enterprises/{enterpriseId}/devices/{deviceId} biçiminde).

İstek içeriği

İstek metni, Command öğesinin bir örneğini içerir.

Yanıt gövdesi

Başarılıysa yanıt metni, Operation öğesinin bir örneğini içerir.

Yetkilendirme kapsamları

Aşağıdaki OAuth kapsamını gerektirir:

  • https://www.googleapis.com/auth/androidmanagement

Daha fazla bilgi için OAuth 2.0 Overview sayfasına bakın.

Komut

Komut.

JSON gösterimi 
{
  "type": enum (CommandType),
  "createTime": string,
  "duration": string,
  "userName": string,
  "errorCode": enum (CommandErrorCode),
  "newPassword": string,
  "resetPasswordFlags": [
    enum (ResetPasswordFlag)
  ],

  // Union field params can be only one of the following:
  "clearAppsDataParams": {
    object (ClearAppsDataParams)
  },
  "startLostModeParams": {
    object (StartLostModeParams)
  },
  "stopLostModeParams": {
    object (StopLostModeParams)
  },
  "requestDeviceInfoParams": {
    object (RequestDeviceInfoParams)
  }
  // End of list of possible types for union field params.

  // Union field status can be only one of the following:
  "clearAppsDataStatus": {
    object (ClearAppsDataStatus)
  },
  "startLostModeStatus": {
    object (StartLostModeStatus)
  },
  "stopLostModeStatus": {
    object (StopLostModeStatus)
  },
  "requestDeviceInfoStatus": {
    object (RequestDeviceInfoStatus)
  }
  // End of list of possible types for union field status.
}
Alanlar
type

enum (CommandType)

Komutun türü.
createTime

string (Timestamp format)

Komutun oluşturulduğu zaman damgası. Zaman damgası sunucu tarafından otomatik olarak oluşturulur.

Oluşturulan çıktının her zaman Z normalleştirileceği ve 0, 3, 6 veya 9 kesirli basamak kullanacağı RFC 3339'u kullanır. "Z" dışındaki ofsetler de kabul edilir. Örnekler: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" veya "2014-10-02T15:01:23+05:30".
duration

string (Duration format)

Komutun geçerli olduğu süre. Bu süre zarfında cihaz tarafından yürütülmezse komutun süresi dolar. Belirtilmemişse varsayılan süre on dakikadır. Maksimum süre yoktur.

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

string

Cihazın sahibi olan kullanıcının kaynak adı (enterprises/{enterpriseId}/users/{userId} biçiminde). Bu, komutun gönderildiği cihaza göre sunucu tarafından otomatik olarak oluşturulur.
errorCode

enum (CommandErrorCode)

Komut başarısız olursa hatayı açıklayan bir hata kodu. Komut arayan tarafından iptal edildiğinde bu ayarlanmaz. Komut hatalarıyla ilgili gerekçelendirme için alanları aşağıdaki sırayla tercih edin (en çok tercih edilen önce): 1. Varsa clearAppsDataStatus, startLostModeStatus gibi komuta özgü alanlar veya benzerleri. 2. Ayarlanmışsa bu alan. 3. Komutu sarmalayan Operation içindeki genel error alanı.
newPassword

string

RESET_PASSWORD türündeki komutlar için isteğe bağlı olarak yeni şifreyi belirtir. Not: Android 14 cihazlarda yeni şifre, sayısal ise en az 6 karakter uzunluğunda olmalıdır. Aksi takdirde komut INVALID_VALUE ile başarısız olur.
resetPasswordFlags[]

enum (ResetPasswordFlag)

RESET_PASSWORD türündeki komutlar için isteğe bağlı olarak işaretçileri belirtir.

Birlik alanı params. Komuta özgü parametreler. Özellikle LOCK, RESET_PASSWORD, REBOOT ve RELINQUISH_OWNERSHIP gibi bazı komutların bu özelliği kullanmadığını unutmayın. Gelecekte bu komutlar da bu özelliği kullanabilir.

Bu ayarlanırsa new_password ve reset_password_flags alanları ayarlanmamalıdır. params yalnızca aşağıdakilerden biri olabilir:
clearAppsDataParams

object (ClearAppsDataParams)

Belirtilen uygulamaların verilerini cihazdan temizlemek için CLEAR_APP_DATA komutunun parametreleri. Şu sayfaya göz atın: ClearAppsDataParams. Bu ayarlanırsa type ayarlanmamalıdır. Bu durumda sunucu, değeri otomatik olarak CLEAR_APP_DATA olarak ayarlar. type değerinin CLEAR_APP_DATA olarak açıkça ayarlanması da kabul edilir.
startLostModeParams

object (StartLostModeParams)

Cihazı Kayıp Modu'na geçirmek için START_LOST_MODE komutunun parametreleri. Şu sayfaya göz atın: StartLostModeParams. Bu ayarlanırsa type ayarlanmamalıdır. Bu durumda sunucu, değeri otomatik olarak START_LOST_MODE olarak ayarlar. type değerinin START_LOST_MODE olarak açıkça ayarlanması da kabul edilir.
stopLostModeParams

object (StopLostModeParams)

Cihazı Kayıp Modu'ndan çıkarmak için STOP_LOST_MODE komutunun parametreleri. Şu sayfaya göz atın: StopLostModeParams. Bu ayarlanırsa type ayarlanmamalıdır. Bu durumda sunucu, değeri otomatik olarak STOP_LOST_MODE olarak ayarlar. type değerinin STOP_LOST_MODE olarak açıkça ayarlanması da kabul edilir.
requestDeviceInfoParams

object (RequestDeviceInfoParams)

İsteğe bağlı. Cihazla ilgili bilgileri almak için REQUEST_DEVICE_INFO komutunun parametreleri. Bu ayarlanırsa type ayarlanmamalıdır. Bu durumda sunucu, bu değeri otomatik olarak REQUEST_DEVICE_INFO olarak ayarlar . type değerinin REQUEST_DEVICE_INFO olarak açıkça ayarlanması da kabul edilir.
Birlik alanı status. Komuta özgü durum. Özellikle LOCK, RESET_PASSWORD, REBOOT ve RELINQUISH_OWNERSHIP gibi bazı komutların bu özelliği kullanmadığını unutmayın. Gelecekte bu komutlar da bu özelliği kullanabilir. status yalnızca aşağıdakilerden biri olabilir:
clearAppsDataStatus

object (ClearAppsDataStatus)

Yalnızca çıkış. Belirtilen uygulamaların verilerini cihazdan temizlemek için kullanılan CLEAR_APP_DATA komutunun durumu. Şu sayfaya göz atın: ClearAppsDataStatus.
startLostModeStatus

object (StartLostModeStatus)

Yalnızca çıkış. Cihazı Kayıp Modu'na geçirmek için kullanılan START_LOST_MODE komutunun durumu. Şu sayfaya göz atın: StartLostModeStatus.
stopLostModeStatus

object (StopLostModeStatus)

Yalnızca çıkış. Cihazı Kayıp Modu'ndan çıkarmak için kullanılan STOP_LOST_MODE komutunun durumu. Şu sayfaya göz atın: StopLostModeStatus.
requestDeviceInfoStatus

object (RequestDeviceInfoStatus)

Yalnızca çıkış. REQUEST_DEVICE_INFO komutunun durumu.

CommandType

Komut türleri.

Sıralamalar
COMMAND_TYPE_UNSPECIFIED Bu değere izin verilmez.
LOCK Kilit ekranı zaman aşımı dolmuş gibi cihazı kilitleyin.
RESET_PASSWORD Kullanıcının şifresini sıfırlayın.
REBOOT Cihazı yeniden başlatın. Yalnızca Android 7.0 (API düzeyi 24) veya sonraki sürümleri çalıştıran tamamen yönetilen cihazlarda desteklenir.
RELINQUISH_OWNERSHIP Şirkete ait Android 8.0 ve sonraki sürüm cihazlardaki iş profilini ve tüm politikaları kaldırarak cihazı kişisel kullanıma sunar. Kişisel profillerle ilişkili uygulamalar ve veriler korunur. Cihaz, komutu onayladıktan sonra sunucudan silinir.
CLEAR_APP_DATA Belirtilen uygulamaların uygulama verilerini temizler. Bu özellik, Android 9 ve sonraki sürümlerde desteklenir. Bir uygulamanın, uygulama verilerinin dışındaki verileri (ör. harici depolama alanında veya kullanıcı sözlüğünde) saklayabileceğini unutmayın. Ayrıca clearAppsDataParams sayfasına göz atın.
START_LOST_MODE Cihazı Kayıp Modu'na geçirir. Yalnızca tümüyle yönetilen cihazlarda veya yönetilen profil içeren kuruluşa ait cihazlarda desteklenir. Ayrıca startLostModeParams sayfasına göz atın.
STOP_LOST_MODE Cihazı Kayıp Modu'ndan çıkarır. Yalnızca tümüyle yönetilen cihazlarda veya yönetilen profil içeren kuruluşa ait cihazlarda desteklenir. Ayrıca stopLostModeParams sayfasına göz atın.
REQUEST_DEVICE_INFO Cihazla ilgili bilgi isteğinde bulunabilirsiniz.

CommandErrorCode

Komut hata kodu. Bu, sunucu tarafından doldurulan salt okunur bir alandır.

Sıralamalar
COMMAND_ERROR_CODE_UNSPECIFIED Hata yok.
UNKNOWN Bilinmeyen bir hata oluştu.
API_LEVEL Cihazın API düzeyi bu komutu desteklemiyor.
MANAGEMENT_MODE Yönetim modu (profil sahibi, cihaz sahibi vb.) komutu desteklemiyor.
INVALID_VALUE Komut geçersiz bir parametre değerine sahip.
UNSUPPORTED Cihaz komutu desteklemiyor. Android Cihaz Politikası'nı en son sürüme güncellemek sorunu çözebilir.

ResetPasswordFlag

RESET_PASSWORD komut türü için kullanılabilen işaretler.

Sıralamalar
RESET_PASSWORD_FLAG_UNSPECIFIED Bu değer yoksayılır.
REQUIRE_ENTRY Kullanıcı şifreyi girene kadar diğer yöneticilerin şifreyi tekrar değiştirmesine izin vermeyin.
DO_NOT_ASK_CREDENTIALS_ON_BOOT Cihazın başlatılmasında kullanıcı kimlik bilgileri istenmemelidir.
LOCK_NOW Şifre sıfırlandıktan sonra cihazı kilitleyin.

ClearAppsDataParams

Belirtilen uygulamaların verilerini cihazdan temizlemek için CLEAR_APP_DATA komutuyla ilişkili parametreler.

JSON gösterimi 
{
  "packageNames": [
    string
  ]
}
Alanlar
packageNames[]

string

Komut çalıştırıldığında verilerinin silineceği uygulamaların paket adları.

StartLostModeParams

Cihazı Kayıp Modu'na geçirmek için kullanılan START_LOST_MODE komutuyla ilişkili parametreler. Cihazın kayıp moduna geçirilmesi için kuruluş adı hariç parametrelerden en az biri sağlanmalıdır.

JSON gösterimi 
{
  "lostMessage": {
    object (UserFacingMessage)
  },
  "lostPhoneNumber": {
    object (UserFacingMessage)
  },
  "lostEmailAddress": string,
  "lostStreetAddress": {
    object (UserFacingMessage)
  },
  "lostOrganization": {
    object (UserFacingMessage)
  }
}
Alanlar
lostMessage

object (UserFacingMessage)

Cihaz Kayıp Modu'ndayken kullanıcıya gösterilen mesaj.
lostPhoneNumber

object (UserFacingMessage)

Cihaz Kayıp Modu'ndayken ve "Sahibi ara" düğmesine dokunulduğunda aranacak telefon numarası.
lostEmailAddress

string

Cihaz Kayıp Modu'ndayken kullanıcıya gösterilen e-posta adresi.
lostStreetAddress

object (UserFacingMessage)

Cihaz Kayıp Modu'ndayken kullanıcıya gösterilen açık adres.
lostOrganization

object (UserFacingMessage)

Cihaz Kayıp Modu'ndayken kullanıcıya gösterilen kuruluş adı.

StopLostModeParams

Bu türde alan yoktur.

Cihazı Kayıp Modu'ndan çıkarmak için kullanılan STOP_LOST_MODE komutuyla ilişkili parametreler.

RequestDeviceInfoParams

Cihazla ilgili bilgileri almak için REQUEST_DEVICE_INFO komutuyla ilişkili parametreler.

JSON gösterimi 
{
  "deviceInfo": enum (DeviceInfo)
}
Alanlar
deviceInfo

enum (DeviceInfo)

Zorunlu. İstenen cihaz bilgilerinin türü.

DeviceInfo

İstenen cihaz bilgisi türü.

Sıralamalar
DEVICE_INFO_UNSPECIFIED Bu değere izin verilmez.
EID eSIM'in tanımlayıcısını isteyin. Sonuç döndürülebilmesi için kullanıcıdan bilgilerin açıklanmasını onaylaması istenir. Kullanıcı açıklamayı onaylamıyorsa USER_DECLINED döndürülür. Bu özellik yalnızca iş profillerine sahip ve Android 13 ve sonraki sürümleri çalıştıran kişisel cihazlarda desteklenir.

ClearAppsDataStatus

Belirtilen uygulamaların verilerini cihazdan temizlemek için kullanılan CLEAR_APP_DATA komutunun durumu.

JSON gösterimi 
{
  "results": {
    string: {
      object (PerAppResult)
    },
    ...
  }
}
Alanlar
results

map (key: string, value: object (PerAppResult))

Uygulama başına sonuçlar, paket adlarından ilgili temizleme sonucuna bir eşleme.

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

PerAppResult

Tek bir uygulamanın verilerini temizleme denemesinin sonucu.

JSON gösterimi 
{
  "clearingResult": enum (ClearingResult)
}
Alanlar
clearingResult

enum (ClearingResult)

Tek bir uygulamanın verilerini temizleme denemesinin sonucu.

ClearingResult

Tek bir uygulamanın verilerini temizleme denemesinin sonucu.

Sıralamalar
CLEARING_RESULT_UNSPECIFIED Belirtilmemiş sonuç.
SUCCESS Bu uygulamanın verileri başarıyla temizlendi.
APP_NOT_FOUND Uygulama bulunamadığı için bu uygulamanın verileri temizlenemedi.
APP_PROTECTED Uygulama korunduğu için bu uygulamanın verileri temizlenemedi. Örneğin, bu durum Google Play Store gibi cihazın çalışması için kritik öneme sahip uygulamalar için geçerli olabilir.
API_LEVEL Cihaz API düzeyi bu komutu desteklemediğinden bu uygulamanın verileri temizlenemedi.

StartLostModeStatus

Cihazı Kayıp Modu'na geçirmek için kullanılan START_LOST_MODE komutunun durumu.

JSON gösterimi 
{
  "status": enum (Status)
}
Alanlar
status

enum (Status)

Durum. Şu sayfaya göz atın: StartLostModeStatus.

Durum

Durum. Şu sayfaya göz atın: StartLostModeStatus.

Sıralamalar
STATUS_UNSPECIFIED Belirtilmedi. Bu değer kullanılmaz.
SUCCESS Cihaz Kayıp Modu'na geçirildi.
RESET_PASSWORD_RECENTLY Yönetici cihazın şifresini kısa süre önce sıfırladığı için cihaz Kayıp Modu'na alınamadı.
USER_EXIT_LOST_MODE_RECENTLY Kullanıcı kısa süre önce Kayıp Modu'ndan çıktığı için cihaz Kayıp Modu'na alınamadı.
ALREADY_IN_LOST_MODE Cihaz zaten Kayıp Modu'nda.

StopLostModeStatus

Cihazı Kayıp Modu'ndan çıkarmak için kullanılan STOP_LOST_MODE komutunun durumu.

JSON gösterimi 
{
  "status": enum (Status)
}
Alanlar
status

enum (Status)

Durum. Şu sayfaya göz atın: StopLostModeStatus.

Durum

Durum. Şu sayfaya göz atın: StopLostModeStatus.

Sıralamalar
STATUS_UNSPECIFIED Belirtilmedi. Bu değer kullanılmaz.
SUCCESS Cihaz, Kayıp Modu'ndan çıkarıldı.
NOT_IN_LOST_MODE Cihaz Kayıp Modu'nda değil.

RequestDeviceInfoStatus

REQUEST_DEVICE_INFO komutunun durumu.

JSON gösterimi 
{
  "status": enum (Status),

  // Union field device_info can be only one of the following:
  "eidInfo": {
    object (EidInfo)
  }
  // End of list of possible types for union field device_info.
}
Alanlar
status

enum (Status)

Yalnızca çıkış. REQUEST_DEVICE_INFO komutunun durumu.
Birlik alanı device_info. Yönetici tarafından istenen cihaz bilgilerinin ayrıntıları. Bu alan yalnızca status SUCCEEDED olduğunda doldurulur. device_info yalnızca aşağıdakilerden biri olabilir:
eidInfo

object (EidInfo)

Cihazın EID'leriyle ilgili bilgiler.

Durum

REQUEST_DEVICE_INFO komutunun durumu.

Sıralamalar
STATUS_UNSPECIFIED Belirtilmedi. Bu değer kullanılmaz.
SUCCEEDED Cihaz bilgileri başarıyla yayınlandı.
PENDING_USER_ACTION Kullanıcı, cihaz bilgilerini paylaşmak için gereken işlemleri tamamlamamıştır.
USER_DECLINED Kullanıcı, cihaz bilgilerini paylaşmayı reddetti.
UNSUPPORTED İstenen cihaz bilgileri bu cihazda desteklenmiyordur (ör. cihazda eSIM desteklenmiyordur).

EidInfo

Cihazın EID'leriyle ilgili bilgiler.

JSON gösterimi 
{
  "eids": [
    {
      object (Eid)
    }
  ]
}
Alanlar
eids[]

object (Eid)

Yalnızca çıkış. Her eUICC çipi için EID bilgileri.

Ramazan Bayramı

Her eUICC çipi için EID bilgileri.

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

string

Yalnızca çıkış. EID