LiveChatMessages: insert
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.
Thêm tin nhắn hoặc cuộc thăm dò ý kiến vào cuộc trò chuyện trực tiếp.
Các trường hợp sử dụng phổ biến
Yêu cầu
Yêu cầu HTTP
POST https://www.googleapis.com/youtube/v3/liveChat/messages
Ủy quyền
Yêu cầu này yêu cầu phải được uỷ quyền với ít nhất một trong các phạm vi sau. Để đọc thêm về việc xác thực và uỷ quyền, hãy xem bài viết Triển khai quy trình xác thực OAuth 2.0.
| Phạm vi |
|---|
https://www.googleapis.com/auth/youtube |
https://www.googleapis.com/auth/youtube.force-ssl |
Thông số
Bảng sau đây liệt kê các tham số mà truy vấn này hỗ trợ. Tất cả các tham số được liệt kê đều là tham số truy vấn.
| Thông số |
| Tham số bắt buộc |
part |
string
Tham số part có hai mục đích. Phương thức này xác định các thuộc tính mà thao tác ghi sẽ đặt cũng như các thuộc tính mà phản hồi API sẽ bao gồm. Đặt giá trị tham số thành snippet. |
Nội dung yêu cầu
Cung cấp tài nguyên liveChatMessage trong nội dung yêu cầu.
Đối với tài nguyên đó, bạn phải chỉ định giá trị cho các thuộc tính này
snippet.liveChatIdsnippet.type – chọn một trong các tuỳ chọn sau: textMessageEvent hoặc pollEvent- Nếu loại là
textMessageEvent, hãy thêm snippet.textMessageDetails.messageText
- Nếu loại là
pollEvent, hãy thêm snippet.pollDetails với các giá trị sau:
snippet.pollDetails.metadata.options.questionText- Danh sách
snippet.pollDetails.metadata.options.optionText. Bạn phải liệt kê ít nhất 2 mặt hàng và không quá 5 mặt hàng. Các mục hiển thị tuần tự theo thứ tự liệt kê.
Lỗi
Bảng sau đây xác định thông báo lỗi mà API có thể trả về để phản hồi lệnh gọi đến phương thức này. Để biết thêm thông tin chi tiết, hãy xem bài viết YouTube Live Streaming API – Lỗi.
| Loại lỗi |
Thông tin chi tiết về lỗi |
Mô tả |
forbidden (403) |
forbidden |
Bạn không có các quyền cần thiết để tạo thông báo đã chỉ định. |
forbidden (403) |
liveChatDisabled |
Chủ sở hữu đã tắt cuộc trò chuyện trực tiếp được chỉ định, tức là bạn không thể thêm tin nhắn vào cuộc trò chuyện đó. |
forbidden (403) |
liveChatEnded |
Cuộc trò chuyện trực tiếp được chỉ định không còn hoạt động nữa. |
invalidValue (400) |
messageTextInvalid |
Văn bản thông báo (snippet.textMessageDetails.messageText) không hợp lệ. |
notFound (404) |
liveChatNotFound |
Cuộc trò chuyện trực tiếp được xác định trong yêu cầu API không tồn tại. Lỗi này xảy ra nếu chủ sở hữu đã xoá cuộc trò chuyện. |
required (400) |
liveChatIdRequired |
Tài nguyên liveChatMessage phải bao gồm và chỉ định giá trị cho thuộc tính snippet.liveChatId. |
required (400) |
messageTextRequired |
Tài nguyên liveChatMessage phải bao gồm và chỉ định giá trị cho thuộc tính snippet.textMessageDetails.messageText. |
required (400) |
typeRequired |
Tài nguyên liveChatMessage phải bao gồm và chỉ định giá trị cho thuộc tính snippet.type. Đặt giá trị tham số thành text |
required (400) |
preconditionCheckFailed |
Đã có một cuộc thăm dò ý kiến đang hoạt động và được ghim. |
rateLimitExceeded |
rateLimitExceeded |
Người dùng đã đăng quá nhiều tin nhắn trò chuyện trong một khoảng thời gian nhất định. |
Hãy dùng thử!
Sử dụng APIs Explorer để gọi API này và xem yêu cầu và phản hồi API.
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-01-02 UTC.
[null,null,["Cập nhật lần gần đây nhất: 2025-01-02 UTC."],[],[],null,["# LiveChatMessages: insert\n\nAdds a message or a poll to a live chat.\n\nCommon use cases\n----------------\n\nThe list below shows common use cases for this method. Hover over a use case to see its description, or click on a use case to load sample parameter values in the APIs Explorer. You can open the [fullscreen APIs Explorer](#) to see code samples that dynamically update to reflect the parameter values entered in the Explorer.\n\nThe table below shows common use cases for this method. You can click on a use case name to load sample parameter values in the APIs Explorer. Or you can see code samples for a use case in the fullscreen APIs Explorer by clicking on the code icon below a use case name. In the fullscreen UI, you can update parameter and property values and the code samples will dynamically update to reflect the values you enter. \nThis method has one common use case, which is described below. The buttons below the description populate the APIs Explorer with sample values or open the fullscreen APIs Explorer to show code samples that use those values. The code samples also dynamically update if you change the values.\n\n\u003cbr /\u003e\n\nRequest\n-------\n\n### HTTP request\n\n```\nPOST https://www.googleapis.com/youtube/v3/liveChat/messages\n```\n\n### Authorization\n\nThis request requires authorization with at least one of the following scopes. To read more about authentication and authorization, see [Implementing OAuth 2.0 authentication](/youtube/v3/live/authentication).\n\n| Scope |\n|-----------------------------------------------------|\n| `https://www.googleapis.com/auth/youtube` |\n| `https://www.googleapis.com/auth/youtube.force-ssl` |\n\n### Parameters\n\nThe following table lists the parameters that this query supports. All of the parameters listed are query parameters.\n\n| Parameters ||\n|--------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---|\n| **Required parameters** |||\n| `part` | `string` The **part** parameter serves two purposes. It identifies the properties that the write operation will set as well as the properties that the API response will include. Set the parameter value to `snippet`. |\n\n### Request body\n\nProvide a [liveChatMessage resource](/youtube/v3/live/docs/liveChatMessages#resource) in the request body.\nFor that resource, you must specify values for these properties\n\n- `snippet.liveChatId`\n- `snippet.type` - choose one of the following options: `textMessageEvent` or `pollEvent`\n- If type is `textMessageEvent`, include `snippet.textMessageDetails.messageText`\n- If type is `pollEvent`, include `snippet.pollDetails` with the following values:\n - `snippet.pollDetails.metadata.options.questionText`\n - List of `snippet.pollDetails.metadata.options.optionText`. You must list at least two items and no more than four items. Items are displayed sequentially in the order they're listed.\n\nResponse\n--------\n\nIf successful, this method returns a [liveChatMessage resource](/youtube/v3/live/docs/liveChatMessages#resource) in the response body.\n\nErrors\n------\n\nThe following table identifies error messages that the API could return in response to a call to this method. For more details, see [YouTube Live Streaming API - Errors](/youtube/v3/live/docs/errors).\n\n| Error type | Error detail | Description |\n|----------------------|---------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `forbidden (403)` | `forbidden` | You don't have the permissions required to create the specified message. |\n| `forbidden (403)` | `liveChatDisabled` | The specified live chat has been disabled by the owner, which means messages cannot be added to the chat. |\n| `forbidden (403)` | `liveChatEnded` | The specified live chat is no longer live. |\n| `invalidValue (400)` | `messageTextInvalid` | The message text (`snippet.textMessageDetails.messageText`) is not valid. |\n| `notFound (404)` | `liveChatNotFound` | The live chat identified in the API request does not exist. This error occurs if the chat has been deleted by the owner. |\n| `required (400)` | `liveChatIdRequired` | The [liveChatMessage resource](/youtube/v3/live/docs/liveChatMessages#resource) must include and specify a value for the `snippet.liveChatId` property. |\n| `required (400)` | `messageTextRequired` | The [liveChatMessage resource](/youtube/v3/live/docs/liveChatMessages#resource) must include and specify a value for the `snippet.textMessageDetails.messageText` property. |\n| `required (400)` | `typeRequired` | The [liveChatMessage resource](/youtube/v3/live/docs/liveChatMessages#resource) must include and specify a value for the `snippet.type` property. Set the parameter value to `text` |\n| `required (400)` | `preconditionCheckFailed` | A pinned active poll already exists. |\n| `rateLimitExceeded` | `rateLimitExceeded` | The user has posted too many chat messages in a given timeframe. |\n\nTry it!\n-------\n\nUse the APIs Explorer to call this API and see the API request and response."]]
