Playlists

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

YouTube では、再生リストを使用して、チャンネルの特別な動画コレクションを特定することもできます。たとえば、次のようなものです。

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

メソッド

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

list

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

insert

プレイリストを作成します。今すぐ試す

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

プロパティ

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