Playlists

playlist リソースは 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
    }
  }
}

プロパティ

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