Method jobs.delete
Stay organized with collections
Save and categorize content based on your preferences.
AI-generated Key Takeaways
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.
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:
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.
[[["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-09-18 UTC."],[],["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"]]
