Xoá vĩnh viễn và ngay lập tức một cặp khoá mã hoá phía máy khách. Bạn chỉ có thể xoá vĩnh viễn các cặp khoá đã tắt hơn 30 ngày. Để tắt một cặp khoá, hãy sử dụng phương thức keypairs.disable.
Gmail không thể khôi phục hoặc giải mã bất kỳ thư nào được mã hoá bằng khoá đã bị huỷ bỏ. Người dùng đã xác thực và quản trị viên Google Workspace sẽ mất quyền đọc thư đã mã hoá.
Đối với quản trị viên quản lý danh tính và cặp khoá cho người dùng trong tổ chức của họ, các yêu cầu cần được uỷ quyền bằng tài khoản dịch vụ có quyền uỷ quyền trên toàn miền để mạo danh người dùng có phạm vi https://www.googleapis.com/auth/gmail.settings.basic.
Đối với người dùng quản lý danh tính và cặp khoá của riêng họ, các yêu cầu phải bật và định cấu hình mã hoá khoá phần cứng.
Yêu cầu HTTP
POST https://gmail.googleapis.com/gmail/v1/users/{userId}/settings/cse/keypairs/{keyPairId}:obliterate
URL sử dụng cú pháp Chuyển mã gRPC.
Tham số đường dẫn
| Thông số | |
|---|---|
userId |
Địa chỉ email chính của người yêu cầu. Để chỉ báo người dùng đã được xác thực, bạn có thể sử dụng giá trị đặc biệt |
keyPairId |
Giá trị nhận dạng của cặp khoá cần xoá bỏ. |
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, 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 một trong các phạm vi OAuth sau:
https://www.googleapis.com/auth/gmail.settings.basichttps://www.googleapis.com/auth/gmail.settings.sharing
Để biết thêm thông tin, hãy xem Hướng dẫn uỷ quyền.