PlaylistItems

Ресурс playlistItem идентифицирует другой ресурс, например видео, включенное в плейлист. Кроме того, ресурс playlistItem содержит сведения о включенном ресурсе, которые относятся к тому, как он используется в плейлисте.

На YouTube плейлисты также используются для того, чтобы показывать список загруженных видео на канале. Каждое playlistItem в этом списке представляет собой одно загруженное видео. Идентификатор плейлиста для этого списка можно получить из ресурса channel для определенного канала. Затем вы можете использовать метод playlistItems.list для списка.

Методы

API поддерживает следующие методы для ресурсов playlistItems:

list

Возвращает коллекцию объектов playlistItem, соответствующих параметрам запроса к API. Вы можете получить все элементы из определенного плейлиста или один или несколько элементов по их уникальным идентификаторам. Перейти

insert

Добавляет ресурс в плейлист. Перейти

update

Изменяет элемент плейлиста. Например, вы можете изменить позицию объекта в плейлисте. Перейти

delete

Удаляет элемент плейлиста. Перейти

Представление ресурса

Ниже показана структура JSON для ресурса playlistItems.

{
  "kind": "youtube#playlistItem",
  "etag": etag,
  "id": string,
  "snippet": {
    "publishedAt": datetime,
    "channelId": string,
    "title": string,
    "description": string,
    "thumbnails": {
      (key): {
        "url": string,
        "width": unsigned integer,
        "height": unsigned integer
      }
    },
    "channelTitle": string,
    "videoOwnerChannelTitle": string,
    "videoOwnerChannelId": string,
    "playlistId": string,
    "position": unsigned integer,
    "resourceId": {
      "kind": string,
      "videoId": string,
    }
  },
  "contentDetails": {
    "videoId": string,
    "startAt": string,
    "endAt": string,
    "note": string,
    "videoPublishedAt": datetime
  },
  "status": {
    "privacyStatus": string
  }
}

Свойства

В таблице ниже приведены свойства, которые используются в этом ресурсе.

Свойства
kind	string Определяет тип ресурса API. Значение будет youtube#playlistItem.
etag	etag Тег Etag этого ресурса.
id	string Идентификатор, который YouTube использует для уникальной идентификации элемента плейлиста.
snippet	object Объект snippet содержит основную информацию об элементе плейлиста, например его название и позицию в плейлисте.
snippet.publishedAt	datetime Дата и время добавления объекта в плейлист. Значение указывается в формате ISO 8601.
snippet.channelId	string Идентификатор, который YouTube использует для уникальной идентификации пользователя, добавившего объект в плейлист.
snippet.title	string Название товара.
snippet.description	string Описание товара.
snippet.thumbnails	object Карта изображений, связанных с элементом плейлиста. Для каждого объекта на карте ключ – это название значка, а значение – это объект, который содержит другую информацию о значке.
snippet.thumbnails.(key)	object Допустимые значения ключей: default – уменьшенное изображение по умолчанию. Ширина стандартного значка видео или ресурса, который ссылается на видео (например, элемента плейлиста или результата поиска), составляет 120 пикселей, а высота – 90 пикселей. По умолчанию значок канала имеет размер 88 x 88 пикселей. medium – значок в более высоком разрешении. Для видео (или ресурса, который ссылается на видео) это изображение имеет ширину 320 пикселей и высоту 180 пикселей. Для канала размер изображения составляет 240 x 240 пикселей. high – значок в высоком разрешении. Для видео (или ресурса, который ссылается на видео) это изображение имеет ширину 480 пикселей и высоту 360 пикселей. Для канала размер изображения составляет 800 x 800 пикселей. standard – версия значка с более высоким разрешением, чем high. Это изображение доступно для некоторых видео и других ресурсов, которые ссылаются на видео, например элементов плейлиста или результатов поиска. Ширина этого изображения – 640 пикселей, а высота – 480 пикселей. maxres – версия значка в высоком разрешении. Такой размер доступен для некоторых видео и других ресурсов, связанных с видео, например элементов плейлистов или результатов поиска. Ширина изображения – 1280 пикселей, высота – 720 пикселей. fhd – значок в формате Full HD (1080p). Такой размер доступен для некоторых видео. Размер изображения – 1920 x 1080 пикселей. qhd – значок в разрешении Quad HD (1440p / 2K). Этот размер доступен для некоторых видео. Размер этого изображения – 2560 x 1440 пикселей. uhd – значок с ультравысоким разрешением (4K). Этот размер доступен для некоторых видео. Ширина этого изображения – 3840 пикселей, а высота – 2160 пикселей.
snippet.thumbnails.(key).url	string URL изображения.
snippet.thumbnails.(key).width	unsigned integer Ширина изображения.
snippet.thumbnails.(key).height	unsigned integer Высота изображения.
snippet.channelTitle	string Название канала, к которому относится объект плейлиста.
snippet.videoOwnerChannelTitle	string Название канала, на который загружено видео.
snippet.videoOwnerChannelId	string Идентификатор канала, на который загружено видео.
snippet.playlistId	string Идентификатор, который YouTube использует для уникальной идентификации плейлиста, в котором находится элемент плейлиста.
snippet.position	unsigned integer Порядок, в котором элемент появляется в плейлисте. Значение представляет собой индекс, начинающийся с нуля. Таким образом, первый элемент имеет позицию 0, второй – 1 и т. д.
snippet.resourceId	object Объект id содержит информацию, которая позволяет однозначно идентифицировать ресурс, включенный в плейлист в качестве элемента плейлиста.
snippet.resourceId.kind	string Тип ресурса, на который ссылается объект.
snippet.resourceId.videoId	string Если значение свойства snippet.resourceId.kind – youtube#video, то это свойство будет присутствовать, а его значение будет содержать идентификатор, который YouTube использует для уникальной идентификации видео в плейлисте.
contentDetails	object Объект contentDetails включается в ресурс, если добавленный элемент является видео YouTube. Объект содержит дополнительную информацию о видео.
contentDetails.videoId	string Идентификатор, который YouTube использует для уникальной идентификации видео. Чтобы получить ресурс video, задайте для параметра запроса id это значение в запросе к API.
contentDetails.startAt	string Примечание. Это свойство устарело, и если оно задано, его значение игнорируется. Время в секундах с начала видео, когда оно должно начать воспроизводиться. Владелец плейлиста может указать, с какого момента должно начинаться воспроизведение видео и на каком моменте оно должно заканчиваться. Значение по умолчанию: 0.
contentDetails.endAt	string Примечание. Это свойство устарело, и если оно задано, его значение игнорируется. Время в секундах с начала видео, когда оно должно остановиться. Владелец плейлиста может указать, с какого момента должно начинаться воспроизведение видео и на каком моменте оно должно заканчиваться. По умолчанию считается, что video.endTime – это конец видео.
contentDetails.note	string Примечание, созданное пользователем для этого объекта. Максимальная длина значения свойства – 280 символов.
contentDetails.videoPublishedAt	datetime Дата и время публикации видео на YouTube. Значение указывается в формате ISO 8601.
status	object Объект status содержит информацию о статусе конфиденциальности элемента плейлиста.
status.privacyStatus	string Статус конфиденциальности элемента плейлиста. Владелец канала, на который загружено видео, может задать это значение с помощью метода videos.insert или videos.update.