Ресурс 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 | 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 Статус конфиденциальности плейлиста. Допустимые значения для этого свойства:
|
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 Локализованное описание плейлиста. |
Ресурс 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 | 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 Статус конфиденциальности плейлиста. Допустимые значения для этого свойства:
|
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 Локализованное описание плейлиста. |