PlaylistItems

Ресурс playlistItem идентифицирует другой ресурс, например видео, включённый в плейлист. Кроме того, ресурс playlistItem содержит сведения о включённом ресурсе, относящиеся конкретно к тому, как этот ресурс используется в данном плейлисте.

YouTube также использует плейлист для идентификации списка загруженных видео на канале, при этом каждый playlistItem в этом списке представляет одно загруженное видео. Идентификатор плейлиста для этого списка можно получить из ресурса channel для данного канала. Затем можно использовать метод playlistItems.list для доступа к списку.

Методы

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

list

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

insert

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

update

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

delete

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

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

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

{
  "kind": "youtube#playlistItem",
  "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,
    "videoOwnerChannelTitle": string,
    "videoOwnerChannelId": string,
    "playlistId": string,
    "position": unsigned integer,
    "resourceId": {
      "kind": string,
      "videoId": string,
    }
  },
  "contentDetails": {
    "videoId": string,
    "startAt": string,
    "endAt": string,
    "note": string,
    "videoPublishedAt": datetime
  },
  "status": {
    "privacyStatus": string
  }
}

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

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