Method: alerts.batchDelete

对提醒执行批量删除操作。

HTTP 请求

POST https://alertcenter.googleapis.com/v1beta1/alerts:batchDelete

网址采用 gRPC 转码语法。

请求正文

请求正文中包含结构如下的数据:

JSON 表示法
{
  "customerId": string,
  "alertId": [
    string
  ]
}
字段
customerId

string

可选。与提醒相关联的客户所属 Google Workspace 帐号的唯一标识符。customerId 必须去除初始“C”(例如 046psxkn)。如果未提供,则根据调用方身份推断得出。查找您的客户 ID

alertId[]

string

必需。要删除的提醒 ID 的列表。

响应正文

对提醒的批量删除操作的响应。

如果成功,响应正文将包含结构如下的数据:

JSON 表示法
{
  "successAlertIds": [
    string
  ],
  "failedAlertStatus": {
    string: {
      object (google.rpc.Status)
    },
    ...
  }
}
字段
successAlertIds[]

string

成功的提醒 ID 列表。

failedAlertStatus

map (key: string, value: object (google.rpc.Status))

每个失败的 alertId 的状态详情。

授权范围

需要以下 OAuth 作用域:

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

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