Ресурс 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,
"podcastStatus": enum
},
"contentDetails": {
"itemCount": unsigned integer
},
"player": {
"embedHtml": string
},
"localizations": {
(key): {
"title": string,
"description": string
}
}
}Характеристики
В следующей таблице описаны свойства, которые отображаются в этом ресурсе:
| Характеристики | |
|---|---|
kind | stringОпределяет тип ресурса API. Значение будет youtube#playlist . |
etag | etagEtag этого ресурса. |
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 | stringURL изображения. |
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Статус конфиденциальности плейлиста. Допустимые значения для этого свойства:
|
status. podcastStatus | stringСтатус плейлиста как подкаста. Если значение равно enabled , плейлист помечен как подкаст. Чтобы установить статус плейлиста как enabled , у плейлиста должно быть изображение плейлиста .Допустимые значения для этого свойства:
|
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Локализованное описание плейлиста. |