Playlists

Ресурс playlist представляет собой список воспроизведения YouTube. Плейлист — это набор видео, которые можно просматривать последовательно и делиться ими с другими пользователями. По умолчанию списки воспроизведения общедоступны для других пользователей, но списки воспроизведения могут быть общедоступными или частными.

YouTube также использует плейлисты для определения специальных коллекций видео для канала, таких как:

• загруженные видео
• видео с положительной оценкой (понравилось)

Чтобы быть более конкретным, эти списки связаны с каналом, который представляет собой набор видео, плейлистов и другой информации YouTube о человеке, группе или компании. Вы можете получить идентификаторы списков воспроизведения для каждого из этих списков из channel resource для данного канала.

Затем вы можете использовать метод playlistItems.list для получения любого из этих списков. Вы также можете добавлять или удалять элементы из этих списков, вызывая методы playlistItems.insert и playlistItems.delete .

Методы

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

list

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

insert

Создает плейлист. Попробуйте прямо сейчас .

update

Изменяет список воспроизведения. Например, вы можете изменить название, описание или статус конфиденциальности плейлиста. Попробуйте прямо сейчас .

delete

Удаляет плейлист. Попробуйте прямо сейчас .

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

Следующая структура JSON показывает формат ресурса playlists :

{
  "kind": "youtube#playlist",
  "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,
    "defaultLanguage": string,
    "localized": {
      "title": string,
      "description": string
    }
  },
  "status": {
    "privacyStatus": string
  },
  "contentDetails": {
    "itemCount": unsigned integer
  },
  "player": {
    "embedHtml": string
  },
  "localizations": {
    (key): {
      "title": string,
      "description": string
    }
  }
}

Характеристики

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

Характеристики
kind	string Идентифицирует тип ресурса API. Значение будет youtube#playlist .
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 пикселей и высоту 88 пикселей. medium — версия миниатюры с более высоким разрешением. Для видео (или ресурса, который ссылается на видео), это изображение имеет ширину 320 пикселей и высоту 180 пикселей. Для канала это изображение имеет ширину 240 пикселей и высоту 240 пикселей. high — версия миниатюры с высоким разрешением. Для видео (или ресурса, который ссылается на видео), это изображение имеет ширину 480 пикселей и высоту 360 пикселей. Для канала это изображение имеет ширину 800 пикселей и высоту 800 пикселей. standard — версия эскиза с еще более высоким разрешением, чем изображение high разрешением. Это изображение доступно для некоторых видео и других ресурсов, которые ссылаются на видео, таких как элементы плейлиста или результаты поиска. Это изображение имеет ширину 640 пикселей и высоту 480 пикселей. maxres — версия миниатюры с самым высоким разрешением. Этот размер изображения доступен для некоторых видео и других ресурсов, которые ссылаются на видео, таких как элементы плейлиста или результаты поиска. Это изображение имеет ширину 1280 пикселей и высоту 720 пикселей.
snippet.thumbnails.(key). url	string URL изображения.
snippet.thumbnails.(key). width	unsigned integer Ширина изображения.
snippet.thumbnails.(key). height	unsigned integer Высота изображения.
snippet. channelTitle	string Название канала, которому принадлежит видео.
snippet. tags[]	list Это свойство устарело. Теги ключевых слов, связанные с плейлистом.
snippet. defaultLanguage	string Язык текста в свойствах snippet.title и snippet.description ресурса playlist .
snippet. localized	object Объект snippet.localized содержит либо локализованный заголовок и описание списка воспроизведения, либо заголовок на языке по умолчанию для метаданных списка воспроизведения. Локализованный текст возвращается во фрагменте ресурса, если в запросе playlists.list использовался параметр hl для указания языка, для которого должен быть возвращен локализованный текст , и локализованный текст доступен на этом языке. Метаданные для языка по умолчанию возвращаются, если значение параметра hl не указано или значение указано, но локализованные метаданные для указанного языка недоступны. Свойство содержит значение только для чтения. Используйте объект localizations для добавления, обновления или удаления локализованных заголовков.
snippet.localized. title	string Название локализованного плейлиста.
snippet.localized. description	string Описание локализованного плейлиста.
status	object Объект status содержит информацию о состоянии списка воспроизведения.
status. privacyStatus	string Статус конфиденциальности плейлиста. Допустимые значения для этого свойства: private public unlisted
contentDetails	object Объект contentDetails содержит информацию о содержимом списка воспроизведения, включая количество видео в списке воспроизведения.
contentDetails. itemCount	unsigned integer Количество видео в плейлисте.
player	object Объект player содержит информацию, которую можно использовать для воспроизведения списка воспроизведения во встроенном проигрывателе.
player. embedHtml	string Тег <iframe> , в который встроен проигрыватель, который будет воспроизводить плейлист.
localizations	object Объект localizations инкапсулирует переводы метаданных списка воспроизведения.
localizations. (key)	object Язык локализованного текста, связанного со значением ключа. Значение представляет собой строку, содержащую код языка BCP-47 .
localizations.(key). title	string Название локализованного плейлиста.
localizations.(key). description	string Описание локализованного плейлиста.