Добавляет сообщение в чат. В настоящее время API поддерживает возможность вставки только текстовых сообщений.
Общие варианты использования
Запрос
HTTP-запрос
POST https://www.googleapis.com/youtube/v3/liveChat/messages
Авторизация
Этот запрос требует авторизации по крайней мере в одной из следующих областей ( подробнее об аутентификации и авторизации ).
Объем |
---|
https://www.googleapis.com/auth/youtube |
https://www.googleapis.com/auth/youtube.force-ssl |
Параметры
В следующей таблице перечислены параметры, которые поддерживает этот запрос. Все перечисленные параметры являются параметрами запроса.
Параметры | ||
---|---|---|
Обязательные параметры | ||
part | string Параметр part служит двум целям. Он определяет свойства, которые будут установлены операцией записи, а также свойства, которые будут включены в ответ API. Установите значение параметра на snippet . |
Тело запроса
Предоставьте ресурс liveChatMessage в теле запроса. Для этого ресурса:
Вы должны указать значение для этих свойств:
-
snippet.liveChatId
-
snippet.type
: в настоящее время поддерживается только значениеtextMessageEvent
. -
snippet.textMessageDetails.messageText
-
Ответ
В случае успеха этот метод возвращает ресурс liveChatMessage в теле ответа.
Ошибки
В следующей таблице указаны сообщения об ошибках, которые API может возвращать в ответ на вызов этого метода. Более подробную информацию см. в документации по сообщениям об ошибках .
Тип ошибки | Сведения об ошибке | Описание |
---|---|---|
forbidden (403) | forbidden | У вас нет прав, необходимых для создания указанного сообщения. |
forbidden (403) | liveChatDisabled | Указанный чат отключен владельцем, что означает, что сообщения не могут быть добавлены в чат. |
forbidden (403) | liveChatEnded | Указанный чат больше не работает. |
invalidValue (400) | messageTextInvalid | Текст сообщения ( snippet.textMessageDetails.messageText ) недействителен. |
notFound (404) | liveChatNotFound | Онлайн-чат, указанный в запросе API, не существует. Эта ошибка возникает, если чат был удален владельцем. |
rateLimitExceeded | rateLimitExceeded | Пользователь разместил слишком много сообщений в чате за указанный период времени. |
required (400) | liveChatIdRequired | Ресурс liveChatMessage должен включать и указывать значение для свойства snippet.liveChatId . |
required (400) | messageTextRequired | Ресурс liveChatMessage должен включать и указывать значение для свойства snippet.textMessageDetails.messageText . |
required (400) | typeRequired | Ресурс liveChatMessage должен включать и указывать значение для свойства snippet.type . Установите значение параметра в text |
Попробуй это!
Используйте APIs Explorer , чтобы вызвать этот API и просмотреть запрос и ответ API.