Groups

  • A YouTube Analytics group is a custom collection of up to 500 channels, videos, playlists, or assets, all of the same resource type.

  • You can create, retrieve, update, and delete groups using the YouTube Analytics API methods.

  • Groups can only contain resources that you own, have claimed, or are linked to a channel you administer.

  • The group resource representation includes information such as the group's ID, title, creation date, item count, and item type.

  • Use the groupItems methods to manage the individual items within a group.

A group resource represents a YouTube Analytics group, which is a custom collection of up to 500 channels, videos, playlists, or assets.

All of the items in a group must represent the same type of resource. For example, you cannot create a group that contains 100 videos and 100 playlists.

An Analytics group can only contain resources that you have uploaded or claimed or that are linked to a channel that you administer. As a result, channel owners can create groups of videos and playlists. Content owners can create groups of videos, playlists, channels, or assets.

Methods

The API supports the following methods for groups resources:

list
Returns a list of groups that match the API request parameters. For example, you can retrieve all groups that the authenticated user owns, or you can retrieve one or more groups by their unique IDs. Try it now.
insert
Creates a YouTube Analytics group. After creating a group, use the groupItems.insert method to add items to the group. Try it now.
update
Modifies the metadata for a group. Currently, the only property that can be updated is the group's title. (Use the groupItems.insert and groupItems.delete to add and remove group items.) Try it now.
delete
Deletes a group. Try it now.

Resource representation

The JSON structure below shows the format of a groups resource:

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

Properties

The following table defines the properties that appear in this resource: