Ресурс 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 Допустимые ключевые значения:
|
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 Тип активности, для которого предназначена эта подписка (только загрузка, все). Допустимые значения для этого свойства:
|
subscriberSnippet | object Объект subscriberSnippet содержит основные сведения о подписчике. |
subscriberSnippet. title | string Название канала подписчика. |
subscriberSnippet. description | string Описание канала подписчика. |
subscriberSnippet. channelId | string Идентификатор, который YouTube присваивает для уникальной идентификации канала подписчика. |
subscriberSnippet. thumbnails | object Миниатюры изображений для канала подписчика. |
subscriberSnippet.thumbnails. (key) | object Допустимые ключевые значения:
|
subscriberSnippet.thumbnails.(key). url | string URL-адрес изображения. |
subscriberSnippet.thumbnails.(key). width | unsigned integer Ширина изображения. |
subscriberSnippet.thumbnails.(key). height | unsigned integer Высота изображения. |