Subscriptions

Ресурс subscription содержит информацию о подписке пользователя YouTube. Подписка позволяет получать уведомления о новых видео на канале и о действиях других пользователей на YouTube, например о загрузке видео, его оценке или добавлении комментария.

Методы

API поддерживает следующие методы для ресурсов subscriptions:

list

Возвращает ресурсы подписок, соответствующие критериям запроса к API. Перейти

insert

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

delete

Удаляет подписку. Перейти

Представление ресурса

Ниже приведена структура JSON для ресурса subscriptions:

{
  "kind": "youtube#subscription",
  "etag": etag,
  "id": string,
  "snippet": {
    "publishedAt": datetime,
    "channelTitle": string,
    "title": string,
    "description": string,
    "resourceId": {
      "kind": string,
      "channelId": string,
    },
    "channelId": string,
    "thumbnails": {
      (key): {
        "url": string,
        "width": unsigned integer,
        "height": unsigned integer
      }
    }
  },
  "contentDetails": {
    "totalItemCount": unsigned integer,
    "newItemCount": unsigned integer,
    "activityType": string
  },
  "subscriberSnippet": {
    "title": string,
    "description": string,
    "channelId": string,
    "thumbnails": {
      (key): {
        "url": string,
        "width": unsigned integer,
        "height": unsigned integer
      }
    }
  }
}

Свойства

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

Свойства
kind	string Определяет тип ресурса API. Значение будет youtube#subscription.
etag	etag Тег Etag этого ресурса.
id	string Идентификатор, который YouTube использует для уникальной идентификации подписки.
snippet	object Объект snippet содержит основные сведения о подписке, включая ее название и канал, на который подписан пользователь.
snippet.publishedAt	datetime Дата и время создания подписки. Значение указывается в формате ISO 8601.
snippet.title	string Название подписки.
snippet.description	string Сведения о подписке.
snippet.resourceId	object Объект id содержит информацию о канале, на который подписался пользователь.
snippet.resourceId.kind	string Тип ресурса API.
snippet.resourceId.channelId	string Значение, которое YouTube использует для уникальной идентификации канала, на который подписался пользователь.
snippet.channelId	string Идентификатор, который YouTube использует для уникальной идентификации канала подписчика. Объект resource_id идентифицирует канал, на который подписался пользователь.
snippet.thumbnails	object Карта значков, связанных с подпиской. Для каждого объекта на карте ключ – это название значка, а значение – это объект, который содержит другую информацию о значке.
snippet.thumbnails.(key)	object Допустимые значения ключей: default – уменьшенное изображение по умолчанию для этого ресурса. Ширина стандартного значка видео или ресурса, который ссылается на видео (например, элемента плейлиста или результата поиска), составляет 120 пикселей, а высота – 90 пикселей. По умолчанию значок канала имеет размер 88 x 88 пикселей. medium – версия значка с более высоким разрешением. Для видео (или ресурса, который ссылается на видео) это изображение имеет ширину 320 пикселей и высоту 180 пикселей. Для канала размер изображения составляет 240 x 240 пикселей. high – версия значка в высоком разрешении. Для видео (или ресурса, который ссылается на видео) размер изображения составляет 480 x 360 пикселей. Для канала это изображение размером 800 x 800 пикселей.
snippet.thumbnails.(key).url	string URL изображения.
snippet.thumbnails.(key).width	unsigned integer Ширина изображения.
snippet.thumbnails.(key).height	unsigned integer Высота изображения.
contentDetails	object Объект contentDetails содержит базовую статистику по подписке.
contentDetails.totalItemCount	unsigned integer Приблизительное количество объектов, на которые указывает подписка.
contentDetails.newItemCount	unsigned integer Количество новых элементов в подписке с момента последнего просмотра контента.
contentDetails.activityType	string Тип действий, на которые оформлена подписка (только загрузки или все действия). Допустимые значения: all uploads
subscriberSnippet	object Объект subscriberSnippet содержит основную информацию о подписчике.
subscriberSnippet.title	string Название канала подписчика.
subscriberSnippet.description	string Описание канала подписчика.
subscriberSnippet.channelId	string Идентификатор, который YouTube присваивает каналу подписчика.
subscriberSnippet.thumbnails	object Уменьшенные изображения канала подписчика.
subscriberSnippet.thumbnails.(key)	object Допустимые значения ключей: default – уменьшенное изображение по умолчанию для этого ресурса. Ширина стандартного значка видео или ресурса, который ссылается на видео (например, элемента плейлиста или результата поиска), составляет 120 пикселей, а высота – 90 пикселей. По умолчанию значок канала имеет размер 88 x 88 пикселей. medium – версия значка с более высоким разрешением. Для видео (или ресурса, который ссылается на видео) это изображение имеет ширину 320 пикселей и высоту 180 пикселей. Для канала размер изображения составляет 240 x 240 пикселей. high – версия значка в высоком разрешении. Для видео (или ресурса, который ссылается на видео) размер изображения составляет 480 x 360 пикселей. Для канала это изображение размером 800 x 800 пикселей.
subscriberSnippet.thumbnails.(key).url	string URL изображения.
subscriberSnippet.thumbnails.(key).width	unsigned integer Ширина изображения.
subscriberSnippet.thumbnails.(key).height	unsigned integer Высота изображения.