Activities: insert

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

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

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

Примечание. Несмотря на то, что ресурс activity может содержать информацию о таких действиях, как оценка пользователем видео или пометка видео как избранного, вам необходимо использовать другие методы API для создания этих ресурсов activity . Например, вы можете использовать метод 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 Запрос не может быть выполнен, поскольку вы превысили квоту .