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.