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 Запрос не может быть выполнен, так как вы превысили свою квоту .
,
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 Запрос не может быть выполнен, так как вы превысили свою квоту .