Jobs
Stay organized with collections
Save and categorize content based on your preferences.
A job
resource represents a scheduled reporting job. A reporting job identifies a specific report that YouTube generates each day for a particular channel or content owner.
Methods
The following table shows the methods that the API supports for job
resources.
Properties
The following table defines the properties that appear in this 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-08-20 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-08-20 UTC."],[[["\u003cp\u003eA reporting job in YouTube's API represents a scheduled task that generates a specific report daily for a channel or content owner.\u003c/p\u003e\n"],["\u003cp\u003eThe API supports creating, deleting, retrieving, and listing reporting jobs, enabling management of these scheduled reports.\u003c/p\u003e\n"],["\u003cp\u003eEach job is uniquely identified by an \u003ccode\u003eid\u003c/code\u003e, and it also specifies the type of report (\u003ccode\u003ereportTypeId\u003c/code\u003e), a descriptive \u003ccode\u003ename\u003c/code\u003e, creation timestamp (\u003ccode\u003ecreateTime\u003c/code\u003e), and expiration timestamp (\u003ccode\u003eexpireTime\u003c/code\u003e).\u003c/p\u003e\n"],["\u003cp\u003eJobs may have a \u003ccode\u003esystemManaged\u003c/code\u003e property that specifies if they are automatically managed by YouTube and unchangeable by content owners.\u003c/p\u003e\n"],["\u003cp\u003eThe reporting job contains an \u003ccode\u003eexpireTime\u003c/code\u003e, which dictates when the job will no longer produce reports, which can occur if reports have been deprecated, or haven't been downloaded for an extended period.\u003c/p\u003e\n"]]],["A `job` resource represents a scheduled YouTube reporting job, generating daily reports for a channel or content owner. You can `create` a job, instructing YouTube to produce a specific report daily, or `delete` an existing one. Use `get` to retrieve details about a specific job, and `list` to see all scheduled jobs. Jobs are identified by a unique `id` and linked to a specific `reportTypeId`. Job details include `name`, `createTime`, and potential `expireTime`. `systemManaged` jobs are automatically generated and cannot be modified.\n"],null,["# Jobs\n\nA **job** resource represents a scheduled reporting job. A reporting job identifies a specific report that YouTube generates each day for a particular channel or content owner.\n\nMethods\n-------\n\nThe following table shows the methods that the API supports for `job` resources.\n\n| Methods ||\n|---------------------------------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| [create](/youtube/reporting/v1/reference/rest/v1/jobs/create) | Creates a reporting job. By creating a reporting job, you are instructing YouTube to generate that report on a daily basis. The report is available within 24 hours of the time that the job is created. |\n| [delete](/youtube/reporting/v1/reference/rest/v1/jobs/delete) | Deletes a reporting job. |\n| [get](/youtube/reporting/v1/reference/rest/v1/jobs/get) | Retrieves information about a specific reporting job that has been scheduled for a channel or content owner. |\n| [list](/youtube/reporting/v1/reference/rest/v1/jobs/list) | Lists reporting jobs that have been scheduled for a channel or content owner. Each resource in the response contains an `id` property, which specifies the ID that YouTube uses to uniquely identify the job. You need that ID to retrieve the list of reports that have been generated for the job or to delete the job. |\n\nJSON resource representation\n----------------------------\n\nThe JSON structure below shows the format of a `job` resource: \n\n```text\n{\n \"id\": string,\n \"reportTypeId\": string,\n \"name\": string,\n \"createTime\": timestamp,\n \"expireTime\": timestamp,\n \"systemManaged\": boolean\n}\n```\n\nProperties\n----------\n\nThe following table defines the properties that appear in this resource:\n\n| Properties ||\n|-----------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `id` | `string` The ID that YouTube uses to uniquely identify the reporting job. The value has a maximum length of 40 characters. |\n| `reportTypeId` | `string` The type of report that the job creates. The property value corresponds to the `id` of a [id](/youtube/reporting/v1/reference/rest/v1/reportTypes/list#id) of a `reportType` as retrieved from the `reportTypes.list` method. |\n| `name` | `string` A name that YouTube generates to describe the job. The value has a maximum length of 100 characters. |\n| `createTime` | `timestamp` The date and time that the job was created. The property value is a timestamp in RFC3339 UTC \"Zulu\" format, accurate to microseconds. Example: `\"2015-10-02T15:01:23.045678Z\"`. |\n| `expireTime` | `timestamp` The date and time that the job expired or will expire. The property value is a timestamp in RFC3339 UTC \"Zulu\" format, accurate to microseconds. Example: `\"2015-10-02T15:01:23.045678Z\"`. This property has a value if the report type associated with the job has been deprecated or if reports generated for the job have not been downloaded for a prolonged period of time. The value marks the date after which YouTube no longer generates new reports for the job. If you have a job that identifies an expiration date, you should update your systems to stop requesting the report by that date. In some cases, a replacement report may be available. |\n| `systemManaged` | `boolean` This value is `true` if the job generates system-managed reports. YouTube automatically generates system-managed reports for the YouTube content owners who have access to the same reports in the [YouTube Creator Studio](https://studio.youtube.com). Content owners cannot modify or delete jobs that create those reports. |"]]
