Эта страница переведена с помощью Cloud Translation API.

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