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 и ответ.