Method jobs.reports.get

  • This endpoint retrieves metadata for a specific report using its jobId and reportId.

  • Authorization is required for all requests, utilizing OAuth 2.0 and specific scopes like https://www.googleapis.com/auth/yt-analytics.readonly or https://www.googleapis.com/auth/yt-analytics-monetary.readonly.

  • Path parameters jobId and reportId are required to identify the job and the report being retrieved.

  • The onBehalfOfContentOwner query parameter allows specifying a content owner ID, otherwise, the request defaults to the user's own channel.

  • A successful response returns a Report resource containing the report's metadata.

Retrieves the metadata for a specific report.

Request

HTTP request

GET https://youtubereporting.googleapis.com/v1/jobs/{jobId}/reports/{reportId}

Authorization

All YouTube Reporting API requests must be authorized. The Authorization guide explains how to use the OAuth 2.0 protocol to retrieve authorization tokens.

YouTube Reporting API requests use the following authorization scopes:

Scopes
https://www.googleapis.com/auth/yt-analytics.readonly View YouTube Analytics reports for your YouTube content. This scope provides access to user activity metrics, like view counts and rating counts.
https://www.googleapis.com/auth/yt-analytics-monetary.readonly View YouTube Analytics monetary reports for your YouTube content. This scope provides access to user activity metrics and to estimated revenue and ad performance metrics.

Parameters

Path parameters

Parameters
jobId string
The ID that YouTube uses to uniquely identify the job associated with the report that is being retrieved.
reportId string
The ID that YouTube uses to uniquely identify the report that is being retrieved.

Query parameters

Parameters
onBehalfOfContentOwner string
The ID of the content owner for whom the API request is being made. If the request does not specify a value for this parameter, the API server assumes that the request is being made for the user's own channel.

Request body

The request body must be empty.

Response

If successful, the response body contains a Report resource.

Try it!