Method: customEmojis.delete
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
HTTP 요청
DELETE https://chat.googleapis.com/v1/{name=customEmojis/*}
URL은 gRPC 트랜스코딩 문법을 사용합니다.
경로 매개변수
| 매개변수 |
name |
string
필수 항목입니다. 삭제할 맞춤 그림 이모티콘의 리소스 이름입니다. 형식: customEmojis/{customEmoji} 그림 이모티콘 이름을 {customEmoji}의 별칭으로 사용할 수 있습니다. 예를 들어 customEmojis/:example-emoji:는 :example-emoji:가 맞춤 이모티콘의 이모티콘 이름인 경우입니다.
|
응답 본문
성공하면 응답 본문은 빈 JSON 객체입니다.
승인 범위
다음 OAuth 범위가 필요합니다.
https://www.googleapis.com/auth/chat.customemojis
자세한 내용은 승인 가이드를 참고하세요.
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 Oracle 계열사의 등록 상표입니다.
최종 업데이트: 2025-07-25(UTC)
[null,null,["최종 업데이트: 2025-07-25(UTC)"],[[["\u003cp\u003eDeletes a custom emoji using the DELETE HTTP request method with required user authentication.\u003c/p\u003e\n"],["\u003cp\u003eRequires the \u003ccode\u003echat.customemojis\u003c/code\u003e OAuth scope for authorization.\u003c/p\u003e\n"],["\u003cp\u003eThe custom emoji is identified by its resource name, specified as a path parameter called \u003ccode\u003ename\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eThe request body must be empty, and a successful deletion results in an empty response body.\u003c/p\u003e\n"],["\u003cp\u003eThis feature is currently available as a developer preview within the Google Workspace Developer Preview Program.\u003c/p\u003e\n"]]],["This document details the process of deleting a custom emoji via an HTTP DELETE request to `https://chat.googleapis.com/v1/{name=customEmojis/*}`. The `name` path parameter, representing the emoji's resource name (e.g., `customEmojis/:example-emoji:`), is required. The request body must be empty. A successful deletion results in an empty response body. This action requires user authentication and the `https://www.googleapis.com/auth/chat.customemojis` OAuth scope. It's available via the Google Workspace Developer Preview Program.\n"],null,["# Method: customEmojis.delete\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nDeletes a custom emoji. By default, users can only delete custom emoji they created. [Emoji managers](https://support.google.com/a/answer/12850085) assigned by the administrator can delete any custom emoji in the organization. See [Learn about custom emojis in Google Chat](https://support.google.com/chat/answer/12800149).\n\nCustom emojis are only available for Google Workspace accounts, and the administrator must turn custom emojis on for the organization. For more information, see [Learn about custom emojis in Google Chat](https://support.google.com/chat/answer/12800149) and [Manage custom emoji permissions](https://support.google.com/a/answer/12850085).\n\nRequires [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user) with the [authorization scope](https://developers.google.com/workspace/chat/authenticate-authorize#chat-api-scopes):\n\n- `https://www.googleapis.com/auth/chat.customemojis`\n\n### HTTP request\n\n`DELETE https://chat.googleapis.com/v1/{name=customEmojis/*}`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|--------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `name` | `string` Required. Resource name of the custom emoji to delete. Format: `customEmojis/{customEmoji}` You can use the emoji name as an alias for `{customEmoji}`. For example, `customEmojis/:example-emoji:` where `:example-emoji:` is the emoji name for a custom emoji. |\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/chat.customemojis`\n\nFor more information, see the [Authorization guide](/workspace/chat/authenticate-authorize)."]]
