Method: alerts.undelete
使用集合让一切井井有条
根据您的偏好保存内容并对其进行分类。
恢复或“取消删除”过去 30 天内被标记为要删除的提醒。尝试取消删除已被标记为删除且已超过 30 天(已从提醒中心数据库中移除)的提醒或不存在的提醒会返回 NOT_FOUND
错误。尝试取消删除未被标记为待删除的提醒不会产生任何效果。
HTTP 请求
POST https://alertcenter.googleapis.com/v1beta1/alerts/{alertId}:undelete
网址采用 gRPC 转码语法。
路径参数
参数 |
alertId |
string
必需。要取消删除的提醒的标识符。
|
请求正文
请求正文中包含结构如下的数据:
JSON 表示法 |
{
"customerId": string
} |
字段 |
customerId |
string
可选。与提醒关联的客户的 Google Workspace 账号的唯一标识符。customerId 必须去除首字母“C”(例如 046psxkn )。如果未提供,系统会从调用方身份推断出此值。查找您的客户 ID。
|
响应正文
如果成功,则响应正文包含一个 Alert
实例。
授权范围
需要以下 OAuth 范围:
https://www.googleapis.com/auth/apps.alerts
如需了解详情,请参阅授权指南。
如未另行说明,那么本页面中的内容已根据知识共享署名 4.0 许可获得了许可,并且代码示例已根据 Apache 2.0 许可获得了许可。有关详情,请参阅 Google 开发者网站政策。Java 是 Oracle 和/或其关联公司的注册商标。
最后更新时间 (UTC):2025-07-25。
[null,null,["最后更新时间 (UTC):2025-07-25。"],[],[],null,["# Method: alerts.undelete\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Request body](#body.request_body)\n - [JSON representation](#body.request_body.SCHEMA_REPRESENTATION)\n- [Response body](#body.response_body)\n- [Authorization scopes](#body.aspect)\n- [Examples](#examples)\n\nRestores, or \"undeletes\", an alert that was marked for deletion within the past 30 days. Attempting to undelete an alert which was marked for deletion over 30 days ago (which has been removed from the Alert Center database) or a nonexistent alert returns a `NOT_FOUND` error. Attempting to undelete an alert which has not been marked for deletion has no effect.\n\n### HTTP request\n\n`POST https://alertcenter.googleapis.com/v1beta1/alerts/{alertId}:undelete`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|-----------|-------------------------------------------------------------|\n| `alertId` | `string` Required. The identifier of the alert to undelete. |\n\n### Request body\n\nThe request body contains data with the following structure:\n\n| JSON representation |\n|----------------------------------|\n| ``` { \"customerId\": string } ``` |\n\n| Fields ||\n|--------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `customerId` | `string` Optional. The unique identifier of the Google Workspace account of the customer the alert is associated with. The `customerId` must have the initial \"C\" stripped (for example, `046psxkn`). Inferred from the caller identity if not provided. [Find your customer ID](https://support.google.com/cloudidentity/answer/10070793). |\n\n### Response body\n\nIf successful, the response body contains an instance of [Alert](/workspace/admin/alertcenter/reference/rest/v1beta1/alerts#Alert).\n\n### Authorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/apps.alerts`\n\nFor more information, see the [Authorization guide](/workspace/guides/configure-oauth-consent)."]]