Method jobs.get
Stay organized with collections
Save and categorize content based on your preferences.
Retrieves information about a specific reporting job that has been scheduled for a channel or content owner.
Request
HTTP request
GET https://youtubereporting.googleapis.com/v1/jobs/{jobId}
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 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 Job resource.
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2025-02-24 UTC.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-02-24 UTC."],[[["This endpoint retrieves details about a specific reporting job identified by its `jobId`."],["Authorization is required for all requests, using either `https://www.googleapis.com/auth/yt-analytics.readonly` or `https://www.googleapis.com/auth/yt-analytics-monetary.readonly` scopes."],["The `jobId` is a required path parameter, identifying the specific job to retrieve."],["The optional `onBehalfOfContentOwner` query parameter specifies the content owner for the request, otherwise defaults to the user's channel."],["A successful request returns a `Job` resource in the response body, and the request body itself must be empty."]]],["The content details retrieving a scheduled reporting job's information via the YouTube Reporting API. A `GET` request is made to `https://youtubereporting.googleapis.com/v1/jobs/{jobId}` using OAuth 2.0 authorization. The request requires a `jobId` path parameter and can include an optional `onBehalfOfContentOwner` query parameter. Authorization requires specific scopes like `yt-analytics.readonly` or `yt-analytics-monetary.readonly`. A successful request returns a `Job` resource, and the request body must remain empty.\n"]]
