YouTube Reporting API Services Now Generates Ad Revenue Reports

A set of automatically generated set of system-managed ad revenue reports are available to eligible YouTube Partners via the YouTube Reporting API.

Share online:

As on Nov. 8th, a set of system-managed ad revenue reports are now available to YouTube content owners via the YouTube Reporting API.

These system-managed reports maintain the same breakdowns as previously manually downloadable reports, but the "schema is optimized to align to other reports available via this API," Google said.

Since, these reports are generated automatically, eligible YouTube partners can see themselves whether the reports are available for them and download the reports.

Further Google notes, that in the coming weeks, more reports are coming via the YouTube Reporting API service.

If you are not aware, "YouTube Reporting API was launched last year, and generates a set of predefined reports of YouTube Analytics data for content owners, as CSV files. Once activated, reports are generated regularly, and each one contains data for a unique, 24-hour period."

Client libraries exist for many different programming languages to help you use the YouTube Reporting API.

Client libraries for programming languages such as Java, PHP, and Python helps getting started, and by using API Explorer, you can try out sample calls before writing any code.

Below you can go through the steps to check for the new reports availability, and download steps.

Check what new report types are available to you (verbatim)

  • Get an OAuth token (authentication credentials)
  • Call the reportTypes.list method with the includeSystemManaged parameter set to true.
  • The response lists all report types available to you. As you can't use the new report types to create reporting jobs yourself, their systemManaged property is set to true.

See system-managed reports created for you

  • Get an OAuth token (authentication credentials)
  • Call the jobs.list method with the includeSystemManaged parameter set to true. This will return a list of the available reporting jobs. All jobs with the systemManaged property set to true are jobs for the new report types.
  • Store the IDs of the jobs you want download reports for.

Download reports

  • Get an OAuth token (authentication credentials)
  • Call the reports.list method with the jobId parameter set to the ID found in the previous section to retrieve a list of downloadable reports created by that job.
  • Choose a report from the list and download it using its downloadUrl, google explained.

v2.7 of the DCM/DFA Reporting and Trafficking API released today introduces a number of video trafficking workflow enhancements, including: "New configuration options for in-stream video creatives," "Placement-level controls for companion creatives, skip buttons, and transcodes," "Site-level video settings, which automatically apply to new placements."

In addition, in accordance with deprecation schedule, the v2.6 will sunset on May 31st, 2017, Google said. After this date, "any requests made against v2.6 will begin returning errors," added Google.

Additionally, API v2.4 will be sunset on November 30th, 2016, Google reminded us.