Groups

group リソースは、YouTube アナリティクス グループを表します。これは、最大 500 個のチャンネル、動画、再生リスト、アセットのカスタム コレクションです。

グループ内のすべての項目は、同じタイプのリソースを表す必要があります。たとえば、100 個の動画と 100 個の再生リストを含むグループを作成することはできません。

アナリティクス グループに含めることができるのは、自身がアップロードまたは申し立てたリソース、または自身が管理するチャンネルにリンクされているリソースのみです。これにより、チャンネル所有者は動画と再生リストのグループを作成できるようになります。コンテンツ所有者は、動画、再生リスト、チャンネル、アセットのグループを作成できます。

メソッド

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

list

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

insert

YouTube アナリティクス グループを作成します。グループを作成したら、groupItems.insert メソッドを使用してグループにアイテムを追加します。こちらから今すぐお試しください。

update

グループのメタデータを変更します。現在、更新できるプロパティはグループのタイトルのみです。（groupItems.insert と groupItems.delete を使用して、グループ項目を追加または削除します）。今すぐお試しください。

delete

グループを削除します。今すぐ試す

リソース表現

次の JSON 構造は、groups リソースの形式を示しています。

{
  "kind": "youtube#group",
  "etag": etag,
  "id": string,
  "snippet": {
    "publishedAt": datetime,
    "title": string
  },
  "contentDetails": {
    "itemCount": unsigned long,
    "itemType": string
  }
}

プロパティ

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