REST Resource: customEmojis
Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang
Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.
Tài nguyên: CustomEmoji
Biểu diễn dưới dạng JSON |
{
"name": string,
"uid": string,
"emojiName": string,
"temporaryImageUri": string,
"payload": {
object (CustomEmojiPayload )
}
} |
Trường |
name |
string
Giá trị nhận dạng. Tên tài nguyên của biểu tượng cảm xúc tuỳ chỉnh do máy chủ chỉ định. Định dạng customEmojis/{customEmoji}
|
uid |
string
Chỉ có đầu ra. Khoá duy nhất cho tài nguyên biểu tượng cảm xúc tuỳ chỉnh.
|
emojiName |
string
Không bắt buộc. Không thể thay đổi. Tên do người dùng cung cấp cho biểu tượng cảm xúc tuỳ chỉnh, tên này phải là duy nhất trong tổ chức. Bắt buộc khi tạo biểu tượng cảm xúc tuỳ chỉnh, nếu không thì chỉ xuất. Tên biểu tượng cảm xúc phải bắt đầu và kết thúc bằng dấu hai chấm, phải viết thường và chỉ được chứa các ký tự bao gồm chữ và số, dấu gạch ngang và dấu gạch dưới. Bạn nên dùng dấu gạch ngang và dấu gạch dưới để phân tách các từ, nhưng không được dùng liên tiếp. Ví dụ: :valid-emoji-name:
|
temporaryImageUri |
string
Chỉ có đầu ra. URL hình ảnh tạm thời cho biểu tượng cảm xúc tuỳ chỉnh, có hiệu lực ít nhất 10 phút. Xin lưu ý rằng giá trị này không được điền vào nội dung phản hồi khi tạo biểu tượng cảm xúc tuỳ chỉnh.
|
payload |
object (CustomEmojiPayload )
Không bắt buộc. Chỉ nhập. Dữ liệu tải trọng. Bắt buộc khi tạo biểu tượng cảm xúc tuỳ chỉnh.
|
CustomEmojiPayload
Dữ liệu tải trọng cho biểu tượng cảm xúc tuỳ chỉnh.
Biểu diễn dưới dạng JSON |
{
"fileContent": string,
"filename": string
} |
Trường |
fileContent |
string (bytes format)
Bắt buộc. Chỉ nhập. Hình ảnh dùng cho biểu tượng cảm xúc tuỳ chỉnh. Trọng tải phải dưới 256 KB và kích thước của hình ảnh phải là hình vuông, từ 64 đến 500 pixel. Các quy định hạn chế này có thể thay đổi.
|
filename |
string
Bắt buộc. Chỉ nhập. Tên tệp hình ảnh. Đuôi tệp được hỗ trợ: .png , .jpg , .gif .
|
Phương thức |
|
Tạo biểu tượng cảm xúc tuỳ chỉnh. |
|
Xoá biểu tượng cảm xúc tuỳ chỉnh. |
|
Trả về thông tin chi tiết về một biểu tượng cảm xúc tuỳ chỉnh. |
|
Liệt kê các biểu tượng cảm xúc tuỳ chỉnh mà người dùng đã xác thực có thể thấy. |
Trừ phi có lưu ý khác, nội dung của trang này được cấp phép theo Giấy phép ghi nhận tác giả 4.0 của Creative Commons và các mẫu mã lập trình được cấp phép theo Giấy phép Apache 2.0. Để biết thông tin chi tiết, vui lòng tham khảo Chính sách trang web của Google Developers. Java là nhãn hiệu đã đăng ký của Oracle và/hoặc các đơn vị liên kết với Oracle.
Cập nhật lần gần đây nhất: 2025-07-25 UTC.
[null,null,["Cập nhật lần gần đây nhất: 2025-07-25 UTC."],[[["\u003cp\u003eThis documentation outlines the \u003ccode\u003eCustomEmoji\u003c/code\u003e resource, representing a custom emoji within Google Chat, including its properties and JSON representation.\u003c/p\u003e\n"],["\u003cp\u003eIt describes the \u003ccode\u003eCustomEmojiPayload\u003c/code\u003e, detailing the data required for creating a custom emoji, specifically focusing on image content and filename.\u003c/p\u003e\n"],["\u003cp\u003eDevelopers can utilize the provided methods to create, delete, retrieve, or list custom emojis using the Google Chat API.\u003c/p\u003e\n"],["\u003cp\u003eThese functionalities are currently part of the Google Workspace Developer Preview Program, granting early access for testing and development purposes.\u003c/p\u003e\n"]]],["Custom emojis, part of the Google Workspace Developer Preview, are defined by a name, unique identifier (`uid`), and user-provided `emojiName` that must be enclosed in colons. A `temporaryImageUri` is provided. The `payload` contains the image's `fileContent` (under 256 KB) and `filename` (.png, .jpg, .gif). Key actions include: creating custom emojis, deleting them, retrieving details, and listing all visible custom emojis. All these actions are performed through the corresponding methods.\n"],null,["# REST Resource: customEmojis\n\n- [Resource: CustomEmoji](#CustomEmoji)\n - [JSON representation](#CustomEmoji.SCHEMA_REPRESENTATION)\n - [CustomEmojiPayload](#CustomEmoji.CustomEmojiPayload)\n - [JSON representation](#CustomEmoji.CustomEmojiPayload.SCHEMA_REPRESENTATION)\n- [Methods](#METHODS_SUMMARY)\n\nResource: CustomEmoji\n---------------------\n\nRepresents a [custom emoji](https://support.google.com/chat/answer/12800149).\n\n| JSON representation |\n|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"name\": string, \"uid\": string, \"emojiName\": string, \"temporaryImageUri\": string, \"payload\": { object (/workspace/chat/api/reference/rest/v1/customEmojis#CustomEmoji.CustomEmojiPayload) } } ``` |\n\n| Fields ||\n|---------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `name` | `string` Identifier. The resource name of the custom emoji, assigned by the server. Format: `customEmojis/{customEmoji}` |\n| `uid` | `string` Output only. Unique key for the custom emoji resource. |\n| `emojiName` | `string` Optional. Immutable. User-provided name for the custom emoji, which is unique within the organization. Required when the custom emoji is created, output only otherwise. Emoji names must start and end with colons, must be lowercase and can only contain alphanumeric characters, hyphens, and underscores. Hyphens and underscores should be used to separate words and cannot be used consecutively. Example: `:valid-emoji-name:` |\n| `temporaryImageUri` | `string` Output only. A temporary image URL for the custom emoji, valid for at least 10 minutes. Note that this is not populated in the response when the custom emoji is created. |\n| `payload` | `object (`[CustomEmojiPayload](/workspace/chat/api/reference/rest/v1/customEmojis#CustomEmoji.CustomEmojiPayload)`)` Optional. Input only. Payload data. Required when the custom emoji is created. |\n\n### CustomEmojiPayload\n\nPayload data for the custom emoji.\n\n| JSON representation |\n|-------------------------------------------------------|\n| ``` { \"fileContent\": string, \"filename\": string } ``` |\n\n| Fields ||\n|---------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `fileContent` | `string (`[bytes](https://developers.google.com/discovery/v1/type-format)` format)` Required. Input only. The image used for the custom emoji. The payload must be under 256 KB and the dimension of the image must be square and between 64 and 500 pixels. The restrictions are subject to change. |\n| `filename` | `string` Required. Input only. The image file name. Supported file extensions: `.png`, `.jpg`, `.gif`. |\n\n| Methods ------- ||\n|-------------------------------------------------------------------------|--------------------------------------------------------|\n| ### [create](/workspace/chat/api/reference/rest/v1/customEmojis/create) | Creates a custom emoji. |\n| ### [delete](/workspace/chat/api/reference/rest/v1/customEmojis/delete) | Deletes a custom emoji. |\n| ### [get](/workspace/chat/api/reference/rest/v1/customEmojis/get) | Returns details about a custom emoji. |\n| ### [list](/workspace/chat/api/reference/rest/v1/customEmojis/list) | Lists custom emojis visible to the authenticated user. |"]]