# YouTube Analytics

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

App · 8 actions. Web page: https://docs.lodol.com/docs/integrations/youtube-analytics

## Actions

### Add group item

Add group item in YouTube Analytics.

**Inputs**

- Group (`group_id`, text, required): Group id.
- Resource ID (`resource_id`, text, required): Resource id.
- Resource type (`resource_type`, text, required): Resource type. One of: `youtube#video`, `youtube#channel`, `youtube#playlist`.

**Outputs**: Response.

- `data` (object): A group item.
- `has_more` (true/false): Whether another page is available.
- `next_cursor` (text): Continuation token or offset to pass to the next request.

**Example output**

```json
{
  "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 (`title`, text, required): Title.
- Resource type (`resource_type`, text, required): Resource type. One of: `youtube#video`, `youtube#channel`, `youtube#playlist`.

**Outputs**: Response.

- `data` (object): A group.
- `has_more` (true/false): Whether another page is available.
- `next_cursor` (text): Continuation token or offset to pass to the next request.

**Example output**

```json
{
  "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_id`, text, required): Group id.

**Outputs**: Response.

- `data` (object): Empty response.
- `has_more` (true/false): Whether another page is available.
- `next_cursor` (text): Continuation token or offset to pass to the next request.

**Example output**

```json
{
  "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_id`, text, required): Group id.

**Outputs**: Response.

- `data` (object): Response message for GroupsService.ListGroupItems.
- `has_more` (true/false): Whether another page is available.
- `next_cursor` (text): Continuation token or offset to pass to the next request.

**Example output**

```json
{
  "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_token`, text): Page token.
- On behalf of content owner (`on_behalf_of_content_owner`, text): On behalf of content owner.

**Outputs**: Response.

- `data` (object): Response message for GroupsService.ListGroups.
- `has_more` (true/false): Whether another page is available.
- `next_cursor` (text): Continuation token or offset to pass to the next request.

**Example output**

```json
{
  "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 (`ids`, text, required): Channel owner: channel==MINE, or contentOwner==OWNER_ID for an approved content owner.
- Start date (`start_date`, date, required): Start date.
- End date (`end_date`, date, required): End date.
- Metrics (`metrics`, list, required): Metrics. One or more of: `views`, `estimatedMinutesWatched`, `averageViewDuration`, `averageViewPercentage`, `likes`, `dislikes`, `comments`, `shares`, `subscribersGained`, `subscribersLost`.
- Dimensions (`dimensions`, list): Dimensions. One or more of: `day`, `month`, `video`, `country`, `continent`, `subContinent`, `province`, `ageGroup`, `gender`, `deviceType`, and 3 more.
- Filters (`filters`, text): Filters.
- Sort (`sort`, text): Sort.
- Max results (`max_results`, number): Max results. At least 1.
- Start index (`start_index`, number): Start index. At least 1.
- Include historical channel data (`include_historical_channel_data`, true/false): Include historical channel data.

**Outputs**: Response.

- `data` (object): Response message for TargetedQueriesService.Query.
- `has_more` (true/false): Whether another page is available.
- `next_cursor` (text): Continuation token or offset to pass to the next request.

**Example output**

```json
{
  "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_id`, text, required): Item id.

**Outputs**: Response.

- `data` (object): Empty response.
- `has_more` (true/false): Whether another page is available.
- `next_cursor` (text): Continuation token or offset to pass to the next request.

**Example output**

```json
{
  "data": {
    "errors": {
      "code": "BAD_REQUEST",
      "error": [],
      "requestId": "Example"
    }
  },
  "has_more": false,
  "next_cursor": null
}
```

### Update group

Update group in YouTube Analytics.

**Inputs**

- Group (`group_id`, text, required): Group id.
- Title (`title`, text, required): Title.

**Outputs**: Response.

- `data` (object): A group.
- `has_more` (true/false): Whether another page is available.
- `next_cursor` (text): Continuation token or offset to pass to the next request.

**Example output**

```json
{
  "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
}
```
