- Permintaan HTTP
- Parameter jalur
- Isi permintaan
- Isi respons
- Cakupan otorisasi
- Perintah
- CommandType
- CommandErrorCode
- ResetPasswordFlag
- ClearAppsDataParams
- StartLostModeParams
- StopLostModeParams
- ClearAppsDataStatus
- PerAppResult
- ClearingResult
- StartLostModeStatus
- Status
- StopLostModeStatus
- Status
- Cobalah!
Memberikan perintah ke perangkat. Resource Operation
yang ditampilkan berisi Command
di kolom metadata
-nya. Gunakan metode get Operations untuk mendapatkan status perintah.
Permintaan HTTP
POST https://androidmanagement.googleapis.com/v1/{name=enterprises/*/devices/*}:issueCommand
URL menggunakan sintaksis gRPC Transcoding.
Parameter jalur
Parameter | |
---|---|
name |
Nama perangkat dalam bentuk |
Isi permintaan
Isi permintaan memuat instance Command
.
Isi respons
Jika berhasil, isi respons memuat instance Operation
.
Cakupan otorisasi
Memerlukan cakupan OAuth berikut:
https://www.googleapis.com/auth/androidmanagement
Untuk informasi selengkapnya, lihat Ringkasan OAuth 2.0.
Perintah
Perintah.
Representasi JSON |
---|
{ "type": enum ( |
Kolom | |
---|---|
type |
Jenis perintah. |
createTime |
Stempel waktu saat perintah dibuat. Stempel waktu dibuat secara otomatis oleh server. Stempel waktu dalam RFC3339 UTC "Zulu" , dengan resolusi nanodetik dan hingga sembilan digit pecahan. Contoh: |
duration |
Durasi perintah yang valid. Perintah akan habis masa berlakunya jika tidak dijalankan oleh perangkat selama waktu ini. Durasi default jika tidak ditentukan adalah sepuluh menit. Tidak ada durasi maksimum. Durasi dalam detik dengan maksimal sembilan digit pecahan, yang diakhiri dengan ' |
userName |
Nama resource pengguna yang memiliki perangkat dalam bentuk |
errorCode |
Jika perintah gagal, kode error yang menjelaskan kegagalan tersebut. Ini tidak ditetapkan jika perintah dibatalkan oleh pemanggil. |
newPassword |
Untuk perintah jenis |
resetPasswordFlags[] |
Untuk perintah jenis |
Kolom union Jika kebijakan ini disetel, kolom |
|
clearAppsDataParams |
Parameter untuk perintah |
startLostModeParams |
Parameter untuk perintah |
stopLostModeParams |
Parameter untuk perintah |
Kolom union status . Status khusus untuk perintah. Perlu diketahui bahwa beberapa perintah tidak menggunakannya, khususnya , , , dan . Di masa mendatang, perintah ini mungkin juga menggunakan perintah ini. status hanya dapat berupa salah satu dari yang berikut: |
|
clearAppsDataStatus |
Hanya output. Status perintah |
startLostModeStatus |
Hanya output. Status perintah |
stopLostModeStatus |
Hanya output. Status perintah |
CommandType
Jenis-jenis perintah.
Enum | |
---|---|
COMMAND_TYPE_UNSPECIFIED |
Nilai ini tidak diizinkan. |
LOCK |
Kunci perangkat, seolah-olah waktu tunggu layar kunci telah berakhir. |
RESET_PASSWORD |
Reset sandi pengguna. |
REBOOT |
Boot ulang perangkat. Hanya didukung pada perangkat terkelola sepenuhnya yang menjalankan Android 7.0 (level API 24) atau yang lebih tinggi. |
RELINQUISH_OWNERSHIP |
Menghapus profil kerja dan semua kebijakan dari perangkat Android 8.0+ milik perusahaan, sehingga melepaskan perangkat untuk penggunaan pribadi. Aplikasi dan data yang terkait dengan profil pribadi dipertahankan. Perangkat akan dihapus dari server setelah mengonfirmasi perintah. |
CLEAR_APP_DATA |
Menghapus data aplikasi dari aplikasi yang ditentukan. Fitur ini didukung di Android 9 dan yang lebih baru. Perhatikan bahwa aplikasi dapat menyimpan data di luar data aplikasinya, misalnya dalam penyimpanan eksternal atau dalam kamus pengguna. Lihat juga . |
START_LOST_MODE |
Memasukkan perangkat ke mode hilang. Hanya didukung di perangkat terkelola sepenuhnya atau perangkat milik organisasi dengan profil terkelola. Lihat juga . |
STOP_LOST_MODE |
Mengeluarkan perangkat dari mode hilang. Hanya didukung di perangkat terkelola sepenuhnya atau perangkat milik organisasi dengan profil terkelola. Lihat juga . |
CommandErrorCode
Kode error perintah. Kolom ini hanya diisi oleh server.
Enum | |
---|---|
COMMAND_ERROR_CODE_UNSPECIFIED |
Tidak ada kesalahan. |
UNKNOWN |
Terjadi error tak dikenal. |
API_LEVEL |
Level API perangkat tidak mendukung perintah ini. |
MANAGEMENT_MODE |
Mode pengelolaan (pemilik profil, pemilik perangkat, dll.) tidak mendukung perintah ini. |
INVALID_VALUE |
Perintah memiliki nilai parameter yang tidak valid. |
UNSUPPORTED |
Perangkat tidak mendukung perintah ini. Mengupdate Android Device Policy ke versi terbaru mungkin dapat menyelesaikan masalah tersebut. |
ResetPasswordFlag
Tanda yang dapat digunakan untuk jenis perintah RESET_PASSWORD
.
Enum | |
---|---|
RESET_PASSWORD_FLAG_UNSPECIFIED |
Nilai ini diabaikan. |
REQUIRE_ENTRY |
Jangan izinkan admin lain mengubah sandi lagi hingga pengguna memasukkannya. |
DO_NOT_ASK_CREDENTIALS_ON_BOOT |
Jangan minta kredensial pengguna saat perangkat dinyalakan. |
LOCK_NOW |
Kunci perangkat setelah kata sandi direset. |
ClearAppsDataParams
Parameter yang terkait dengan perintah
untuk menghapus data aplikasi tertentu dari perangkat.CLEAR_APP_DATA
Representasi JSON |
---|
{ "packageNames": [ string ] } |
Kolom | |
---|---|
packageNames[] |
Nama paket aplikasi yang datanya akan dihapus saat perintah dieksekusi. |
StartLostModeParams
Parameter yang terkait dengan perintah
untuk mengalihkan perangkat ke mode hilang. Setidaknya salah satu parameter, tidak termasuk nama organisasi, harus diberikan agar perangkat dapat beralih ke mode hilang.START_LOST_MODE
Representasi JSON |
---|
{ "lostMessage": { object ( |
Kolom | |
---|---|
lostMessage |
Pesan yang ditampilkan kepada pengguna saat perangkat dalam mode hilang. |
lostPhoneNumber |
Nomor telepon yang akan ditelepon saat perangkat dalam mode hilang dan tombol pemilik panggilan diketuk. |
lostEmailAddress |
Alamat email yang ditampilkan kepada pengguna saat perangkat dalam mode hilang. |
lostStreetAddress |
Alamat yang ditampilkan kepada pengguna saat perangkat dalam mode hilang. |
lostOrganization |
Nama organisasi yang ditampilkan kepada pengguna saat perangkat dalam mode hilang. |
StopLostModeParams
Jenis ini tidak memiliki kolom.
Parameter yang terkait dengan perintah
untuk mengeluarkan perangkat dari mode hilang.STOP_LOST_MODE
ClearAppsDataStatus
Status perintah
untuk menghapus data aplikasi tertentu dari perangkat.CLEAR_APP_DATA
Representasi JSON |
---|
{
"results": {
string: {
object ( |
Kolom | |
---|---|
results |
Hasil per aplikasi, pemetaan dari nama paket ke hasil pembersihan masing-masing. Objek yang berisi daftar pasangan |
PerAppResult
Hasil dari upaya untuk menghapus data dari satu aplikasi.
Representasi JSON |
---|
{
"clearingResult": enum ( |
Kolom | |
---|---|
clearingResult |
Hasil dari upaya untuk menghapus data dari satu aplikasi. |
ClearingResult
Hasil dari upaya untuk menghapus data dari satu aplikasi.
Enum | |
---|---|
CLEARING_RESULT_UNSPECIFIED |
Hasil tidak ditentukan. |
SUCCESS |
Data aplikasi ini berhasil dihapus. |
APP_NOT_FOUND |
Data aplikasi ini tidak dapat dihapus karena aplikasi tidak ditemukan. |
APP_PROTECTED |
Data aplikasi ini tidak dapat dihapus karena aplikasi dilindungi. Misalnya, hal ini mungkin berlaku untuk aplikasi yang penting bagi fungsi perangkat, seperti Google Play Store. |
API_LEVEL |
Data aplikasi ini tidak dapat dihapus karena level API perangkat tidak mendukung perintah ini. |
StartLostModeStatus
Status perintah
untuk mengalihkan perangkat ke mode hilang.START_LOST_MODE
Representasi JSON |
---|
{
"status": enum ( |
Kolom | |
---|---|
status |
Status. Lihat |
Status
Status. Lihat
.StartLostModeStatus
Enum | |
---|---|
STATUS_UNSPECIFIED |
Tidak ditentukan. Nilai ini tidak digunakan. |
SUCCESS |
Perangkat dialihkan ke mode hilang. |
RESET_PASSWORD_RECENTLY |
Perangkat tidak dapat dialihkan ke mode hilang karena baru-baru ini admin mereset sandi perangkat. |
USER_EXIT_LOST_MODE_RECENTLY |
Perangkat tidak dapat dialihkan ke mode hilang karena pengguna baru-baru ini keluar dari mode hilang. |
ALREADY_IN_LOST_MODE |
Perangkat sudah dalam mode hilang. |
StopLostModeStatus
Status perintah
untuk mengeluarkan perangkat dari mode hilang.STOP_LOST_MODE
Representasi JSON |
---|
{
"status": enum ( |
Kolom | |
---|---|
status |
Status. Lihat |
Status
Status. Lihat
.StopLostModeStatus
Enum | |
---|---|
STATUS_UNSPECIFIED |
Tidak ditentukan. Nilai ini tidak digunakan. |
SUCCESS |
Perangkat dikeluarkan dari mode hilang. |
NOT_IN_LOST_MODE |
Perangkat tidak dalam mode hilang. |