Method: customEmojis.create
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
طلب HTTP
POST https://chat.googleapis.com/v1/customEmojis
يستخدِم عنوان URL بنية تحويل ترميز 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 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-07-25 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\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)."]]
