A reportType
resource identifies a specific report that a channel or content owner can retrieve.
Methods
The following table shows the methods that the API supports for report
resources.
| Methods | |
|---|---|
list
|
Returns a list of report types that the channel or content owner can retrieve. |
JSON resource representation
The JSON structure below shows the format of a reportType
resource:
{ " id ": string , " name ": string , " deprecateTime ": timestamp , " systemManaged ": boolean }
Properties
The following table defines the properties that appear in this resource:
Properties
id
string
The ID that YouTube uses to uniquely identify the report. The property value has a maximum length of 100 characters. The table below identifies the most recent version of each supported report type (max. 100 characters).
name
string
The name of the report. The property value has a maximum length of 100 characters.
deprecateTime
timestamp
The date and time that the report was or will be deprecated. If you have a job for a deprecated report type, YouTube generates new reports for that job for three months after the deprecation date has been announced.
For example, the deprecation announcement for the
content_owner_basic_a1
report was on May 19, 2016. Thus, the deprecateTime
field for that report type specifies a time on August 19, 2016, after which YouTube will stop generating reports of that type.systemManaged
boolean
This value is
true
if YouTube automatically generates the report for YouTube content owners without content owners needing to first call the jobs.create
method to instruct YouTube to generate the report. In fact, the jobs.create
method returns an error if the reportTypeId
property identifies a system-managed report.