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 Высота изображения.