Method: enterprises.devices.issueCommand

Bir cihaza komut verir. Döndürülen Operation kaynağının metadata alanında Command yer alıyor. 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'a Genel Bakış başlıklı makaleyi inceleyin.

Komut

Bir 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)
  }
  // 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)
  }
  // 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.

Nanosaniye çözünürlüğüne ve en fazla dokuz kesirli basamağa sahip, RFC3339 UTC "Zulu" biçiminde bir zaman damgası. Örnekler: "2014-10-02T15:01:23Z" ve "2014-10-02T15:01:23.045123456Z".
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.
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.
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.

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) depolayabileceğini unutmayın. Ayrıca clearAppsDataParams sayfasını da inceleyin.
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ını da inceleyin.
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 adresini de inceleyin.

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 açılışında kullanıcı kimlik bilgileri istemeyin.
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 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.

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.