Method: alerts.delete
コレクションでコンテンツを整理
必要に応じて、コンテンツの保存と分類を行います。
指定したアラートを削除対象としてマークします。削除対象に設定されたアラートは、30 日後にアラートセンターから削除されます。アラートに削除のマークを付けても、すでに削除のマークが付いているアラートには影響しません。存在しないアラートを削除対象としてマークしようとすると、NOT_FOUND
エラーが発生します。
HTTP リクエスト
DELETE https://alertcenter.googleapis.com/v1beta1/alerts/{alertId}
この URL は gRPC Transcoding 構文を使用します。
パスパラメータ
パラメータ |
alertId |
string
必須。削除するアラートの ID。
|
クエリ パラメータ
パラメータ |
customerId |
string
省略可。アラートが関連付けられているお客様の Google Workspace アカウントの一意の識別子。customerId の先頭の「C」は削除する必要があります(例: 046psxkn )。指定されていない場合は、呼び出し元の ID から推測されます。お客様 ID を確認する。
|
リクエストの本文
リクエストの本文は空にする必要があります。
レスポンスの本文
成功すると、レスポンスの本文は空の JSON オブジェクトになります。
認可スコープ
次の OAuth スコープが必要です。
https://www.googleapis.com/auth/apps.alerts
詳しくは、認可ガイドをご覧ください。
特に記載のない限り、このページのコンテンツはクリエイティブ・コモンズの表示 4.0 ライセンスにより使用許諾されます。コードサンプルは Apache 2.0 ライセンスにより使用許諾されます。詳しくは、Google Developers サイトのポリシーをご覧ください。Java は Oracle および関連会社の登録商標です。
最終更新日 2025-07-25 UTC。
[null,null,["最終更新日 2025-07-25 UTC。"],[],[],null,["# Method: alerts.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- [Examples](#examples)\n\nMarks the specified alert for deletion. An alert that has been marked for deletion is removed from Alert Center after 30 days. Marking an alert for deletion has no effect on an alert which has already been marked for deletion. Attempting to mark a nonexistent alert for deletion results in a `NOT_FOUND` error.\n\n### HTTP request\n\n`DELETE https://alertcenter.googleapis.com/v1beta1/alerts/{alertId}`\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 delete. |\n\n### Query parameters\n\n| Parameters ||\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### 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/apps.alerts`\n\nFor more information, see the [Authorization guide](/workspace/guides/configure-oauth-consent)."]]