Ресурс playlist
представляет собой список воспроизведения 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 Допустимые значения ключей:
|
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 содержит либо локализованный заголовок и описание списка воспроизведения, либо заголовок на языке по умолчанию для метаданных списка воспроизведения.
localizations для добавления, обновления или удаления локализованных заголовков. |
snippet.localized. title | string Название локализованного плейлиста. |
snippet.localized. description | string Описание локализованного плейлиста. |
status | object Объект status содержит информацию о состоянии списка воспроизведения. |
status. privacyStatus | string Статус конфиденциальности плейлиста. Допустимые значения для этого свойства:
|
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 Описание локализованного плейлиста. |