YouTube Reporting

This data source connector uses the YouTube Reporting API to create and run reports that provide insights into the performance of your YouTube content. It enables the automation of data retrieval from YouTube Analytics.


  1. Log in to your account using the Authorize Account button.
  2. If applicable, check the Use Content Owner ID checkbox and specify the Content Owner ID parameter.
    • This parameter indicates that the request’s authorization credentials identify a YouTube CMS user who is acting on behalf of the content owner specified in the parameter value. This parameter is intended for YouTube content partners who own and manage many YouTube channels. It allows content owners to authenticate once and get access to all their video and channel data without providing authentication credentials for each channel. The CMS account the user authenticates with must be linked to the specified YouTube content owner.
  3. Select the desired reports in the configuration. For a complete list of supported reports, see the Supported Reports section.

Supported Reports

The connector allows you to run the following reports. The full list of supported reports is available in the YouTube Reporting API documentation.

Channel Reports

Content Owner Reports

Functionality Notes

  • The component uses the YouTube Reporting API to create and run reports that measure the results of YouTube advertising campaigns.
  • All reports are downloaded incrementally and “upserted” into the destination table.
  • IMPORTANT: The reporting service creates standardised reports every 24 hours. Each report type has one job associated with it. Multiple report versions may be associated with a single job. Each report covers data for one 24-hour period. More than one report may be generated for each 24-hour period. It is advisable to only consider the most recent report (based on the report’s createTime) for each 24-hour period.
    • During the first execution, if there is no job for the specified report_type yet, the job is created and no data is downloaded. The first report may take up to 24 hours to be available.