Subscriptions: insert

Добавляет подписку на канал аутентифицированного пользователя.

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

Распространенные случаи использования

Запрос

HTTP-запрос

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

Авторизация

Этот запрос требует авторизации хотя бы в одной из следующих областей ( подробнее об аутентификации и авторизации читайте здесь ).

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

Параметры

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

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

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

Тело запроса

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

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

    • snippet.resourceId

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

    • snippet.resourceId

Ответ

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

Ошибки

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

Тип ошибки Детализация ошибки Описание
badRequest (400) subscriptionDuplicate Подписка, которую вы пытаетесь создать, уже существует.
badRequest (400) subscriptionForbidden Вы достигли максимального количества подписок.
badRequest (400) subscriptionForbidden Подписка на собственный канал не поддерживается.
badRequest (400) subscriptionForbidden Слишком много недавних подписок. Пожалуйста, повторите попытку через несколько часов.
forbidden (403) subscriptionForbidden Запрос не аутентифицирован должным образом или не поддерживается для этого канала.
notFound (404) publisherNotFound Ресурс, указанный в свойстве snippet.resourceId запроса, не найден.
notFound (404) subscriberNotFound Абонент, указанный в запросе, не найден.
required (400) publisherRequired Ресурс подписки, указанный в запросе, должен использовать свойство snippet.resourceId для идентификации канала, на который подписывается.

Попробуй это!

Используйте APIs Explorer для вызова этого API и просмотра запроса и ответа API.