YouTube Analytics
App · 8 actions
Query channel analytics and manage YouTube Analytics groups and their items.
Actions
| Action | What it does |
|---|---|
| Add group item | Add group item in YouTube Analytics. |
| Create group | Create group in YouTube Analytics. |
| Delete group | Delete group in YouTube Analytics. |
| List group items | List group items in YouTube Analytics. |
| List groups | List groups in YouTube Analytics. |
| Query report | Query compatible YouTube Analytics metrics and dimensions. |
| Remove group item | Remove group item in YouTube Analytics. |
| Update group | Update group in YouTube Analytics. |
Add group item
Add group item in YouTube Analytics.
Inputs
- Group
group_idtextRequired - Group id.
- Resource ID
resource_idtextRequired - Resource id.
- Resource type
resource_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
- Title
titletextRequired - Title.
- Resource type
resource_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
- Group
group_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
- Group
group_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 token
page_tokentext - Page token.
- On behalf of content owner
on_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
- Ids
idstextRequired - Channel owner: channel==MINE, or contentOwner==OWNER_ID for an approved content owner.
- Start date
start_datedateRequired - Start date.
- End date
end_datedateRequired - End date.
- Metrics
metricslistRequired - Metrics.One or more of:
views,estimatedMinutesWatched,averageViewDuration,averageViewPercentage,likes,dislikes,comments,shares,subscribersGained,subscribersLost. - Dimensions
dimensionslist - Dimensions.One or more of:
day,month,video,country,continent,subContinent,province,ageGroup,gender,deviceType, and 3 more. - Filters
filterstext - Filters.
- Sort
sorttext - Sort.
- Max results
max_resultsnumber - Max results.At least 1.
- Start index
start_indexnumber - Start index.At least 1.
- Include historical channel data
include_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 ID
item_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
- Group
group_idtextRequired - Group id.
- Title
titletextRequired - 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
}