- HTTP isteği
- Yol parametreleri
- İstek metni
- Yanıt metni
- Yetkilendirme kapsamları
- Komut
- CommandType
- CommandErrorCode
- ResetPasswordFlag
- ClearAppsDataParams
- StartLostModeParams
- StopLostModeParams
- ClearAppsDataStatus
- PerAppResult
- ClearingResult
- StartLostModeStatus
- Durum
- StopLostModeStatus
- Durum
- Deneyin.
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 |
Cihazın |
İ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 ( |
Alanlar | |
---|---|
type |
Komutun türü. |
createTime |
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: |
duration |
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 " |
userName |
Cihazın sahibi olan kullanıcının |
errorCode |
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 |
|
resetPasswordFlags[] |
|
Birleştirme alanı Bu ayarlanırsa |
|
clearAppsDataParams |
Belirtilen uygulamaların verilerini cihazdan temizlemek için |
startLostModeParams |
Cihazı Kayıp Modu'na almak için kullanılan |
stopLostModeParams |
Cihazı Kayıp Modu'ndan çıkarmak için kullanılan |
Birleştirme alanı status . Komuta özgü durum. Bazı komutların (özellikle , , ve ) bunu kullanmadığını unutmayın. Gelecekte bu komutlar bunu da kullanabilir. status şunlardan yalnızca biri olabilir: |
|
clearAppsDataStatus |
Yalnızca çıkış. Belirtilen uygulamaların verilerini cihazdan temizlemek için |
startLostModeStatus |
Yalnızca çıkış. Cihazı Kayıp Modu'na geçirmek için kullanılan |
stopLostModeStatus |
Yalnızca çıkış. Cihazı Kayıp Modu'ndan çıkarmayla ilgili |
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. . |
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. . |
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. . |
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
komutuyla ilişkilendirilen parametreler.CLEAR_APP_DATA
JSON gösterimi |
---|
{ "packageNames": [ string ] } |
Alanlar | |
---|---|
packageNames[] |
Komut yürütüldüğünde verileri silinecek uygulamaların paket adları. |
StartLostModeParams
Cihazı Kayıp Modu'na almak için kullanılan
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.START_LOST_MODE
JSON gösterimi |
---|
{ "lostMessage": { object ( |
Alanlar | |
---|---|
lostMessage |
Cihaz Kayıp Modu'ndayken kullanıcıya gösterilen mesaj. |
lostPhoneNumber |
Cihaz Kayıp Modu'ndayken ve Arama sahibi düğmesine dokunulduğunda aranacak telefon numarası. |
lostEmailAddress |
Cihaz Kayıp Modu'ndayken kullanıcıya gösterilen e-posta adresi. |
lostStreetAddress |
Cihaz Kayıp Modu'ndayken kullanıcıya gösterilen açık adres. |
lostOrganization |
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
komutuyla ilişkilendirilmiş parametreler.STOP_LOST_MODE
ClearAppsDataStatus
Belirtilen uygulamaların verilerini cihazdan temizlemek için
komutunun durumu.CLEAR_APP_DATA
JSON gösterimi |
---|
{
"results": {
string: {
object ( |
Alanlar | |
---|---|
results |
Paket adlarından ilgili temizleme sonucuna bir eşleme olan uygulama başına sonuçlar.
|
PerAppResult
Tek bir uygulamanın verilerini temizleme girişiminin sonucu.
JSON gösterimi |
---|
{
"clearingResult": enum ( |
Alanlar | |
---|---|
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
komutunun durumu.START_LOST_MODE
JSON gösterimi |
---|
{
"status": enum ( |
Alanlar | |
---|---|
status |
Durum. Şu sayfaya göz atın: |
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
komutunun durumu.STOP_LOST_MODE
JSON gösterimi |
---|
{
"status": enum ( |
Alanlar | |
---|---|
status |
Durum. Şu sayfaya göz atın: |
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. |