Activities: insert

YouTube прекратил поддержку функции оповещения о каналах, и этот метод больше не поддерживается.

Более подробную информацию можно найти в Справочном центре YouTube .

Публикует бюллетень для конкретного канала. (Пользователь, отправляющий запрос, должен быть авторизован действовать от имени канала.)

Примечание: Несмотря на то, что ресурс activity может содержать информацию о таких действиях, как оценка видео пользователем или добавление видео в избранное, для генерации этих ресурсов activity необходимо использовать другие методы API. Например, можно использовать метод API videos.rate() для оценки видео и метод playlistItems.insert() для добавления видео в избранное.

Влияние квоты: вызов этого метода имеет квоту стоимостью 50 единиц.

Запрос

HTTP-запрос 

POST https://www.googleapis.com/youtube/v3/activities

Авторизация

Для этого запроса требуется авторизация по крайней мере в одной из следующих областей ( подробнее об аутентификации и авторизации ).

Объем
https://www.googleapis.com/auth/youtube
https://www.googleapis.com/auth/youtube.force-ssl

Параметры

В следующей таблице перечислены параметры, поддерживаемые этим запросом. Все перечисленные параметры являются параметрами запроса.

Параметры
Обязательные параметры
part string
Параметр part в этой операции выполняет две функции: он определяет свойства, которые установит операция записи, а также свойства, которые будет включать ответ API.

Следующий список содержит названия part , которые можно включить в значение параметра:
  • contentDetails
  • id
  • snippet

Текст запроса

Укажите ресурс активности в теле запроса. Для этого ресурса:

  • Необходимо указать значение для следующих свойств:

    • snippet.description

  • Вы можете установить значения для этих свойств:

    • snippet.description
    • contentDetails.bulletin.resourceId

Ответ

В случае успеха этот метод возвращает ресурс активности в теле ответа.

Ошибки

В следующей таблице перечислены сообщения об ошибках, которые API может вернуть в ответ на вызов этого метода. Подробнее см. в документации по сообщениям об ошибках .

Тип ошибки Подробности ошибки Описание
badRequest (400) bulletinTextRequired Запрос должен использовать свойство description объекта snippet для предоставления текста сообщения бюллетеня.
badRequest (400) invalidMetadata Свойство kind не соответствует типу предоставленного идентификатора.
forbidden (403) forbidden Запрос не был должным образом авторизован.
notFound (404) playlistNotFound YouTube не может найти видео, которое вы пытаетесь связать с публикацией. Проверьте значение свойства contentDetails.bulletinPosted.playlistId .
notFound (404) videoNotFound YouTube не может найти видео, которое вы пытаетесь связать с публикацией. Проверьте значение свойства contentDetails.bulletinPosted.videoId .
userRateLimitExceeded (403) rateLimitExceeded Запрос не может быть выполнен, так как вы превысили свою квоту .