Method: enterprises.devices.delete
Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang
Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.
Xoá một thiết bị. Thao tác này tìm cách xoá sạch dữ liệu trên thiết bị nhưng không đảm bảo thành công nếu thiết bị không có kết nối mạng trong một thời gian dài. Các thiết bị đã bị xoá sẽ không xuất hiện trong các cuộc gọi enterprises.devices.listenterprises.devices.get
Yêu cầu HTTP
DELETE https://androidmanagement.googleapis.com/v1/{name=enterprises/*/devices/*}
URL sử dụng cú pháp Chuyển mã gRPC.
Tham số đường dẫn
| Thông số |
name |
string
Tên của thiết bị ở dạng enterprises/{enterpriseId}/devices/{deviceId}.
|
Tham số truy vấn
| Thông số |
wipeDataFlags[] |
enum (WipeDataFlag)
Các cờ không bắt buộc để kiểm soát hành vi xoá dữ liệu trên thiết bị.
|
wipeReasonMessage |
string
Không bắt buộc. Một thông báo ngắn hiển thị cho người dùng trước khi xoá sạch hồ sơ công việc trên thiết bị cá nhân. Điều này không ảnh hưởng đến các thiết bị thuộc quyền sở hữu của công ty. Độ dài tối đa của thông báo là 200 ký tự.
|
Nội dung yêu cầu
Nội dung yêu cầu phải trống.
Nội dung phản hồi
Nếu thành công, phần nội dung phản hồi sẽ là một đối tượng JSON trống.
Phạm vi uỷ quyền
Yêu cầu phạm vi OAuth sau:
https://www.googleapis.com/auth/androidmanagement
Để biết thêm thông tin, hãy xem OAuth 2.0 Overview.
Trừ phi có lưu ý khác, nội dung của trang này được cấp phép theo Giấy phép ghi nhận tác giả 4.0 của Creative Commons và các mẫu mã lập trình được cấp phép theo Giấy phép Apache 2.0. Để biết thông tin chi tiết, vui lòng tham khảo Chính sách trang web của Google Developers. Java là nhãn hiệu đã đăng ký của Oracle và/hoặc các đơn vị liên kết với Oracle.
Cập nhật lần gần đây nhất: 2025-07-26 UTC.
[null,null,["Cập nhật lần gần đây nhất: 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)."]]
