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 пикселей и высоту 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
Высота изображения.