YouTube Analytics

App · 8 actions

Query channel analytics and manage YouTube Analytics groups and their items.

Actions

ActionWhat it does
Add group itemAdd group item in YouTube Analytics.
Create groupCreate group in YouTube Analytics.
Delete groupDelete group in YouTube Analytics.
List group itemsList group items in YouTube Analytics.
List groupsList groups in YouTube Analytics.
Query reportQuery compatible YouTube Analytics metrics and dimensions.
Remove group itemRemove group item in YouTube Analytics.
Update groupUpdate group in YouTube Analytics.

Add group item

Add group item in YouTube Analytics.

Inputs

Groupgroup_idtextRequired
Group id.
Resource IDresource_idtextRequired
Resource id.
Resource typeresource_typetextRequired
Resource type.One of: youtube#video, youtube#channel, youtube#playlist.

Outputs

Response.

dataobject
A group item.
has_moretrue/false
Whether another page is available.
next_cursortext
Continuation token or offset to pass to the next request.
Example output
{
  "data": {
    "errors": {
      "code": "BAD_REQUEST",
      "error": [],
      "requestId": "Example"
    },
    "etag": "Example",
    "groupId": "Example",
    "id": "Example",
    "kind": "Example",
    "resource": {
      "id": "Example",
      "kind": "Example"
    }
  },
  "has_more": false,
  "next_cursor": null
}

Create group

Create group in YouTube Analytics.

Inputs

TitletitletextRequired
Title.
Resource typeresource_typetextRequired
Resource type.One of: youtube#video, youtube#channel, youtube#playlist.

Outputs

Response.

dataobject
A group.
has_moretrue/false
Whether another page is available.
next_cursortext
Continuation token or offset to pass to the next request.
Example output
{
  "data": {
    "contentDetails": {
      "itemCount": "Example",
      "itemType": "Example"
    },
    "errors": {
      "code": "BAD_REQUEST",
      "error": [],
      "requestId": "Example"
    },
    "etag": "Example",
    "id": "Example",
    "kind": "Example",
    "snippet": {
      "publishedAt": "Example",
      "title": "Example"
    }
  },
  "has_more": false,
  "next_cursor": null
}

Delete group

Delete group in YouTube Analytics.

Inputs

Groupgroup_idtextRequired
Group id.

Outputs

Response.

dataobject
Empty response.
has_moretrue/false
Whether another page is available.
next_cursortext
Continuation token or offset to pass to the next request.
Example output
{
  "data": {
    "errors": {
      "code": "BAD_REQUEST",
      "error": [],
      "requestId": "Example"
    }
  },
  "has_more": false,
  "next_cursor": null
}

List group items

List group items in YouTube Analytics.

Inputs

Groupgroup_idtextRequired
Group id.

Outputs

Response.

dataobject
Response message for GroupsService.ListGroupItems.
has_moretrue/false
Whether another page is available.
next_cursortext
Continuation token or offset to pass to the next request.
Example output
{
  "data": {
    "errors": {
      "code": "BAD_REQUEST",
      "error": [],
      "requestId": "Example"
    },
    "etag": "Example",
    "items": [],
    "kind": "Example"
  },
  "has_more": false,
  "next_cursor": null
}

List groups

List groups in YouTube Analytics.

Inputs

Page tokenpage_tokentext
Page token.
On behalf of content owneron_behalf_of_content_ownertext
On behalf of content owner.

Outputs

Response.

dataobject
Response message for GroupsService.ListGroups.
has_moretrue/false
Whether another page is available.
next_cursortext
Continuation token or offset to pass to the next request.
Example output
{
  "data": {
    "errors": {
      "code": "BAD_REQUEST",
      "error": [],
      "requestId": "Example"
    },
    "etag": "Example",
    "items": [],
    "kind": "Example",
    "nextPageToken": "Example"
  },
  "has_more": false,
  "next_cursor": null
}

Query report

Query compatible YouTube Analytics metrics and dimensions. The API validates supported combinations; recent days may not yet be available.

Inputs

IdsidstextRequired
Channel owner: channel==MINE, or contentOwner==OWNER_ID for an approved content owner.
Start datestart_datedateRequired
Start date.
End dateend_datedateRequired
End date.
MetricsmetricslistRequired
Metrics.One or more of: views, estimatedMinutesWatched, averageViewDuration, averageViewPercentage, likes, dislikes, comments, shares, subscribersGained, subscribersLost.
Dimensionsdimensionslist
Dimensions.One or more of: day, month, video, country, continent, subContinent, province, ageGroup, gender, deviceType, and 3 more.
Filtersfilterstext
Filters.
Sortsorttext
Sort.
Max resultsmax_resultsnumber
Max results.At least 1.
Start indexstart_indexnumber
Start index.At least 1.
Include historical channel datainclude_historical_channel_datatrue/false
Include historical channel data.

Outputs

Response.

dataobject
Response message for TargetedQueriesService.Query.
has_moretrue/false
Whether another page is available.
next_cursortext
Continuation token or offset to pass to the next request.
Example output
{
  "data": {
    "columnHeaders": [],
    "errors": {
      "code": "BAD_REQUEST",
      "error": [],
      "requestId": "Example"
    },
    "kind": "Example",
    "rows": []
  },
  "has_more": false,
  "next_cursor": null
}

Remove group item

Remove group item in YouTube Analytics.

Inputs

Item IDitem_idtextRequired
Item id.

Outputs

Response.

dataobject
Empty response.
has_moretrue/false
Whether another page is available.
next_cursortext
Continuation token or offset to pass to the next request.
Example output
{
  "data": {
    "errors": {
      "code": "BAD_REQUEST",
      "error": [],
      "requestId": "Example"
    }
  },
  "has_more": false,
  "next_cursor": null
}

Update group

Update group in YouTube Analytics.

Inputs

Groupgroup_idtextRequired
Group id.
TitletitletextRequired
Title.

Outputs

Response.

dataobject
A group.
has_moretrue/false
Whether another page is available.
next_cursortext
Continuation token or offset to pass to the next request.
Example output
{
  "data": {
    "contentDetails": {
      "itemCount": "Example",
      "itemType": "Example"
    },
    "errors": {
      "code": "BAD_REQUEST",
      "error": [],
      "requestId": "Example"
    },
    "etag": "Example",
    "id": "Example",
    "kind": "Example",
    "snippet": {
      "publishedAt": "Example",
      "title": "Example"
    }
  },
  "has_more": false,
  "next_cursor": null
}

On this page