PlaylistItems

playlistItem リソースは、再生リストに含まれている動画などの別のリソースを識別します。また playlistItem リソースには、特に、含まれているリソースが再生リストでどのように使用されるかに関連する、リソースについての詳細が含まれています。

YouTube は再生リストを使って、次に示すようなチャンネルごとの動画の特別なコレクションを識別します。

• アップロード動画
• お気に入りの動画
• 高く評価された動画
• 再生履歴
• 後で見る

メソッド

この API では、playlistItems リソースについて以下のメソッドがサポートされています。

list

API リクエストのパラメータに一致する、再生リストのアイテムのコレクションを返します。指定した再生リストのアイテムをすべて取得したり、一意の ID を指定して再生リストのアイテムを 1 つまたは複数取得したりできます。 今すぐ試す。

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,
    "playlistId": string,
    "position": unsigned integer,
    "resourceId": {
      "kind": string,
      "videoId": string,
    }
  },
  "contentDetails": {
    "videoId": string,
    "startAt": string,
    "endAt": string,
    "note": string
  },
  "status": {
    "privacyStatus": string
  }
}

プロパティ

次の表は、このリソースで使用されているプロパティの定義を示したものです。