Method: customEmojis.create
קל לארגן דפים בעזרת אוספים
אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.
בקשת HTTP
POST https://chat.googleapis.com/v1/customEmojis
כתובת ה-URL משתמשת בתחביר של Transcoding של gRPC.
גוף הבקשה
גוף הבקשה מכיל מופע של CustomEmoji.
גוף התשובה
אם הפעולה בוצעה ללא שגיאות, גוף התגובה יכיל מופע חדש של CustomEmoji.
היקפי הרשאה
נדרשת הרשאת 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\u003eThis Developer Preview feature enables the creation of custom emojis in Google Chat.\u003c/p\u003e\n"],["\u003cp\u003eIt necessitates user authentication and uses the \u003ccode\u003echat.customemojis\u003c/code\u003e OAuth scope.\u003c/p\u003e\n"],["\u003cp\u003eThe feature functions through an HTTP POST request, utilizing gRPC Transcoding, and involves request and response bodies containing the \u003ccode\u003eCustomEmoji\u003c/code\u003e object.\u003c/p\u003e\n"],["\u003cp\u003eTo explore its functionality, refer to the "Try it!" section within the documentation.\u003c/p\u003e\n"]]],["This document outlines how to create a custom emoji using the Google Chat API. A `POST` request to `https://chat.googleapis.com/v1/customEmojis` is required, with the request body containing `CustomEmoji` data. Successful requests return a new `CustomEmoji` instance in the response body. This action is available through the Google Workspace Developer Preview Program and requires user authentication and the `https://www.googleapis.com/auth/chat.customemojis` OAuth scope. The API uses gRPC Transcoding.\n"],null,["# Method: customEmojis.create\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nCreates a custom emoji.\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`POST https://chat.googleapis.com/v1/customEmojis`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Request body\n\nThe request body contains an instance of [CustomEmoji](/workspace/chat/api/reference/rest/v1/customEmojis#CustomEmoji).\n\n### Response body\n\nIf successful, the response body contains a newly created instance of [CustomEmoji](/workspace/chat/api/reference/rest/v1/customEmojis#CustomEmoji).\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)."]]
