Method: enterprises.devices.issueCommand

Bir cihaza komut gönderir. 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 Overview (OAuth 2.0'a Genel Bakış) sayfasına göz atı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)
  }
  // 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.

RFC3339 UTC "Zulu" biçiminde, nanosaniye çözünürlüğüne ve en fazla dokuz kesirli basamağa sahip 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. Komut bu süre içinde cihaz tarafından yürütülmezse komutun süresi dolar. Belirtilmemişse varsayılan süre on dakikadır. Maksimum süre yoktur.

"s" ile biten, en fazla dokuz kesir basamağı içeren, 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 cihazları kullanıyorsanız yeni şifre sayısal olacaksa 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 bunu da 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 politika ayarlanırsa type öğesinin ayarlanmaması önerilir. 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 politika ayarlanırsa type öğesinin ayarlanmaması önerilir. Bu durumda, sunucu bunu otomatik olarak START_LOST_MODE değerine 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 politika ayarlanırsa type öğesinin ayarlanmaması önerilir. 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 bunu da kullanabilir. status yalnızca aşağıdakilerden biri olabilir:
clearAppsDataStatus

object (ClearAppsDataStatus)

Yalnızca çıkış. Belirtilen uygulamaların verilerini cihazdan temizlemek için 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 Cihazı, kilit ekranı zaman aşımı süresi dolmuş gibi 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 tümüyle yönetilen cihazlarda desteklenir.
RELINQUISH_OWNERSHIP Şirkete ait Android 8.0 veya sonraki bir sürümün yüklü olduğu cihazdaki iş profilini ve tüm politikaları kaldırarak, cihazın kişisel amaçla kullanılmasına son verir. 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 profile sahip kuruluşa ait cihazlarda desteklenir. Ayrıca bkz. startLostModeParams.
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ını da inceleyin.

CommandErrorCode

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

Sıralamalar
COMMAND_ERROR_CODE_UNSPECIFIED Hata bulunamadı.
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ı kilitle.

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 CLEAR_APP_DATA komutunun durumu.

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

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

Paket adlarından ilgili temizleme sonucuna bir eşleme olan uygulama başına sonuçlar.

"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 girişiminin sonucu.

ClearingResult

Tek bir uygulamanın verilerini temizleme denemesinin sonucu.

Sıralamalar
CLEARING_RESULT_UNSPECIFIED Sonuç belirtilmemiş.
SUCCESS Bu uygulamanın verileri başarıyla temizlendi.
APP_NOT_FOUND Uygulama bulunamadığından bu uygulamanın verileri temizlenemedi.
APP_PROTECTED Uygulama korunduğu için bu uygulamanın verileri temizlenemedi. Örneğin bu, Google Play Store gibi cihazın çalışması açısından kritik olan 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 geçirilemedi.
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.