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