@@ -1,567 +1,597 @@
11{
2− "kind": "discovery#restDescription",
3− "etag": "\"C5oy1hgQsABtYOYIOXWcR3BgYqU/rGt7cps_AzBks09MaEuVrcIRQ_o\"",
4− "discoveryVersion": "v1",
5− "id": "youtubereporting:v1",
6− "name": "youtubereporting",
7− "canonicalName": "YouTube Reporting",
8− "version": "v1",
9− "revision": "20160517",
10− "title": "YouTube Reporting API",
11− "description": "Schedules reporting jobs containing your YouTube Analytics data and downloads the resulting bulk data reports in the form of CSV files.",
12− "ownerDomain": "google.com",
13− "ownerName": "Google",
14− "icons": {
15− "x16": "http://www.google.com/images/icons/product/search-16.gif",
16− "x32": "http://www.google.com/images/icons/product/search-32.gif"
17− },
18− "documentationLink": "https://developers.google.com/youtube/reporting/v1/reports/",
19− "protocol": "rest",
20− "baseUrl": "https://youtubereporting.googleapis.com/",
21− "basePath": "",
22− "rootUrl": "https://youtubereporting.googleapis.com/",
23− "servicePath": "",
24− "batchPath": "batch",
25− "parameters": {
26− "access_token": {
27− "type": "string",
28− "description": "OAuth access token.",
29− "location": "query"
30− },
31− "alt": {
32− "type": "string",
33− "description": "Data format for response.",
34− "default": "json",
35− "enumDescriptions": [
36− "Responses with Content-Type of application/json",
37− "Media download with context-dependent Content-Type",
38− "Responses with Content-Type of application/x-protobuf"
39− ],
40− "location": "query"
41− },
42− "bearer_token": {
43− "type": "string",
44− "description": "OAuth bearer token.",
45− "location": "query"
46− },
47− "callback": {
48− "type": "string",
49− "description": "JSONP",
50− "location": "query"
51− },
52− "fields": {
53− "type": "string",
54− "description": "Selector specifying which fields to include in a partial response.",
55− "location": "query"
56− },
57− "key": {
58− "type": "string",
59− "description": "API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token.",
60− "location": "query"
61− },
62− "oauth_token": {
63− "type": "string",
64− "description": "OAuth 2.0 token for the current user.",
65− "location": "query"
66− },
67− "pp": {
68− "type": "boolean",
69− "description": "Pretty-print response.",
70− "default": "true",
71− "location": "query"
72− },
73− "prettyPrint": {
74− "type": "boolean",
75− "description": "Returns response with indentations and line breaks.",
76− "default": "true",
77− "location": "query"
78− },
79− "quotaUser": {
80− "type": "string",
81− "description": "Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.",
82− "location": "query"
83− },
84− "upload_protocol": {
85− "type": "string",
86− "description": "Upload protocol for media (e.g. \"raw\", \"multipart\").",
87− "location": "query"
88− },
89− "uploadType": {
90− "type": "string",
91− "description": "Legacy upload protocol for media (e.g. \"media\", \"multipart\").",
92− "location": "query"
93− },
94− "$.xgafv": {
95− "type": "string",
96− "description": "V1 error format.",
97− "enumDescriptions": [
98− "v1 error format",
99− "v2 error format"
100− ],
101− "location": "query"
102− }
103− },
104− "auth": {
105− "oauth2": {
106− "scopes": {
107− "https://www.googleapis.com/auth/yt-analytics-monetary.readonly": {
108− "description": "View monetary and non-monetary YouTube Analytics reports for your YouTube content"
109− },
110− "https://www.googleapis.com/auth/yt-analytics.readonly": {
111− "description": "View YouTube Analytics reports for your YouTube content"
112− }
113− }
114− }
115− },
116− "schemas": {
117− "Media": {
118− "id": "Media",
119− "type": "object",
120− "description": "Media resource.",
121− "properties": {
122− "resourceName": {
123− "type": "string",
124− "description": "Name of the media resource."
2+ "id": "youtubereporting:v1",
3+ "auth": {
4+ "oauth2": {
5+ "scopes": {
6+ "https://www.googleapis.com/auth/yt-analytics.readonly": {
7+ "description": "View YouTube Analytics reports for your YouTube content"
8+ },
9+ "https://www.googleapis.com/auth/yt-analytics-monetary.readonly": {
10+ "description": "View monetary and non-monetary YouTube Analytics reports for your YouTube content"
11+ }
12+ }
12513 }
126− }
12714 },
128− "ListReportTypesResponse": {
129− "id": "ListReportTypesResponse",
130− "type": "object",
131− "description": "Response message for ReportingService.ListReportTypes.",
132− "properties": {
15+ "description": "Schedules reporting jobs containing your YouTube Analytics data and downloads the resulting bulk data reports in the form of CSV files.",
16+ "protocol": "rest",
17+ "title": "YouTube Reporting API",
18+ "resources": {
13319 "reportTypes": {
134− "type": "array",
135− "description": "The list of report types.",
136− "items": {
137− "$ref": "ReportType"
138− }
139− },
140− "nextPageToken": {
141− "type": "string",
142− "description": "A token to retrieve next page of results. Pass this value in the ListReportTypesRequest.page_token field in the subsequent call to `ListReportTypes` method to retrieve the next page of results."
143− }
144− }
145− },
146− "ReportType": {
147− "id": "ReportType",
148− "type": "object",
149− "description": "A report type.",
150− "properties": {
151− "id": {
152− "type": "string",
153− "description": "The ID of the report type (max. 100 characters)."
154− },
155− "name": {
156− "type": "string",
157− "description": "The name of the report type (max. 100 characters)."
158− },
159− "deprecateTime": {
160− "type": "string",
161− "description": "The date/time when this report type was/will be deprecated."
162− },
163− "systemManaged": {
164− "type": "boolean",
165− "description": "True if this a system-managed report type; otherwise false. Reporting jobs for system-managed report types are created automatically and can thus not be used in the `CreateJob` method."
166− }
167− }
168− },
169− "Job": {
170− "id": "Job",
171− "type": "object",
172− "description": "A job creating reports of a specific type.",
173− "properties": {
174− "id": {
175− "type": "string",
176− "description": "The server-generated ID of the job (max. 40 characters)."
177− },
178− "reportTypeId": {
179− "type": "string",
180− "description": "The type of reports this job creates. Corresponds to the ID of a ReportType."
181− },
182− "name": {
183− "type": "string",
184− "description": "The name of the job (max. 100 characters)."
185− },
186− "createTime": {
187− "type": "string",
188− "description": "The creation date/time of the job."
20+ "methods": {
21+ "list": {
22+ "id": "youtubereporting.reportTypes.list",
23+ "response": {
24+ "$ref": "ListReportTypesResponse"
25+ },
26+ "parameterOrder": [],
27+ "description": "Lists report types.",
28+ "flatPath": "v1/reportTypes",
29+ "httpMethod": "GET",
30+ "parameters": {
31+ "pageSize": {
32+ "description": "Requested page size. Server may return fewer report types than requested.\nIf unspecified, server will pick an appropriate default.",
33+ "location": "query",
34+ "type": "integer",
35+ "format": "int32"
36+ },
37+ "includeSystemManaged": {
38+ "description": "If set to true, also system-managed report types will be returned;\notherwise only the report types that can be used to create new reporting\njobs will be returned.",
39+ "location": "query",
40+ "type": "boolean"
41+ },
42+ "onBehalfOfContentOwner": {
43+ "description": "The content owner's external ID on which behalf the user is acting on. If\nnot set, the user is acting for himself (his own channel).",
44+ "location": "query",
45+ "type": "string"
46+ },
47+ "pageToken": {
48+ "description": "A token identifying a page of results the server should return. Typically,\nthis is the value of\nListReportTypesResponse.next_page_token\nreturned in response to the previous call to the `ListReportTypes` method.",
49+ "location": "query",
50+ "type": "string"
51+ }
52+ },
53+ "path": "v1/reportTypes",
54+ "scopes": [
55+ "https://www.googleapis.com/auth/yt-analytics-monetary.readonly",
56+ "https://www.googleapis.com/auth/yt-analytics.readonly"
57+ ]
58+ }
59+ }
18960 },
190− "expireTime": {
191− "type": "string",
192− "description": "The date/time when this job will expire/expired. After a job expired, no new reports are generated."
61+ "media": {
62+ "methods": {
63+ "download": {
64+ "id": "youtubereporting.media.download",
65+ "response": {
66+ "$ref": "Media"
67+ },
68+ "parameterOrder": [
69+ "resourceName"
70+ ],
71+ "description": "Method for media download. Download is supported\non the URI `/v1/media/{+name}?alt=media`.",
72+ "flatPath": "v1/media/{mediaId}",
73+ "httpMethod": "GET",
74+ "parameters": {
75+ "resourceName": {
76+ "description": "Name of the media that is being downloaded. See\nReadRequest.resource_name.",
77+ "required": true,
78+ "pattern": "^.+$",
79+ "location": "path",
80+ "type": "string"
81+ }
82+ },
83+ "path": "v1/media/{+resourceName}",
84+ "scopes": [
85+ "https://www.googleapis.com/auth/yt-analytics-monetary.readonly",
86+ "https://www.googleapis.com/auth/yt-analytics.readonly"
87+ ],
88+ "supportsMediaDownload": true
89+ }
90+ }
19391 },
194− "systemManaged": {
195− "type": "boolean",
196− "description": "True if this a system-managed job that cannot be modified by the user; otherwise false."
197− }
198− }
199− },
200− "ListJobsResponse": {
201− "id": "ListJobsResponse",
202− "type": "object",
203− "description": "Response message for ReportingService.ListJobs.",
204− "properties": {
20592 "jobs": {
206− "type": "array",
207− "description": "The list of jobs.",
208− "items": {
209− "$ref": "Job"
210− }
211− },
212− "nextPageToken": {
213− "type": "string",
214− "description": "A token to retrieve next page of results. Pass this value in the ListJobsRequest.page_token field in the subsequent call to `ListJobs` method to retrieve the next page of results."
215− }
216− }
217− },
218− "Empty": {
219− "id": "Empty",
220− "type": "object",
221− "description": "A generic empty message that you can re-use to avoid defining duplicated empty messages in your APIs. A typical example is to use it as the request or the response type of an API method. For instance: service Foo { rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty); } The JSON representation for `Empty` is empty JSON object `{}`."
222− },
223− "ListReportsResponse": {
224− "id": "ListReportsResponse",
225− "type": "object",
226− "description": "Response message for ReportingService.ListReports.",
227− "properties": {
228− "reports": {
229− "type": "array",
230− "description": "The list of report types.",
231− "items": {
232− "$ref": "Report"
233− }
234− },
235− "nextPageToken": {
236− "type": "string",
237− "description": "A token to retrieve next page of results. Pass this value in the ListReportsRequest.page_token field in the subsequent call to `ListReports` method to retrieve the next page of results."
238− }
239− }
240− },
241− "Report": {
242− "id": "Report",
243− "type": "object",
244− "description": "A report's metadata including the URL from which the report itself can be downloaded.",
245− "properties": {
246− "id": {
247− "type": "string",
248− "description": "The server-generated ID of the report."
249− },
250− "jobId": {
251− "type": "string",
252− "description": "The ID of the job that created this report."
253− },
254− "jobExpireTime": {
255− "type": "string",
256− "description": "The date/time when the job this report belongs to will expire/expired."
257− },
258− "startTime": {
259− "type": "string",
260− "description": "The start of the time period that the report instance covers. The value is inclusive."
261− },
262− "endTime": {
263− "type": "string",
264− "description": "The end of the time period that the report instance covers. The value is exclusive."
265− },
266− "createTime": {
267− "type": "string",
268− "description": "The date/time when this report was created."
269− },
270− "downloadUrl": {
271− "type": "string",
272− "description": "The URL from which the report can be downloaded (max. 1000 characters)."
273− }
274− }
275− }
276− },
277− "resources": {
278− "media": {
279− "methods": {
280− "download": {
281− "id": "youtubereporting.media.download",
282− "path": "v1/media/{+resourceName}",
283− "httpMethod": "GET",
284− "description": "Method for media download. Download is supported on the URI `/v1/media/{+name}?alt=media`.",
285− "parameters": {
286− "resourceName": {
287− "type": "string",
288− "description": "Name of the media that is being downloaded. See ReadRequest.resource_name.",
289− "required": true,
290− "pattern": "^.*$",
291− "location": "path"
292− }
293− },
294− "parameterOrder": [
295− "resourceName"
296− ],
297− "response": {
298− "$ref": "Media"
299− },
300− "scopes": [
301− "https://www.googleapis.com/auth/yt-analytics-monetary.readonly",
302− "https://www.googleapis.com/auth/yt-analytics.readonly"
303− ],
304− "supportsMediaDownload": true
305− }
306− }
307− },
308− "reportTypes": {
309− "methods": {
310− "list": {
311− "id": "youtubereporting.reportTypes.list",
312− "path": "v1/reportTypes",
313− "httpMethod": "GET",
314− "description": "Lists report types.",
315− "parameters": {
316− "onBehalfOfContentOwner": {
317− "type": "string",
318− "description": "The content owner's external ID on which behalf the user is acting on. If not set, the user is acting for himself (his own channel).",
319− "location": "query"
320− },
321− "pageSize": {
322− "type": "integer",
323− "description": "Requested page size. Server may return fewer report types than requested. If unspecified, server will pick an appropriate default.",
324− "format": "int32",
325− "location": "query"
326− },
327− "pageToken": {
328− "type": "string",
329− "description": "A token identifying a page of results the server should return. Typically, this is the value of ListReportTypesResponse.next_page_token returned in response to the previous call to the `ListReportTypes` method.",
330− "location": "query"
93+ "resources": {
94+ "reports": {
95+ "methods": {
96+ "get": {
97+ "id": "youtubereporting.jobs.reports.get",
98+ "response": {
99+ "$ref": "Report"
100+ },
101+ "parameterOrder": [
102+ "jobId",
103+ "reportId"
104+ ],
105+ "description": "Gets the metadata of a specific report.",
106+ "flatPath": "v1/jobs/{jobId}/reports/{reportId}",
107+ "httpMethod": "GET",
108+ "parameters": {
109+ "jobId": {
110+ "description": "The ID of the job.",
111+ "required": true,
112+ "location": "path",
113+ "type": "string"
114+ },
115+ "reportId": {
116+ "description": "The ID of the report to retrieve.",
117+ "required": true,
118+ "location": "path",
119+ "type": "string"
120+ },
121+ "onBehalfOfContentOwner": {
122+ "description": "The content owner's external ID on which behalf the user is acting on. If\nnot set, the user is acting for himself (his own channel).",
123+ "location": "query",
124+ "type": "string"
125+ }
126+ },
127+ "path": "v1/jobs/{jobId}/reports/{reportId}",
128+ "scopes": [
129+ "https://www.googleapis.com/auth/yt-analytics-monetary.readonly",
130+ "https://www.googleapis.com/auth/yt-analytics.readonly"
131+ ]
132+ },
133+ "list": {
134+ "id": "youtubereporting.jobs.reports.list",
135+ "response": {
136+ "$ref": "ListReportsResponse"
137+ },
138+ "parameterOrder": [
139+ "jobId"
140+ ],
141+ "description": "Lists reports created by a specific job.\nReturns NOT_FOUND if the job does not exist.",
142+ "flatPath": "v1/jobs/{jobId}/reports",
143+ "httpMethod": "GET",
144+ "parameters": {
145+ "onBehalfOfContentOwner": {
146+ "description": "The content owner's external ID on which behalf the user is acting on. If\nnot set, the user is acting for himself (his own channel).",
147+ "location": "query",
148+ "type": "string"
149+ },
150+ "startTimeAtOrAfter": {
151+ "description": "If set, only reports whose start time is greater than or equal the\nspecified date/time are returned.",
152+ "location": "query",
153+ "type": "string",
154+ "format": "google-datetime"
155+ },
156+ "startTimeBefore": {
157+ "description": "If set, only reports whose start time is smaller than the specified\ndate/time are returned.",
158+ "location": "query",
159+ "type": "string",
160+ "format": "google-datetime"
161+ },
162+ "pageSize": {
163+ "description": "Requested page size. Server may return fewer report types than requested.\nIf unspecified, server will pick an appropriate default.",
164+ "location": "query",
165+ "type": "integer",
166+ "format": "int32"
167+ },
168+ "createdAfter": {
169+ "description": "If set, only reports created after the specified date/time are returned.",
170+ "location": "query",
171+ "type": "string",
172+ "format": "google-datetime"
173+ },
174+ "jobId": {
175+ "description": "The ID of the job.",
176+ "required": true,
177+ "location": "path",
178+ "type": "string"
179+ },
180+ "pageToken": {
181+ "description": "A token identifying a page of results the server should return. Typically,\nthis is the value of\nListReportsResponse.next_page_token\nreturned in response to the previous call to the `ListReports` method.",
182+ "location": "query",
183+ "type": "string"
184+ }
185+ },
186+ "path": "v1/jobs/{jobId}/reports",
187+ "scopes": [
188+ "https://www.googleapis.com/auth/yt-analytics-monetary.readonly",
189+ "https://www.googleapis.com/auth/yt-analytics.readonly"
190+ ]
191+ }
192+ }
193+ }
331194 },
332− "includeSystemManaged": {
333− "type": "boolean",
334− "description": "If set to true, also system-managed report types will be returned; otherwise only the report types that can be used to create new reporting jobs will be returned.",
335− "location": "query"
195+ "methods": {
196+ "create": {
197+ "id": "youtubereporting.jobs.create",
198+ "response": {
199+ "$ref": "Job"
200+ },
201+ "parameterOrder": [],
202+ "description": "Creates a job and returns it.",
203+ "request": {
204+ "$ref": "Job"
205+ },
206+ "flatPath": "v1/jobs",
207+ "httpMethod": "POST",
208+ "parameters": {
209+ "onBehalfOfContentOwner": {
210+ "description": "The content owner's external ID on which behalf the user is acting on. If\nnot set, the user is acting for himself (his own channel).",
211+ "location": "query",
212+ "type": "string"
213+ }
214+ },
215+ "path": "v1/jobs",
216+ "scopes": [
217+ "https://www.googleapis.com/auth/yt-analytics-monetary.readonly",
218+ "https://www.googleapis.com/auth/yt-analytics.readonly"
219+ ]
220+ },
221+ "get": {
222+ "id": "youtubereporting.jobs.get",
223+ "response": {
224+ "$ref": "Job"
225+ },
226+ "parameterOrder": [
227+ "jobId"
228+ ],
229+ "description": "Gets a job.",
230+ "flatPath": "v1/jobs/{jobId}",
231+ "httpMethod": "GET",
232+ "parameters": {
233+ "jobId": {
234+ "description": "The ID of the job to retrieve.",
235+ "required": true,
236+ "location": "path",
237+ "type": "string"
238+ },
239+ "onBehalfOfContentOwner": {
240+ "description": "The content owner's external ID on which behalf the user is acting on. If\nnot set, the user is acting for himself (his own channel).",
241+ "location": "query",
242+ "type": "string"
243+ }
244+ },
245+ "path": "v1/jobs/{jobId}",
246+ "scopes": [
247+ "https://www.googleapis.com/auth/yt-analytics-monetary.readonly",
248+ "https://www.googleapis.com/auth/yt-analytics.readonly"
249+ ]
250+ },
251+ "list": {
252+ "id": "youtubereporting.jobs.list",
253+ "response": {
254+ "$ref": "ListJobsResponse"
255+ },
256+ "parameterOrder": [],
257+ "description": "Lists jobs.",
258+ "flatPath": "v1/jobs",
259+ "httpMethod": "GET",
260+ "parameters": {
261+ "pageSize": {
262+ "description": "Requested page size. Server may return fewer jobs than requested.\nIf unspecified, server will pick an appropriate default.",
263+ "location": "query",
264+ "type": "integer",
265+ "format": "int32"
266+ },
267+ "includeSystemManaged": {
268+ "description": "If set to true, also system-managed jobs will be returned; otherwise only\nuser-created jobs will be returned. System-managed jobs can neither be\nmodified nor deleted.",
269+ "location": "query",
270+ "type": "boolean"
271+ },
272+ "onBehalfOfContentOwner": {
273+ "description": "The content owner's external ID on which behalf the user is acting on. If\nnot set, the user is acting for himself (his own channel).",
274+ "location": "query",
275+ "type": "string"
276+ },
277+ "pageToken": {
278+ "description": "A token identifying a page of results the server should return. Typically,\nthis is the value of\nListReportTypesResponse.next_page_token\nreturned in response to the previous call to the `ListJobs` method.",
279+ "location": "query",
280+ "type": "string"
281+ }
282+ },
283+ "path": "v1/jobs",
284+ "scopes": [
285+ "https://www.googleapis.com/auth/yt-analytics-monetary.readonly",
286+ "https://www.googleapis.com/auth/yt-analytics.readonly"
287+ ]
288+ },
289+ "delete": {
290+ "id": "youtubereporting.jobs.delete",
291+ "response": {
292+ "$ref": "Empty"
293+ },
294+ "parameterOrder": [
295+ "jobId"
296+ ],
297+ "description": "Deletes a job.",
298+ "flatPath": "v1/jobs/{jobId}",
299+ "httpMethod": "DELETE",
300+ "parameters": {
301+ "jobId": {
302+ "description": "The ID of the job to delete.",
303+ "required": true,
304+ "location": "path",
305+ "type": "string"
306+ },
307+ "onBehalfOfContentOwner": {
308+ "description": "The content owner's external ID on which behalf the user is acting on. If\nnot set, the user is acting for himself (his own channel).",
309+ "location": "query",
310+ "type": "string"
311+ }
312+ },
313+ "path": "v1/jobs/{jobId}",
314+ "scopes": [
315+ "https://www.googleapis.com/auth/yt-analytics-monetary.readonly",
316+ "https://www.googleapis.com/auth/yt-analytics.readonly"
317+ ]
318+ }
336319 }
337− },
338− "response": {
339− "$ref": "ListReportTypesResponse"
340− },
341− "scopes": [
342− "https://www.googleapis.com/auth/yt-analytics-monetary.readonly",
343− "https://www.googleapis.com/auth/yt-analytics.readonly"
344− ]
345320 }
346− }
347321 },
348− "jobs": {
349− "methods": {
350− "create": {
351− "id": "youtubereporting.jobs.create",
352− "path": "v1/jobs",
353− "httpMethod": "POST",
354− "description": "Creates a job and returns it.",
355− "parameters": {
356− "onBehalfOfContentOwner": {
357− "type": "string",
358− "description": "The content owner's external ID on which behalf the user is acting on. If not set, the user is acting for himself (his own channel).",
359− "location": "query"
360− }
361− },
362− "request": {
363− "$ref": "Job"
364− },
365− "response": {
366− "$ref": "Job"
367− },
368− "scopes": [
369− "https://www.googleapis.com/auth/yt-analytics-monetary.readonly",
370− "https://www.googleapis.com/auth/yt-analytics.readonly"
371− ]
372− },
373− "list": {
374− "id": "youtubereporting.jobs.list",
375− "path": "v1/jobs",
376− "httpMethod": "GET",
377− "description": "Lists jobs.",
378− "parameters": {
379− "onBehalfOfContentOwner": {
380− "type": "string",
381− "description": "The content owner's external ID on which behalf the user is acting on. If not set, the user is acting for himself (his own channel).",
382− "location": "query"
383− },
384− "pageSize": {
385− "type": "integer",
386− "description": "Requested page size. Server may return fewer jobs than requested. If unspecified, server will pick an appropriate default.",
387− "format": "int32",
388− "location": "query"
389− },
390− "pageToken": {
391− "type": "string",
392− "description": "A token identifying a page of results the server should return. Typically, this is the value of ListReportTypesResponse.next_page_token returned in response to the previous call to the `ListJobs` method.",
393− "location": "query"
322+ "schemas": {
323+ "Report": {
324+ "description": "A report's metadata including the URL from which the report itself can be\ndownloaded.",
325+ "type": "object",
326+ "properties": {
327+ "id": {
328+ "description": "The server-generated ID of the report.",
329+ "type": "string"
330+ },
331+ "downloadUrl": {
332+ "description": "The URL from which the report can be downloaded (max. 1000 characters).",
333+ "type": "string"
334+ },
335+ "endTime": {
336+ "description": "The end of the time period that the report instance covers. The value is\nexclusive.",
337+ "type": "string",
338+ "format": "google-datetime"
339+ },
340+ "createTime": {
341+ "description": "The date/time when this report was created.",
342+ "type": "string",
343+ "format": "google-datetime"
344+ },
345+ "startTime": {
346+ "description": "The start of the time period that the report instance covers. The value is\ninclusive.",
347+ "type": "string",
348+ "format": "google-datetime"
349+ },
350+ "jobExpireTime": {
351+ "description": "The date/time when the job this report belongs to will expire/expired.",
352+ "type": "string",
353+ "format": "google-datetime"
354+ },
355+ "jobId": {
356+ "description": "The ID of the job that created this report.",
357+ "type": "string"
358+ }
394359 },
395− "includeSystemManaged": {
396− "type": "boolean",
397− "description": "If set to true, also system-managed jobs will be returned; otherwise only user-created jobs will be returned. System-managed jobs can neither be modified nor deleted.",
398− "location": "query"
399− }
400− },
401− "response": {
402− "$ref": "ListJobsResponse"
403− },
404− "scopes": [
405− "https://www.googleapis.com/auth/yt-analytics-monetary.readonly",
406− "https://www.googleapis.com/auth/yt-analytics.readonly"
407− ]
360+ "id": "Report"
408361 },
409− "get": {
410− "id": "youtubereporting.jobs.get",
411− "path": "v1/jobs/{jobId}",
412− "httpMethod": "GET",
413− "description": "Gets a job.",
414− "parameters": {
415− "jobId": {
416− "type": "string",
417− "description": "The ID of the job to retrieve.",
418− "required": true,
419− "location": "path"
362+ "ListJobsResponse": {
363+ "description": "Response message for ReportingService.ListJobs.",
364+ "type": "object",
365+ "properties": {
366+ "nextPageToken": {
367+ "description": "A token to retrieve next page of results.\nPass this value in the\nListJobsRequest.page_token\nfield in the subsequent call to `ListJobs` method to retrieve the next\npage of results.",
368+ "type": "string"
369+ },
370+ "jobs": {
371+ "description": "The list of jobs.",
372+ "type": "array",
373+ "items": {
374+ "$ref": "Job"
375+ }
376+ }
420377 },
421− "onBehalfOfContentOwner": {
422− "type": "string",
423− "description": "The content owner's external ID on which behalf the user is acting on. If not set, the user is acting for himself (his own channel).",
424− "location": "query"
425− }
426− },
427− "parameterOrder": [
428− "jobId"
429− ],
430− "response": {
431− "$ref": "Job"
432− },
433− "scopes": [
434− "https://www.googleapis.com/auth/yt-analytics-monetary.readonly",
435− "https://www.googleapis.com/auth/yt-analytics.readonly"
436− ]
378+ "id": "ListJobsResponse"
437379 },
438− "delete": {
439− "id": "youtubereporting.jobs.delete",
440− "path": "v1/jobs/{jobId}",
441− "httpMethod": "DELETE",
442− "description": "Deletes a job.",
443− "parameters": {
444− "jobId": {
445− "type": "string",
446− "description": "The ID of the job to delete.",
447− "required": true,
448− "location": "path"
380+ "Media": {
381+ "description": "Media resource.",
382+ "type": "object",
383+ "properties": {
384+ "resourceName": {
385+ "description": "Name of the media resource.",
386+ "type": "string"
387+ }
449388 },
450− "onBehalfOfContentOwner": {
451− "type": "string",
452− "description": "The content owner's external ID on which behalf the user is acting on. If not set, the user is acting for himself (his own channel).",
453− "location": "query"
454− }
455− },
456− "parameterOrder": [
457− "jobId"
458− ],
459− "response": {
460− "$ref": "Empty"
461− },
462− "scopes": [
463− "https://www.googleapis.com/auth/yt-analytics-monetary.readonly",
464− "https://www.googleapis.com/auth/yt-analytics.readonly"
465− ]
466− }
467− },
468− "resources": {
469− "reports": {
470− "methods": {
471− "list": {
472− "id": "youtubereporting.jobs.reports.list",
473− "path": "v1/jobs/{jobId}/reports",
474− "httpMethod": "GET",
475− "description": "Lists reports created by a specific job. Returns NOT_FOUND if the job does not exist.",
476− "parameters": {
477− "jobId": {
478− "type": "string",
479− "description": "The ID of the job.",
480− "required": true,
481− "location": "path"
389+ "id": "Media"
390+ },
391+ "Job": {
392+ "description": "A job creating reports of a specific type.",
393+ "type": "object",
394+ "properties": {
395+ "id": {
396+ "description": "The server-generated ID of the job (max. 40 characters).",
397+ "type": "string"
398+ },
399+ "createTime": {
400+ "description": "The creation date/time of the job.",
401+ "type": "string",
402+ "format": "google-datetime"
403+ },
404+ "systemManaged": {
405+ "description": "True if this a system-managed job that cannot be modified by the user;\notherwise false.",
406+ "type": "boolean"
482407 },
483− "onBehalfOfContentOwner": {
484− "type": "string",
485− "description": "The content owner's external ID on which behalf the user is acting on. If not set, the user is acting for himself (his own channel).",
486− "location": "query"
408+ "expireTime": {
409+ "description": "The date/time when this job will expire/expired. After a job expired, no\nnew reports are generated.",
410+ "type": "string",
411+ "format": "google-datetime"
487412 },
488− "pageSize": {
489− "type": "integer",
490− "description": "Requested page size. Server may return fewer report types than requested. If unspecified, server will pick an appropriate default.",
491− "format": "int32",
492− "location": "query"
413+ "name": {
414+ "description": "The name of the job (max. 100 characters).",
415+ "type": "string"
493416 },
494− "pageToken": {
495− "type": "string",
496− "description": "A token identifying a page of results the server should return. Typically, this is the value of ListReportsResponse.next_page_token returned in response to the previous call to the `ListReports` method.",
497− "location": "query"
417+ "reportTypeId": {
418+ "description": "The type of reports this job creates. Corresponds to the ID of a\nReportType.",
419+ "type": "string"
420+ }
421+ },
422+ "id": "Job"
423+ },
424+ "Empty": {
425+ "description": "A generic empty message that you can re-use to avoid defining duplicated\nempty messages in your APIs. A typical example is to use it as the request\nor the response type of an API method. For instance:\n\n service Foo {\n rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty);\n }\n\nThe JSON representation for `Empty` is empty JSON object `{}`.",
426+ "type": "object",
427+ "properties": {},
428+ "id": "Empty"
429+ },
430+ "ReportType": {
431+ "description": "A report type.",
432+ "type": "object",
433+ "properties": {
434+ "systemManaged": {
435+ "description": "True if this a system-managed report type; otherwise false. Reporting jobs\nfor system-managed report types are created automatically and can thus not\nbe used in the `CreateJob` method.",
436+ "type": "boolean"
498437 },
499− "createdAfter": {
500− "type": "string",
501− "description": "If set, only reports created after the specified date/time are returned.",
502− "location": "query"
438+ "deprecateTime": {
439+ "description": "The date/time when this report type was/will be deprecated.",
440+ "type": "string",
441+ "format": "google-datetime"
503442 },
504− "startTimeAtOrAfter": {
505− "type": "string",
506− "description": "If set, only reports whose start time is greater than or equal the specified date/time are returned.",
507− "location": "query"
443+ "id": {
444+ "description": "The ID of the report type (max. 100 characters).",
445+ "type": "string"
508446 },
509− "startTimeBefore": {
510− "type": "string",
511− "description": "If set, only reports whose start time is smaller than the specified date/time are returned.",
512− "location": "query"
447+ "name": {
448+ "description": "The name of the report type (max. 100 characters).",
449+ "type": "string"
513450 }
514− },
515− "parameterOrder": [
516− "jobId"
517− ],
518− "response": {
519− "$ref": "ListReportsResponse"
520− },
521− "scopes": [
522− "https://www.googleapis.com/auth/yt-analytics-monetary.readonly",
523− "https://www.googleapis.com/auth/yt-analytics.readonly"
524− ]
525451 },
526− "get": {
527− "id": "youtubereporting.jobs.reports.get",
528− "path": "v1/jobs/{jobId}/reports/{reportId}",
529− "httpMethod": "GET",
530− "description": "Gets the metadata of a specific report.",
531− "parameters": {
532− "jobId": {
533− "type": "string",
534− "description": "The ID of the job.",
535− "required": true,
536− "location": "path"
452+ "id": "ReportType"
453+ },
454+ "ListReportsResponse": {
455+ "description": "Response message for ReportingService.ListReports.",
456+ "type": "object",
457+ "properties": {
458+ "nextPageToken": {
459+ "description": "A token to retrieve next page of results.\nPass this value in the\nListReportsRequest.page_token\nfield in the subsequent call to `ListReports` method to retrieve the next\npage of results.",
460+ "type": "string"
537461 },
538− "reportId": {
539− "type": "string",
540− "description": "The ID of the report to retrieve.",
541− "required": true,
542− "location": "path"
462+ "reports": {
463+ "description": "The list of report types.",
464+ "type": "array",
465+ "items": {
466+ "$ref": "Report"
467+ }
468+ }
469+ },
470+ "id": "ListReportsResponse"
471+ },
472+ "ListReportTypesResponse": {
473+ "description": "Response message for ReportingService.ListReportTypes.",
474+ "type": "object",
475+ "properties": {
476+ "reportTypes": {
477+ "description": "The list of report types.",
478+ "type": "array",
479+ "items": {
480+ "$ref": "ReportType"
481+ }
543482 },
544− "onBehalfOfContentOwner": {
545− "type": "string",
546− "description": "The content owner's external ID on which behalf the user is acting on. If not set, the user is acting for himself (his own channel).",
547− "location": "query"
483+ "nextPageToken": {
484+ "description": "A token to retrieve next page of results.\nPass this value in the\nListReportTypesRequest.page_token\nfield in the subsequent call to `ListReportTypes` method to retrieve the next\npage of results.",
485+ "type": "string"
548486 }
549− },
550− "parameterOrder": [
551− "jobId",
552− "reportId"
553− ],
554− "response": {
555− "$ref": "Report"
556− },
557− "scopes": [
558− "https://www.googleapis.com/auth/yt-analytics-monetary.readonly",
559− "https://www.googleapis.com/auth/yt-analytics.readonly"
560− ]
561− }
562− }
487+ },
488+ "id": "ListReportTypesResponse"
563489 }
564− }
565− }
566− }
490+ },
491+ "revision": "20170111",
492+ "basePath": "",
493+ "icons": {
494+ "x32": "http://www.google.com/images/icons/product/search-32.gif",
495+ "x16": "http://www.google.com/images/icons/product/search-16.gif"
496+ },
497+ "canonicalName": "YouTube Reporting",
498+ "discoveryVersion": "v1",
499+ "baseUrl": "https://youtubereporting.googleapis.com/",
500+ "name": "youtubereporting",
501+ "parameters": {
502+ "access_token": {
503+ "description": "OAuth access token.",
504+ "type": "string",
505+ "location": "query"
506+ },
507+ "prettyPrint": {
508+ "description": "Returns response with indentations and line breaks.",
509+ "default": "true",
510+ "type": "boolean",
511+ "location": "query"
512+ },
513+ "key": {
514+ "description": "API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token.",
515+ "type": "string",
516+ "location": "query"
517+ },
518+ "quotaUser": {
519+ "description": "Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.",
520+ "type": "string",
521+ "location": "query"
522+ },
523+ "pp": {
524+ "description": "Pretty-print response.",
525+ "default": "true",
526+ "type": "boolean",
527+ "location": "query"
528+ },
529+ "fields": {
530+ "description": "Selector specifying which fields to include in a partial response.",
531+ "type": "string",
532+ "location": "query"
533+ },
534+ "alt": {
535+ "description": "Data format for response.",
536+ "location": "query",
537+ "enum": [
538+ "json",
539+ "media",
540+ "proto"
541+ ],
542+ "default": "json",
543+ "enumDescriptions": [
544+ "Responses with Content-Type of application/json",
545+ "Media download with context-dependent Content-Type",
546+ "Responses with Content-Type of application/x-protobuf"
547+ ],
548+ "type": "string"
549+ },
550+ "$.xgafv": {
551+ "description": "V1 error format.",
552+ "enum": [
553+ "1",
554+ "2"
555+ ],
556+ "enumDescriptions": [
557+ "v1 error format",
558+ "v2 error format"
559+ ],
560+ "type": "string",
561+ "location": "query"
562+ },
563+ "callback": {
564+ "description": "JSONP",
565+ "type": "string",
566+ "location": "query"
567+ },
568+ "oauth_token": {
569+ "description": "OAuth 2.0 token for the current user.",
570+ "type": "string",
571+ "location": "query"
572+ },
573+ "uploadType": {
574+ "description": "Legacy upload protocol for media (e.g. \"media\", \"multipart\").",
575+ "type": "string",
576+ "location": "query"
577+ },
578+ "bearer_token": {
579+ "description": "OAuth bearer token.",
580+ "type": "string",
581+ "location": "query"
582+ },
583+ "upload_protocol": {
584+ "description": "Upload protocol for media (e.g. \"raw\", \"multipart\").",
585+ "type": "string",
586+ "location": "query"
587+ }
588+ },
589+ "documentationLink": "https://developers.google.com/youtube/reporting/v1/reports/",
590+ "ownerDomain": "google.com",
591+ "batchPath": "batch",
592+ "servicePath": "",
593+ "ownerName": "Google",
594+ "version": "v1",
595+ "rootUrl": "https://youtubereporting.googleapis.com/",
596+ "kind": "discovery#restDescription"
567597}