Method: enterprises.devices.issueCommand

Bir cihaza komut gönderir. Döndürülen Operation kaynağı, metadata alanında bir Command içeriyor. Komutun durumunu almak için get işlem 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 enterprises/{enterpriseId}/devices/{deviceId} biçimindeki adı.

İ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" zaman damgası biçiminde olmalıdır. Ö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.

En fazla dokuz kesir basamağı olan ve "s" ile biten, saniye cinsinden süre. Örnek: "3.5s".

userName

string

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

errorCode

enum (CommandErrorCode)

Komut başarısız olduysa, hatayı açıklayan bir hata kodu gösterilir. Komut, çağrı yapan tarafından iptal edildiğinde bu ayar uygulanmaz.

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şaretleri belirtir.

Birleştirme alanı params. Komuta özel parametreler. Bazı komutların (özellikle LOCK, RESET_PASSWORD, REBOOT ve RELINQUISH_OWNERSHIP) bunu kullanmadığını unutmayın. Gelecekte bu komutlar bunu da kullanabilir.

Bu ayarlanırsa new_password ve reset_password_flags alanları ayarlanmamalıdır. params şunlardan yalnızca 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 bunu otomatik olarak CLEAR_APP_DATA değerine ayarlar. type değerinin açıkça CLEAR_APP_DATA olarak ayarlanması da kabul edilebilir.

startLostModeParams

object (StartLostModeParams)

Cihazı Kayıp Modu'na almak için kullanılan START_LOST_MODE komutu parametreleridir. Ş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 açıkça START_LOST_MODE olarak ayarlanması da kabul edilebilir.

stopLostModeParams

object (StopLostModeParams)

Cihazı Kayıp Modu'ndan çıkarmak için kullanılan STOP_LOST_MODE komutu parametreleridir. Şu sayfaya göz atın: StopLostModeParams. Bu politika ayarlanırsa type öğesinin ayarlanmaması önerilir. Bu durumda, sunucu bunu otomatik olarak STOP_LOST_MODE değerine ayarlar. type değerinin açıkça STOP_LOST_MODE olarak ayarlanması da kabul edilebilir.

Birleştirme alanı status. Komuta özgü durum. Bazı komutların (özellikle LOCK, RESET_PASSWORD, REBOOT ve RELINQUISH_OWNERSHIP) bunu kullanmadığını unutmayın. Gelecekte bu komutlar bunu da kullanabilir. status şunlardan yalnızca 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 çıkarmayla ilgili 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 verilmiyor.
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 onaylandı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, kendi uygulama verilerinin dışında veri depolayabileceğini unutmayın (örneğin, harici depolama alanında veya kullanıcı sözlüğünde). Ayrıca bkz. clearAppsDataParams.
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 profile sahip kuruluşa ait cihazlarda desteklenir. Ayrıca bkz. stopLostModeParams.

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 Komutun parametre değeri geçersiz.
UNSUPPORTED Cihaz, komutu desteklemiyor. Android Device Policy'nin son sürümüne güncellenmesi sorunu çözebilir.

ResetPasswordFlag

RESET_PASSWORD komut türü için kullanılabilecek 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 değiştirmesine izin vermeyin.
DO_NOT_ASK_CREDENTIALS_ON_BOOT Cihaz başlatılırken kullanıcı kimlik bilgilerini isteme.
LOCK_NOW Şifre sıfırlandıktan sonra cihazı kilitle.

ClearAppsDataParams

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

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

string

Komut yürütüldüğünde verileri silinecek uygulamaların paket adları.

StartLostModeParams

Cihazı Kayıp Modu'na almak için kullanılan START_LOST_MODE komutuyla ilişkilendirilen parametreler. Cihazın Kayıp Modu'na alınması için en az bir parametre (kuruluş adı hariç) 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 Arama sahibi 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 yok.

Cihazı Kayıp Modu'ndan çıkarmak için kullanılan STOP_LOST_MODE komutuyla ilişkilendirilmiş 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 girişiminin 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 girişiminin 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 Bu uygulama korunduğu için 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ın 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 alındı.
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 geçirilemedi.
ALREADY_IN_LOST_MODE Cihaz zaten Kayıp Modu'nda.

StopLostModeStatus

Cihazı Kayıp Modu'ndan çıkarmayla ilgili 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ğildir.