Groups

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

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

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

Methods

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

list

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

挿入

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
  }
}

プロパティ

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