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

enterprises/{enterpriseId}/devices/{deviceId} biçimindeki cihazın 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'a Genel Bakış başlıklı makaleye bakın.

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ük ve en fazla dokuz kesir basamağı olan, 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üredir. Komutun süresi, bu süre içinde cihaz tarafından çalıştırılmazsa sona erer. Bir değer belirtilmezse varsayılan süre on dakikadır. Maksimum süre yoktur.

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

string

Cihazın sahibi olan kullanıcının enterprises/{enterpriseId}/users/{userId} biçimindeki kaynak adı. Bu değer, 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. 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 yüklü cihazlarda yeni şifre sayısalsa 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 flag'leri belirtir.

Birleştirme alanı params. Komuta özel parametreler. Bazı komutların, özellikle de LOCK, RESET_PASSWORD, REBOOT ve RELINQUISH_OWNERSHIP komutlarının bunu kullanmadığını unutmayın. Gelecekte bu komutlar da bunu 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 silmek için kullanılan CLEAR_APP_DATA komutu parametreleri. Şu sayfaya göz atın: ClearAppsDataParams. Bu özellik ayarlandıysa type politikasının ayarlanmaması önerilir. Bu durumda, sunucu bunu otomatik olarak CLEAR_APP_DATA değerine ayarlar. type öğesinin açıkça CLEAR_APP_DATA olarak ayarlanması da kabul edilebilir.
startLostModeParams

object (StartLostModeParams)

Cihazı Kayıp Modu'na geçirmek için START_LOST_MODE komutu parametreleri. Şu sayfaya göz atın: StartLostModeParams. Bu özellik ayarlandıysa type politikasının ayarlanmaması önerilir. Bu durumda, sunucu bunu otomatik olarak START_LOST_MODE değerine ayarlar. type öğesinin açıkça START_LOST_MODE olarak ayarlanması da kabul edilebilir.
stopLostModeParams

object (StopLostModeParams)

Cihazı kayıp modundan çıkarmak için STOP_LOST_MODE komutu parametreleri. Şu sayfaya göz atın: StopLostModeParams. Bu özellik ayarlandıysa type politikasının ayarlanmaması önerilir. Bu durumda, sunucu bunu otomatik olarak STOP_LOST_MODE değerine ayarlar. type öğesinin açıkça STOP_LOST_MODE olarak ayarlanması da kabul edilebilir.
Birleştirme alanı status. Komuta özgü durum. Bazı komutların, özellikle de LOCK, RESET_PASSWORD, REBOOT ve RELINQUISH_OWNERSHIP komutlarının bunu kullanmadığını unutmayın. Gelecekte bu komutlar da bunu kullanabilir. status şunlardan yalnızca biri olabilir:
clearAppsDataStatus

object (ClearAppsDataStatus)

Yalnızca çıkış. Belirtilen uygulamaların verilerini cihazdan temizlemeyi sağlayan 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 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 yüklü cihazdaki iş profilini ve tüm politikaları kaldırarak cihazı kişisel kullanıma bırakır. Kişisel profillerle ilişkili uygulamalar ve veriler korunur. Cihaz, komutu kabul ettikten 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, verileri uygulama verilerinin dışında, örneğin harici depolamada veya kullanıcı sözlüğünde depolayabileceğini unutmayın. Ayrıca clearAppsDataParams politikasına bakın.
START_LOST_MODE Cihazı Kayıp Modu'na geçirir. Yalnızca tümüyle yönetilen cihazlarda veya yönetilen profili olan kuruluşa ait cihazlarda desteklenir. Ayrıca startLostModeParams politikasına bakın.
STOP_LOST_MODE Cihazı Kayıp Modu'ndan çıkarır. Yalnızca tümüyle yönetilen cihazlarda veya yönetilen profili olan kuruluşa ait cihazlarda desteklenir. Ayrıca stopLostModeParams politikasına bakın.

CommandErrorCode

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

Sıralamalar
COMMAND_ERROR_CODE_UNSPECIFIED Hata yoktu.
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 en son sürüme 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 tekrar izin vermeyin.
DO_NOT_ASK_CREDENTIALS_ON_BOOT Cihaz önyüklemesinde kullanıcı kimlik bilgilerini sorma.
LOCK_NOW Şifre sıfırlandıktan sonra cihazı kilitleyin.

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 temizlenecek uygulamaların paket adları.

StartLostModeParams

Cihazı Kayıp Modu'na geçirmek için START_LOST_MODE komutuyla ilişkilendirilen parametreler. Cihazın Kayıp Modu'na alınabilmesi için kuruluş adı dahil olmayan en az bir parametrenin sağlanması gerekir.

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 sokak adresi.
lostOrganization

object (UserFacingMessage)

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

StopLostModeParams

Bu türde alan yok.

Cihazı kayıp modundan çıkarmak için STOP_LOST_MODE komutuyla ilişkilendirilen parametreler.

ClearAppsDataStatus

Belirtilen uygulamaların verilerini cihazdan temizlemeyi sağlayan 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 uygulamaya özgü sonuçlar.

"key": value çiftlerin 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ç belirtilmedi.
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, cihazın çalışması açısından kritik öneme sahip uygulamalar (ör. Google Play Store) için geçerli olabilir.
API_LEVEL Cihazın API düzeyi bu komutu desteklemediğinden 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ığından 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 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.