このページは Cloud Translation API によって翻訳されました。

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

プロパティ

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

プロパティ
`kind`	`string` API リソースのタイプを識別します。値は `youtube#group` です。
`etag`	`etag` このリソースの Etag。
`id`	`string` グループを一意に識別するために YouTube によって使用される ID。
`snippet`	`object` `snippet` オブジェクトには、作成日や名前などのグループに関する基本情報が含まれます。
`snippet.publishedAt`	`datetime` グループが作成された日時。値は ISO 8601（`YYYY-MM-DDThh:mm:ss.sZ`）形式で指定します。
`snippet.title`	`string` グループ名。この値は、空でない文字列でなければなりません。
`contentDetails`	`object` `contentDetails` オブジェクトには、含まれるアイテムの数や種類など、グループに関する追加情報が含まれます。
`contentDetails.itemCount`	`unsigned long` グループ内のアイテムの数。
`contentDetails.itemType`	`string` グループに含まれるリソースのタイプ。このプロパティの有効な値は次のとおりです。 `youtube#channel` `youtube#playlist` `youtube#video` `youtubePartner#asset`