LiveChatMessages: insert

Добавляет сообщение в чат. В настоящее время 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.