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. channelTitle	string Название канала, которому принадлежит подписка.
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 пикселей и высоту 88 пикселей. medium — версия миниатюры с более высоким разрешением. Для видео (или ресурса, который ссылается на видео), это изображение имеет ширину 320 пикселей и высоту 180 пикселей. Для канала это изображение имеет ширину 240 пикселей и высоту 240 пикселей. high — версия миниатюры с высоким разрешением. Для видео (или ресурса, который ссылается на видео), это изображение имеет ширину 480 пикселей и высоту 360 пикселей. Для канала это изображение имеет ширину 800 пикселей и высоту 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 пикселей и высоту 88 пикселей. medium — версия миниатюры с более высоким разрешением. Для видео (или ресурса, который ссылается на видео), это изображение имеет ширину 320 пикселей и высоту 180 пикселей. Для канала это изображение имеет ширину 240 пикселей и высоту 240 пикселей. high — версия миниатюры с высоким разрешением. Для видео (или ресурса, который ссылается на видео), это изображение имеет ширину 480 пикселей и высоту 360 пикселей. Для канала это изображение имеет ширину 800 пикселей и высоту 800 пикселей.
subscriberSnippet.thumbnails.(key). url	string URL изображения.
subscriberSnippet.thumbnails.(key). width	unsigned integer Ширина изображения.
subscriberSnippet.thumbnails.(key). height	unsigned integer Высота изображения.