Method: alerts.batchDelete
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
HTTP 요청
POST https://alertcenter.googleapis.com/v1beta1/alerts:batchDelete
URL은 gRPC 트랜스코딩 구문을 사용합니다.
요청 본문
요청 본문에는 다음과 같은 구조의 데이터가 포함됩니다.
JSON 표현 |
{
"customerId": string,
"alertId": [
string
]
} |
필드 |
customerId |
string
선택사항입니다. 알림이 연결된 고객의 Google Workspace 계정의 고유 식별자입니다. customerId 에서 첫 번째 'C'는 삭제해야 합니다 (예: 046psxkn ). 제공되지 않은 경우 호출자 ID에서 추론됩니다. 고객 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
자세한 내용은 승인 가이드를 참고하세요.
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 Oracle 계열사의 등록 상표입니다.
최종 업데이트: 2025-07-25(UTC)
[null,null,["최종 업데이트: 2025-07-25(UTC)"],[],[],null,["# Method: alerts.batchDelete\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Request body](#body.request_body)\n - [JSON representation](#body.request_body.SCHEMA_REPRESENTATION)\n- [Response body](#body.response_body)\n - [JSON representation](#body.BatchDeleteAlertsResponse.SCHEMA_REPRESENTATION)\n- [Authorization scopes](#body.aspect)\n- [Examples](#examples)\n\nPerforms batch delete operation on alerts.\n\n### HTTP request\n\n`POST https://alertcenter.googleapis.com/v1beta1/alerts:batchDelete`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Request body\n\nThe request body contains data with the following structure:\n\n| JSON representation |\n|---------------------------------------------------------|\n| ``` { \"customerId\": string, \"alertId\": [ string ] } ``` |\n\n| Fields ||\n|--------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `customerId` | `string` Optional. The unique identifier of the Google Workspace account of the customer the alerts are 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| `alertId[]` | `string` Required. The list of alert IDs to delete. |\n\n### Response body\n\nResponse to batch delete operation on alerts.\n\nIf successful, the response body contains data with the following structure:\n\n| JSON representation |\n|-------------------------------------------------------------------------------------------------------------------|\n| ``` { \"successAlertIds\": [ string ], \"failedAlertStatus\": { string: { object (`google.rpc.Status`) }, ... } } ``` |\n\n| Fields ||\n|---------------------|----------------------------------------------------------------------------------------------------------|\n| `successAlertIds[]` | `string` The successful list of alert IDs. |\n| `failedAlertStatus` | `map (key: string, value: object (``google.rpc.Status``))` The status details for each failed `alertId`. |\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)."]]