PlaylistItems

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

YouTube では、再生リストを使用してチャンネルのアップロード済み動画のリストを識別します。リスト内の各 playlistItem は、アップロード済み動画 1 つを表します。そのリストのプレイリスト ID は、特定のチャンネルの channel リソースから取得できます。その後、playlistItems.list メソッドをリストに使用できます。

メソッド

この 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,
    "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
  }
}

プロパティ

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