Method: enterprises.devices.delete
Tetap teratur dengan koleksi
Simpan dan kategorikan konten berdasarkan preferensi Anda.
Menghapus perangkat. Operasi ini mencoba menghapus total perangkat, tetapi keberhasilannya tidak dijamin jika perangkat offline dalam jangka waktu yang lama. Perangkat yang dihapus tidak muncul dalam panggilan enterprises.devices.listenterprises.devices.get
Permintaan HTTP
DELETE https://androidmanagement.googleapis.com/v1/{name=enterprises/*/devices/*}
URL menggunakan sintaksis gRPC Transcoding.
Parameter jalur
| Parameter |
name |
string
Nama perangkat dalam bentuk enterprises/{enterpriseId}/devices/{deviceId}.
|
Parameter kueri
| Parameter |
wipeDataFlags[] |
enum (WipeDataFlag)
Flag opsional yang mengontrol perilaku penghapusan data perangkat.
|
wipeReasonMessage |
string
Opsional. Pesan singkat yang ditampilkan kepada pengguna sebelum menghapus total profil kerja di perangkat pribadi. Tindakan ini tidak berpengaruh pada perangkat milik perusahaan. Panjang maksimum pesan adalah 200 karakter.
|
Isi permintaan
Isi permintaan harus kosong.
Isi respons
Jika berhasil, isi respons adalah objek JSON kosong.
Cakupan otorisasi
Memerlukan cakupan OAuth berikut:
https://www.googleapis.com/auth/androidmanagement
Untuk mengetahui informasi selengkapnya, lihat OAuth 2.0 Overview.
Kecuali dinyatakan lain, konten di halaman ini dilisensikan berdasarkan Lisensi Creative Commons Attribution 4.0, sedangkan contoh kode dilisensikan berdasarkan Lisensi Apache 2.0. Untuk mengetahui informasi selengkapnya, lihat Kebijakan Situs Google Developers. Java adalah merek dagang terdaftar dari Oracle dan/atau afiliasinya.
Terakhir diperbarui pada 2025-07-26 UTC.
[null,null,["Terakhir diperbarui pada 2025-07-26 UTC."],[[["\u003cp\u003ePermanently deletes a device, wiping its data and removing it from enterprise device lists.\u003c/p\u003e\n"],["\u003cp\u003eThe wipe behavior can be customized using optional flags like \u003ccode\u003ewipeDataFlags\u003c/code\u003e and \u003ccode\u003ewipeReasonMessage\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eRequires authorization with the \u003ccode\u003ehttps://www.googleapis.com/auth/androidmanagement\u003c/code\u003e scope.\u003c/p\u003e\n"],["\u003cp\u003eThe request body should be empty, and a successful deletion results in an empty response body.\u003c/p\u003e\n"],["\u003cp\u003eDevice deletion uses the \u003ccode\u003eDELETE\u003c/code\u003e method with the device name as a path parameter.\u003c/p\u003e\n"]]],["This document outlines the process for deleting a device via a `DELETE` HTTP request to the specified URL, requiring an empty request body. The device name is provided as a path parameter. Optional query parameters include `wipeDataFlags`, for managing data wiping behavior, and `wipeReasonMessage`, a user-facing message for personal devices. Successful deletion returns an empty JSON object. Deletion also involves wiping the device and removing it from device lists. Authentication requires the `androidmanagement` OAuth scope.\n"],null,["# Method: enterprises.devices.delete\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Query parameters](#body.QUERY_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nDeletes a device. This operation attempts to wipe the device but this is not guaranteed to succeed if the device is offline for an extended period. Deleted devices do not show up in [`enterprises.devices.list`](/android/management/reference/rest/v1/enterprises.devices/list#google.android.devicemanagement.v1.DeviceManagementService.ListDevices) calls and a 404 is returned from [`enterprises.devices.get`](/android/management/reference/rest/v1/enterprises.devices/get#google.android.devicemanagement.v1.DeviceManagementService.GetDevice).\n\n### HTTP request\n\n`DELETE https://androidmanagement.googleapis.com/v1/{name=enterprises/*/devices/*}`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|--------|----------------------------------------------------------------------------------------------|\n| `name` | `string` The name of the device in the form `enterprises/{enterpriseId}/devices/{deviceId}`. |\n\n### Query parameters\n\n| Parameters ||\n|---------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `wipeDataFlags[]` | `enum (`[WipeDataFlag](/android/management/reference/rest/v1/WipeDataFlag)`)` Optional flags that control the device wiping behavior. |\n| `wipeReasonMessage` | `string` Optional. A short message displayed to the user before wiping the work profile on personal devices. This has no effect on company owned devices. The maximum message length is 200 characters. |\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nIf successful, the response body is an empty JSON object.\n\n### Authorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/androidmanagement`\n\nFor more information, see the [OAuth 2.0 Overview](/identity/protocols/OAuth2)."]]
