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,
    "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
Допустимые ключевые значения:
  • 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
status. podcastStatus string
Статус подкаста плейлиста. Если значение enabled , список воспроизведения помечается как подкаст. Чтобы установить статус подкаста в списке воспроизведения на enabled , в списке воспроизведения должно быть изображение списка воспроизведения .

Допустимые значения для этого свойства:
  • enabled
  • disabled
  • unspecified
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 также использует плейлисты для определения специальных коллекций видео для канала, например:

  • загруженные видео
  • видео с положительной оценкой (лайками)
Точнее, эти списки связаны с каналом, который представляет собой набор видеороликов, плейлистов и другой информации 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
Допустимые ключевые значения:
  • 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
status. podcastStatus string
Статус подкаста плейлиста. Если значение enabled , список воспроизведения помечается как подкаст. Чтобы установить статус подкаста в списке воспроизведения на enabled , в списке воспроизведения должно быть изображение списка воспроизведения .

Допустимые значения для этого свойства:
  • enabled
  • disabled
  • unspecified
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
Локализованное описание плейлиста.