- HTTP isteği
- Yol parametreleri
- İstek metni
- Yanıt metni
- Yetkilendirme kapsamları
- Command
- 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 |
|
İ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 ( |
Alanlar | |
---|---|
type |
Komutun türü. |
createTime |
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: |
duration |
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. " |
userName |
Cihazın sahibi olan kullanıcının |
errorCode |
Komut başarısız olduysa hatayı açıklayan bir hata kodu. Komut, arayan tarafından iptal edildiğinde bu ayarlanmaz. |
newPassword |
|
resetPasswordFlags[] |
|
Birleştirme alanı Bu ayarlanırsa |
|
clearAppsDataParams |
Belirtilen uygulamaların verilerini cihazdan silmek için kullanılan |
startLostModeParams |
Cihazı Kayıp Modu'na geçirmek için |
stopLostModeParams |
Cihazı kayıp modundan çıkarmak için |
Birleştirme alanı status . Komuta özgü durum. Bazı komutların, özellikle de , , ve komutlarının bunu kullanmadığını unutmayın. Gelecekte bu komutlar da bunu kullanabilir. status şunlardan yalnızca biri olabilir: |
|
clearAppsDataStatus |
Yalnızca çıkış. Belirtilen uygulamaların verilerini cihazdan temizlemeyi sağlayan |
startLostModeStatus |
Yalnızca çıkış. Cihazı Kayıp Modu'na geçirmek için kullanılan |
stopLostModeStatus |
Yalnızca çıkış. Cihazı Kayıp Modu'ndan çıkarmak için |
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 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 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 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
komutuyla ilişkilendirilen parametreler.CLEAR_APP_DATA
JSON gösterimi |
---|
{ "packageNames": [ string ] } |
Alanlar | |
---|---|
packageNames[] |
Komut yürütüldüğünde verileri temizlenecek uygulamaların paket adları. |
StartLostModeParams
Cihazı Kayıp Modu'na geçirmek için
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.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 sokak adresi. |
lostOrganization |
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
komutuyla ilişkilendirilen parametreler.STOP_LOST_MODE
ClearAppsDataStatus
Belirtilen uygulamaların verilerini cihazdan temizlemeyi sağlayan
komutunun durumu.CLEAR_APP_DATA
JSON gösterimi |
---|
{
"results": {
string: {
object ( |
Alanlar | |
---|---|
results |
Paket adlarından ilgili temizleme sonucuna bir eşleme olan uygulamaya özgü 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ç 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
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ığı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
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ğil. |