Custom Report

The Custom Report can be used to request and retrieve custom reports containing YouTube Analytics data. These reports are supported for channels and for content owners.

You can read more about this end-point on the YouTube Analytics API documentation page here

Configuring the Credentials

Select the account credentials which has access to relevant YouTube Analytics data from the dropdown menu & Click Next

Credentials not listed in dropdown ?

Click on + Add New for adding new credentials

Data Pipelines Details

Data Pipeline

Select _ Custom Report_ from the dropdown

youtube analytics custom report list

Select the dimensions that you would like to fetch from the YouTube platform.


Select the metrics that you would like to fetch from the YouTube platform.


Not all dimensions and metrics can be queried together. Only certain dimensions and metrics can be used together to create valid combinations. Testing the query before configuring the pipeline will ensure combinations are valid and help to avoid any surprises.

Use these Google resources to pick your metrics and dimensions:

  1. Review the descriptions of various metrics here.

  2. Review the descriptions of various dimensions here.

  3. Use the Google APIs Explorer tool to test the validity of the desired combination of dimensions and metrics.

youtube analytics custom report config1

Setting Parameters

Parameter Description Values

Start Date


Indicate the start date from which you wish to begin processing the YouTube Analytics data files.. You can only configure this parameter while setting up a new pipeline.

Select a date from which you want to process the data files



Specify the filters that should be applied when retrieving YouTube Analytics data. Applying filters restricts the result set to include data that satisfies the filter. If using multiple filters, use a semicolon (;) to separate them.

Specify how the report data will be filtered.



To determine the sort order for YouTube Analytics data.

Specify how the report data will be sorted.

Max Results Per Page


Indicate the maximum number of rows (per page) to include in the response.

Number of rows

youtube analytics custom report config2

Datapipeline Scheduling

Scheduling specifies the frequency with which data will get updated in the data warehouse. You can choose between Manual Run, Normal Scheduling or Advance Scheduling.

Manual Run

If scheduling is not required, you can use the toggle to run the pipeline manually.

Normal Scheduling

Use the dropdown to select an interval-based hourly, monthly, weekly, or daily frequency.

Advance Scheduling

Set schedules fine-grained at the level of Months, Days, Hours, and Minutes.

Detailed explanation on scheduling of pipelines can be found here

Dataset & Name

Dataset Name

Key in the Dataset Name(also serves as the table name in your data warehouse).Keep in mind, that the name should be unique across the account and the data source. Special characters (except underscore _) and blank spaces are not allowed. It is best to follow a consistent naming scheme for future search to locate the tables.

Dataset Description

Enter a short description (optional) describing the dataset being fetched by this particular pipeline.


Choose the events for which you’d like to be notified: whether "ERROR ONLY" or "ERROR AND SUCCESS".

Once you have finished click on Finish to save it. Read more about naming and saving your pipelines including the option to save them as templates here

Still have Questions?

We’ll be happy to help you with any questions you might have! Send us an email at

Subscribe to our Newsletter for latest updates at DataChannel.