Method: enterprises.devices.issueCommand

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

string

Nama perangkat dalam bentuk enterprises/{enterpriseId}/devices/{deviceId}.

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 (CommandType),
  "createTime": string,
  "duration": string,
  "userName": string,
  "errorCode": enum (CommandErrorCode),
  "newPassword": string,
  "resetPasswordFlags": [
    enum (ResetPasswordFlag)
  ],

  // Union field params can be only one of the following:
  "clearAppsDataParams": {
    object (ClearAppsDataParams)
  },
  "startLostModeParams": {
    object (StartLostModeParams)
  },
  "stopLostModeParams": {
    object (StopLostModeParams)
  }
  // End of list of possible types for union field params.

  // Union field status can be only one of the following:
  "clearAppsDataStatus": {
    object (ClearAppsDataStatus)
  },
  "startLostModeStatus": {
    object (StartLostModeStatus)
  },
  "stopLostModeStatus": {
    object (StopLostModeStatus)
  }
  // End of list of possible types for union field status.
}
Kolom
type

enum (CommandType)

Jenis perintah.
createTime

string (Timestamp format)

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: "2014-10-02T15:01:23Z" dan "2014-10-02T15:01:23.045123456Z".
duration

string (Duration format)

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 's'. Contoh: "3.5s".
userName

string

Nama resource pengguna yang memiliki perangkat dalam bentuk enterprises/{enterpriseId}/users/{userId}. Token ini dihasilkan secara otomatis oleh server berdasarkan perangkat tempat perintah dikirim.
errorCode

enum (CommandErrorCode)

Jika perintah gagal, kode error yang menjelaskan kegagalan tersebut. Ini tidak ditetapkan saat perintah dibatalkan oleh pemanggil.
newPassword

string

Untuk perintah jenis RESET_PASSWORD, secara opsional menentukan sandi baru. Catatan: Panjang sandi baru minimal harus 6 karakter jika berupa angka pada perangkat Android 14. Jika tidak, perintah akan gagal dengan INVALID_VALUE.
resetPasswordFlags[]

enum (ResetPasswordFlag)

Untuk perintah jenis RESET_PASSWORD, secara opsional menentukan flag.

Kolom union params. Parameter khusus untuk perintah. Perlu diperhatikan bahwa beberapa perintah tidak menggunakan fitur ini, khususnya LOCK, RESET_PASSWORD, REBOOT, dan RELINQUISH_OWNERSHIP. Di masa mendatang, perintah ini juga dapat menggunakan fungsi ini.

Jika kebijakan ini disetel, kolom new_password dan reset_password_flags tidak boleh ditetapkan. params hanya dapat berupa salah satu dari berikut:
clearAppsDataParams

object (ClearAppsDataParams)

Parameter untuk perintah CLEAR_APP_DATA guna menghapus data aplikasi tertentu dari perangkat. Lihat ClearAppsDataParams. Jika disetel, sebaiknya type tidak disetel. Dalam hal ini, server secara otomatis menyetelnya ke CLEAR_APP_DATA. Anda juga dapat menetapkan type ke CLEAR_APP_DATA secara eksplisit.
startLostModeParams

object (StartLostModeParams)

Parameter untuk perintah START_LOST_MODE guna mengalihkan perangkat ke mode hilang. Lihat StartLostModeParams. Jika disetel, sebaiknya type tidak disetel. Dalam hal ini, server secara otomatis menyetelnya ke START_LOST_MODE. Anda juga dapat menetapkan type ke START_LOST_MODE secara eksplisit.
stopLostModeParams

object (StopLostModeParams)

Parameter untuk perintah STOP_LOST_MODE guna mengeluarkan perangkat dari mode hilang. Lihat StopLostModeParams. Jika disetel, sebaiknya type tidak disetel. Dalam hal ini, server secara otomatis menyetelnya ke STOP_LOST_MODE. Anda juga dapat menetapkan type ke STOP_LOST_MODE secara eksplisit.
Kolom union status. Status khusus untuk perintah. Perlu diperhatikan bahwa beberapa perintah tidak menggunakan fitur ini, khususnya LOCK, RESET_PASSWORD, REBOOT, dan RELINQUISH_OWNERSHIP. Di masa mendatang, perintah ini juga dapat menggunakan fungsi ini. status hanya dapat berupa salah satu dari berikut:
clearAppsDataStatus

object (ClearAppsDataStatus)

Hanya output. Status perintah CLEAR_APP_DATA untuk menghapus data aplikasi tertentu dari perangkat. Lihat ClearAppsDataStatus.
startLostModeStatus

object (StartLostModeStatus)

Hanya output. Status perintah START_LOST_MODE untuk menyetel perangkat ke mode hilang. Lihat StartLostModeStatus.
stopLostModeStatus

object (StopLostModeStatus)

Hanya output. Status perintah STOP_LOST_MODE untuk mengeluarkan perangkat dari mode hilang. Lihat StopLostModeStatus.

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 clearAppsDataParams.
START_LOST_MODE Menyetel perangkat ke mode hilang. Hanya didukung di perangkat terkelola sepenuhnya atau perangkat milik organisasi dengan profil terkelola. Lihat juga startLostModeParams.
STOP_LOST_MODE Mengeluarkan perangkat dari mode hilang. Hanya didukung di perangkat terkelola sepenuhnya atau perangkat milik organisasi dengan profil terkelola. Lihat juga stopLostModeParams.

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 CLEAR_APP_DATA untuk menghapus data aplikasi tertentu dari perangkat.

Representasi JSON 
{
  "packageNames": [
    string
  ]
}
Kolom
packageNames[]

string

Nama paket aplikasi yang datanya akan dihapus saat perintah dieksekusi.

StartLostModeParams

Parameter yang terkait dengan perintah START_LOST_MODE untuk menyetel perangkat ke mode hilang. Setidaknya salah satu parameter, tidak termasuk nama organisasi, harus diberikan agar perangkat beralih ke mode hilang.

Representasi JSON 
{
  "lostMessage": {
    object (UserFacingMessage)
  },
  "lostPhoneNumber": {
    object (UserFacingMessage)
  },
  "lostEmailAddress": string,
  "lostStreetAddress": {
    object (UserFacingMessage)
  },
  "lostOrganization": {
    object (UserFacingMessage)
  }
}
Kolom
lostMessage

object (UserFacingMessage)

Pesan yang ditampilkan kepada pengguna saat perangkat dalam mode hilang.
lostPhoneNumber

object (UserFacingMessage)

Nomor telepon yang ditampilkan kepada pengguna saat perangkat dalam mode hilang.
lostEmailAddress

string

Alamat email yang ditampilkan kepada pengguna saat perangkat dalam mode hilang.
lostStreetAddress

object (UserFacingMessage)

Alamat yang ditampilkan kepada pengguna saat perangkat dalam mode hilang.
lostOrganization

object (UserFacingMessage)

Nama organisasi yang ditampilkan kepada pengguna saat perangkat dalam mode hilang.

StopLostModeParams

Jenis ini tidak memiliki kolom.

Parameter yang terkait dengan perintah STOP_LOST_MODE untuk mengeluarkan perangkat dari mode hilang.

ClearAppsDataStatus

Status perintah CLEAR_APP_DATA untuk menghapus data aplikasi tertentu dari perangkat.

Representasi JSON 
{
  "results": {
    string: {
      object (PerAppResult)
    },
    ...
  }
}
Kolom
results

map (key: string, value: object (PerAppResult))

Hasil per aplikasi, pemetaan dari nama paket ke masing-masing hasil kliring.

Objek yang berisi daftar pasangan "key": value. Contoh: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

PerAppResult

Hasil upaya untuk menghapus data dari satu aplikasi.

Representasi JSON 
{
  "clearingResult": enum (ClearingResult)
}
Kolom
clearingResult

enum (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 START_LOST_MODE untuk menyetel perangkat ke mode hilang.

Representasi JSON 
{
  "status": enum (Status)
}
Kolom
status

enum (Status)

Status. Lihat StartLostModeStatus.

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 STOP_LOST_MODE untuk mengeluarkan perangkat dari mode hilang.

Representasi JSON 
{
  "status": enum (Status)
}
Kolom
status

enum (Status)

Status. Lihat StopLostModeStatus.

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.