Method: customEmojis.delete
קל לארגן דפים בעזרת אוספים
אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.
בקשת HTTP
DELETE https://chat.googleapis.com/v1/{name=customEmojis/*}
כתובת ה-URL משתמשת בתחביר של Transcoding של 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. Java הוא סימן מסחרי רשום של חברת 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)."]]