Method: enterprises.devices.issueCommand

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

string

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

duration

string (Duration format)

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

userName

string

Nama resource pengguna yang memiliki perangkat dalam bentuk enterprises/{enterpriseId}/users/{userId}. Kode ini dibuat 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, menentukan sandi baru secara opsional. 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, menentukan flag secara opsional.

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

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

clearAppsDataParams

object (ClearAppsDataParams)

Parameter untuk perintah CLEAR_APP_DATA guna menghapus data aplikasi tertentu dari perangkat. Lihat ClearAppsDataParams. Jika kebijakan ini disetel, sebaiknya type tidak disetel. Dalam hal ini, server akan 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 untuk mengalihkan perangkat ke mode hilang. Lihat StartLostModeParams. Jika kebijakan ini disetel, sebaiknya type tidak disetel. Dalam hal ini, server akan 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 kebijakan ini disetel, sebaiknya type tidak disetel. Dalam hal ini, server akan 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 hal ini, khususnya LOCK, RESET_PASSWORD, REBOOT, dan RELINQUISH_OWNERSHIP. Di masa mendatang, perintah ini mungkin juga akan menggunakan fungsi ini. status hanya dapat berupa salah satu dari yang 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 mengalihkan 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 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 clearAppsDataParams.
START_LOST_MODE Menyetel perangkat ke mode hilang. Hanya didukung pada perangkat terkelola sepenuhnya atau perangkat milik organisasi dengan profil terkelola. Lihat juga startLostModeParams.
STOP_LOST_MODE Membuat perangkat keluar dari mode hilang. Hanya didukung pada 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 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 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 mengalihkan perangkat ke mode hilang. Setidaknya salah satu parameter, tidak termasuk nama organisasi, harus diberikan agar perangkat dialihkan 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 akan ditelepon saat perangkat dalam mode hilang dan tombol pemilik panggilan diketuk.

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 hasil pembersihan masing-masing.

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

PerAppResult

Hasil dari upaya untuk menghapus data dari satu aplikasi.

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

enum (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 START_LOST_MODE untuk mengalihkan 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 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 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 dikeluarkan dari mode hilang.
NOT_IN_LOST_MODE Perangkat tidak dalam mode hilang.