PlaylistItems

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

YouTube также использует список воспроизведения для определения списка загруженных видео на канале, причем каждый playlistItem в этом списке представляет одно загруженное видео. Вы можете получить идентификатор списка воспроизведения для этого списка из channel resource для данного канала. Затем вы можете использовать метод 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
  }
}

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

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