- 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
. Gunakan metode operasi get 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 akan berisi instance Operation
.
Cakupan otorisasi
Memerlukan cakupan OAuth berikut ini:
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 otomatis dibuat oleh server. Stempel waktu dalam format RFC3339 UTC "Zulu", dengan resolusi nanodetik dan hingga sembilan digit pecahan. Contoh: |
duration |
Durasi perintah yang valid. Perintah akan habis masa berlakunya jika tidak dieksekusi oleh perangkat selama waktu ini. Jika tidak ditentukan, durasi default adalah sepuluh menit. Tidak ada durasi maksimum. Durasi dalam detik dengan paling banyak 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 saat 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 diperhatikan bahwa beberapa perintah tidak menggunakan fitur ini, khususnya , , , dan . Di masa mendatang, perintah ini juga dapat menggunakan fungsi ini. status hanya dapat berupa salah satu dari berikut: |
|
clearAppsDataStatus |
Hanya output. Status perintah |
startLostModeStatus |
Hanya output. Status perintah |
stopLostModeStatus |
Hanya output. Status perintah |
CommandType
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 |
Menjalankan reboot perangkat. Hanya didukung pada perangkat yang terkelola sepenuhnya yang menjalankan Android 7.0 (API level 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 akan dipertahankan. Perangkat akan dihapus dari server setelah mengonfirmasi perintah. |
CLEAR_APP_DATA |
Menghapus data aplikasi dari aplikasi yang ditentukan. Dukungan ini didukung di Android 9 dan yang lebih baru. Perhatikan, aplikasi dapat menyimpan data di luar data aplikasinya, misalnya dalam penyimpanan eksternal atau di kamus pengguna. Lihat juga . |
START_LOST_MODE |
Menyetel 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. Ini adalah kolom hanya-baca yang 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 parameter value yang tidak valid. |
UNSUPPORTED |
Perangkat tidak mendukung perintah. Mengupdate Android Device Policy ke versi terbaru dapat mengatasi masalah ini. |
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 booting perangkat. |
LOCK_NOW |
Kunci perangkat setelah reset sandi. |
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 menyetel perangkat ke mode hilang. Setidaknya salah satu parameter, tidak termasuk nama organisasi, harus diberikan agar perangkat 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 ditampilkan kepada pengguna saat perangkat dalam mode hilang. |
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 masing-masing hasil kliring. Objek yang berisi daftar pasangan |
PerAppResult
Hasil upaya untuk menghapus data dari satu aplikasi.
Representasi JSON |
---|
{
"clearingResult": enum ( |
Kolom | |
---|---|
clearingResult |
Hasil upaya untuk menghapus data dari satu aplikasi. |
ClearingResult
Hasil 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 untuk fungsi perangkat, seperti Google Play Store. |
API_LEVEL |
Data aplikasi ini tidak dapat dihapus karena API level perangkat tidak mendukung perintah ini. |
StartLostModeStatus
Status perintah
untuk menyetel 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 admin mereset sandi perangkat baru-baru ini. |
USER_EXIT_LOST_MODE_RECENTLY |
Perangkat tidak dapat dialihkan ke mode hilang karena pengguna baru saja 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 dialihkan dari mode hilang. |
NOT_IN_LOST_MODE |
Perangkat tidak dalam mode hilang. |