- 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 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 format |
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 pembuatan perintah. Stempel waktu dibuat secara otomatis oleh server. Stempel waktu dalam format RFC3339 UTC "Zulu", dengan resolusi nanodetik dan maksimal sembilan digit fraksional. Contoh: |
duration |
Durasi berlakunya perintah. Masa berlaku perintah akan berakhir 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, 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 ditetapkan, 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 hal ini, khususnya , , , dan . Di masa mendatang, perintah ini mungkin juga akan menggunakan fungsi 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 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 akan 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, aplikasi dapat menyimpan data di luar data aplikasinya, misalnya dalam penyimpanan eksternal atau dalam kamus pengguna. Lihat juga . |
START_LOST_MODE |
Menyetel perangkat ke mode hilang. Hanya didukung pada perangkat terkelola sepenuhnya atau perangkat milik organisasi dengan profil terkelola. Lihat juga . |
STOP_LOST_MODE |
Membuat perangkat keluar dari mode hilang. Hanya didukung pada 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 nilai parameter yang tidak valid. |
UNSUPPORTED |
Perangkat tidak mendukung perintah. Mengupdate Android Device Policy ke versi terbaru 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 meminta 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 mengalihkan perangkat ke mode hilang. Setidaknya salah satu parameter, tidak termasuk nama organisasi, harus diberikan agar perangkat dialihkan 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, ketentuan ini mungkin berlaku untuk aplikasi yang penting untuk fungsi perangkat, seperti Google Play Store. |
API_LEVEL |
Data aplikasi ini tidak bisa 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 admin baru saja 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. |