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.