Method jobs.delete
Stay organized with collections
Save and categorize content based on your preferences.
Request
HTTP request
DELETE 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 that is being deleted. |
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 will be empty.
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 is used to delete a reporting job using the YouTube Reporting API."],["Authorization is required using OAuth 2.0 and appropriate scopes, such as `https://www.googleapis.com/auth/yt-analytics.readonly` or `https://www.googleapis.com/auth/yt-analytics-monetary.readonly`."],["The `jobId` path parameter is mandatory, as it specifies the unique ID of the job to be deleted."],["The `onBehalfOfContentOwner` query parameter is optional and specifies the content owner for whom the request is made."],["A successful deletion results in an empty response body."]]],["This document details the process for deleting a reporting job via the YouTube Reporting API. A `DELETE` request is sent to the specified endpoint, using the `jobId` path parameter to identify the job. Authorization is required, with scopes for viewing analytics or monetary reports. An optional `onBehalfOfContentOwner` query parameter can be included to specify a content owner. The request body should be empty, and a successful response will also have an empty body.\n"]]
