Playlists

playlist リソースは YouTube 再生リストを表します。再生リストとは、順序を付けて表示し、他のユーザーと共有できる動画のコレクションを指します。デフォルトでは再生リストは他のユーザーに一般公開されますが、一般公開または非公開にすることができます。

また、YouTube では再生リストを使って、チャンネルの以下のような特別な動画コレクションも特定しています。

• アップロード動画
• 高く評価された動画

Methods

API は、playlists リソースについて次のメソッドをサポートしています。

list

API リクエスト パラメータに一致するプレイリストのコレクションを返します。たとえば、認証済みユーザーが所有しているすべてのプレイリストを取得することも、一意の ID で 1 つ以上のプレイリストを取得することもできます。今すぐ試す

挿入

再生リストを作成します。 今すぐ試す

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
  },
  "contentDetails": {
    "itemCount": unsigned integer
  },
  "player": {
    "embedHtml": string
  },
  "localizations": {
    (key): {
      "title": string,
      "description": string
    }
  }
}

プロパティ

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