Method: alerts.delete

将指定的提醒标记为要删除。已标记为删除的提醒会在 30 天后从提醒中心移除。将提醒标记为删除不会对已标记为删除的提醒产生任何影响。尝试将不存在的提醒标记为要删除的提醒会导致 NOT_FOUND 错误。

HTTP 请求

DELETE https://alertcenter.googleapis.com/v1beta1/alerts/{alertId}

网址采用 gRPC 转码语法。

路径参数

参数
alertId

string

必需。要删除的提醒的标识符。

查询参数

参数
customerId

string

可选。与提醒关联的客户的 Google Workspace 账号的唯一标识符。customerId 必须去除首字母“C”（例如 046psxkn）。如果未提供，系统会从调用方身份推断出此值。查找您的客户 ID。

请求正文

请求正文必须为空。

响应正文

如果成功，则响应正文为空的 JSON 对象。

授权范围

需要以下 OAuth 范围：

  • https://www.googleapis.com/auth/apps.alerts

如需了解详情，请参阅授权指南。