Дополнительные сведения см. в Справочном центре 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 , которые можно включить в значение параметра:
|
Тело запроса
Предоставьте ресурс действия в теле запроса. Для этого ресурса:
Вы должны указать значение для этих свойств:
-
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 .
Публикует бюллетень для определенного канала. (Пользователь, отправляющий запрос, должен быть уполномочен действовать от имени канала.)
Примечание. Несмотря на то, что ресурс 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 , которые можно включить в значение параметра:
|
Тело запроса
Предоставьте ресурс действия в теле запроса. Для этого ресурса:
Вы должны указать значение для этих свойств:
-
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 | Запрос не может быть выполнен, так как вы превысили свою квоту . |