Api-Roll 51: 2017-07-10

discovery/googleapis/youtubereporting__v1.json

 {
     "auth": {
         "oauth2": {
             "scopes": {
+                "https://www.googleapis.com/auth/yt-analytics-monetary.readonly": {
+                    "description": "View monetary and non-monetary YouTube Analytics reports for your YouTube content"
+                },
                 "https://www.googleapis.com/auth/yt-analytics.readonly": {
                     "description": "View YouTube Analytics reports for your YouTube content"
-                },
-                "https://www.googleapis.com/auth/yt-analytics-monetary.readonly": {
-                    "description": "View monetary and non-monetary YouTube Analytics reports for your YouTube content"
                 }
             }
         }
     },
     "basePath": "",
     "baseUrl": "https://youtubereporting.googleapis.com/",
     "batchPath": "batch",
     "canonicalName": "YouTube Reporting",
     "description": "Schedules reporting jobs containing your YouTube Analytics data and downloads the resulting bulk data reports in the form of CSV files.",
     "discoveryVersion": "v1",
     "documentationLink": "https://developers.google.com/youtube/reporting/v1/reports/",
     "icons": {
         "x16": "http://www.google.com/images/icons/product/search-16.gif",
         "x32": "http://www.google.com/images/icons/product/search-32.gif"
     },
     "id": "youtubereporting:v1",
     "kind": "discovery#restDescription",
     "name": "youtubereporting",
     "ownerDomain": "google.com",
     "ownerName": "Google",
     "parameters": {
+        "upload_protocol": {
+            "description": "Upload protocol for media (e.g. \"raw\", \"multipart\").",
+            "location": "query",
+            "type": "string"
+        },
+        "prettyPrint": {
+            "default": "true",
+            "description": "Returns response with indentations and line breaks.",
+            "location": "query",
+            "type": "boolean"
+        },
+        "uploadType": {
+            "description": "Legacy upload protocol for media (e.g. \"media\", \"multipart\").",
+            "location": "query",
+            "type": "string"
+        },
+        "fields": {
+            "description": "Selector specifying which fields to include in a partial response.",
+            "location": "query",
+            "type": "string"
+        },
+        "callback": {
+            "description": "JSONP",
+            "location": "query",
+            "type": "string"
+        },
         "$.xgafv": {
             "description": "V1 error format.",
             "enum": [
                 "1",
                 "2"
             ],
             "enumDescriptions": [
                 "v1 error format",
                 "v2 error format"
             ],
             "location": "query",
             "type": "string"
         },
-        "callback": {
-            "description": "JSONP",
-            "location": "query",
-            "type": "string"
-        },
         "alt": {
             "default": "json",
             "description": "Data format for response.",
             "enum": [
                 "json",
                 "media",
                 "proto"
             ],
             "enumDescriptions": [
                 "Responses with Content-Type of application/json",
                 "Media download with context-dependent Content-Type",
                 "Responses with Content-Type of application/x-protobuf"
             ],
             "location": "query",
             "type": "string"
         },
+        "access_token": {
+            "description": "OAuth access token.",
+            "location": "query",
+            "type": "string"
+        },
         "key": {
             "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.",
             "location": "query",
             "type": "string"
         },
-        "access_token": {
-            "description": "OAuth access token.",
-            "location": "query",
-            "type": "string"
-        },
         "quotaUser": {
             "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.",
             "location": "query",
             "type": "string"
         },
         "pp": {
             "default": "true",
             "description": "Pretty-print response.",
             "location": "query",
             "type": "boolean"
         },
         "oauth_token": {
             "description": "OAuth 2.0 token for the current user.",
             "location": "query",
             "type": "string"
         },
         "bearer_token": {
             "description": "OAuth bearer token.",
             "location": "query",
             "type": "string"
-        },
-        "upload_protocol": {
-            "description": "Upload protocol for media (e.g. \"raw\", \"multipart\").",
-            "location": "query",
-            "type": "string"
-        },
-        "prettyPrint": {
-            "default": "true",
-            "description": "Returns response with indentations and line breaks.",
-            "location": "query",
-            "type": "boolean"
-        },
-        "uploadType": {
-            "description": "Legacy upload protocol for media (e.g. \"media\", \"multipart\").",
-            "location": "query",
-            "type": "string"
-        },
-        "fields": {
-            "description": "Selector specifying which fields to include in a partial response.",
-            "location": "query",
-            "type": "string"
         }
     },
     "protocol": "rest",
     "resources": {
         "media": {
             "methods": {
                 "download": {
                     "description": "Method for media download. Download is supported\non the URI `/v1/media/{+name}?alt=media`.",
                     "httpMethod": "GET",
                     "id": "youtubereporting.media.download",
@@ skipping 45 matching lines @@
                     },
                     "path": "v1/jobs/{jobId}",
                     "response": {
                         "$ref": "Empty"
                     },
                     "scopes": [
                         "https://www.googleapis.com/auth/yt-analytics-monetary.readonly",
                         "https://www.googleapis.com/auth/yt-analytics.readonly"
                     ]
                 },
-                "list": {
-                    "description": "Lists jobs.",
-                    "httpMethod": "GET",
-                    "id": "youtubereporting.jobs.list",
-                    "parameterOrder": [],
-                    "parameters": {
-                        "pageToken": {
-                            "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.",
-                            "location": "query",
-                            "type": "string"
-                        },
-                        "includeSystemManaged": {
-                            "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.",
-                            "location": "query",
-                            "type": "boolean"
-                        },
-                        "pageSize": {
-                            "description": "Requested page size. Server may return fewer jobs than requested.\nIf unspecified, server will pick an appropriate default.",
-                            "format": "int32",
-                            "location": "query",
-                            "type": "integer"
-                        },
-                        "onBehalfOfContentOwner": {
-                            "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).",
-                            "location": "query",
-                            "type": "string"
-                        }
-                    },
-                    "path": "v1/jobs",
-                    "response": {
-                        "$ref": "ListJobsResponse"
-                    },
-                    "scopes": [
-                        "https://www.googleapis.com/auth/yt-analytics-monetary.readonly",
-                        "https://www.googleapis.com/auth/yt-analytics.readonly"
-                    ]
-                },
                 "get": {
                     "description": "Gets a job.",
                     "httpMethod": "GET",
                     "id": "youtubereporting.jobs.get",
                     "parameterOrder": [
                         "jobId"
                     ],
                     "parameters": {
                         "jobId": {
                             "description": "The ID of the job to retrieve.",
                             "location": "path",
                             "required": true,
                             "type": "string"
                         },
                         "onBehalfOfContentOwner": {
                             "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).",
                             "location": "query",
                             "type": "string"
                         }
                     },
                     "path": "v1/jobs/{jobId}",
                     "response": {
                         "$ref": "Job"
                     },
                     "scopes": [
                         "https://www.googleapis.com/auth/yt-analytics-monetary.readonly",
+                        "https://www.googleapis.com/auth/yt-analytics.readonly"
+                    ]
+                },
+                "list": {
+                    "description": "Lists jobs.",
+                    "httpMethod": "GET",
+                    "id": "youtubereporting.jobs.list",
+                    "parameterOrder": [],
+                    "parameters": {
+                        "onBehalfOfContentOwner": {
+                            "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).",
+                            "location": "query",
+                            "type": "string"
+                        },
+                        "includeSystemManaged": {
+                            "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.",
+                            "location": "query",
+                            "type": "boolean"
+                        },
+                        "pageToken": {
+                            "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.",
+                            "location": "query",
+                            "type": "string"
+                        },
+                        "pageSize": {
+                            "description": "Requested page size. Server may return fewer jobs than requested.\nIf unspecified, server will pick an appropriate default.",
+                            "format": "int32",
+                            "location": "query",
+                            "type": "integer"
+                        }
+                    },
+                    "path": "v1/jobs",
+                    "response": {
+                        "$ref": "ListJobsResponse"
+                    },
+                    "scopes": [
+                        "https://www.googleapis.com/auth/yt-analytics-monetary.readonly",
                         "https://www.googleapis.com/auth/yt-analytics.readonly"
                     ]
                 },
                 "create": {
                     "description": "Creates a job and returns it.",
                     "httpMethod": "POST",
                     "id": "youtubereporting.jobs.create",
                     "parameterOrder": [],
                     "parameters": {
                         "onBehalfOfContentOwner": {
@@ skipping 11 matching lines @@
                     },
                     "scopes": [
                         "https://www.googleapis.com/auth/yt-analytics-monetary.readonly",
                         "https://www.googleapis.com/auth/yt-analytics.readonly"
                     ]
                 }
             },
             "resources": {
                 "reports": {
                     "methods": {
+                        "get": {
+                            "description": "Gets the metadata of a specific report.",
+                            "httpMethod": "GET",
+                            "id": "youtubereporting.jobs.reports.get",
+                            "parameterOrder": [
+                                "jobId",
+                                "reportId"
+                            ],
+                            "parameters": {
+                                "reportId": {
+                                    "description": "The ID of the report to retrieve.",
+                                    "location": "path",
+                                    "required": true,
+                                    "type": "string"
+                                },
+                                "jobId": {
+                                    "description": "The ID of the job.",
+                                    "location": "path",
+                                    "required": true,
+                                    "type": "string"
+                                },
+                                "onBehalfOfContentOwner": {
+                                    "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).",
+                                    "location": "query",
+                                    "type": "string"
+                                }
+                            },
+                            "path": "v1/jobs/{jobId}/reports/{reportId}",
+                            "response": {
+                                "$ref": "Report"
+                            },
+                            "scopes": [
+                                "https://www.googleapis.com/auth/yt-analytics-monetary.readonly",
+                                "https://www.googleapis.com/auth/yt-analytics.readonly"
+                            ]
+                        },
                         "list": {
                             "description": "Lists reports created by a specific job.\nReturns NOT_FOUND if the job does not exist.",
                             "httpMethod": "GET",
                             "id": "youtubereporting.jobs.reports.list",
                             "parameterOrder": [
                                 "jobId"
                             ],
                             "parameters": {
-                                "startTimeBefore": {
-                                    "description": "If set, only reports whose start time is smaller than the specified\ndate/time are returned.",
-                                    "format": "google-datetime",
-                                    "location": "query",
-                                    "type": "string"
-                                },
                                 "jobId": {
                                     "description": "The ID of the job.",
                                     "location": "path",
                                     "required": true,
                                     "type": "string"
                                 },
                                 "createdAfter": {
                                     "description": "If set, only reports created after the specified date/time are returned.",
                                     "format": "google-datetime",
                                     "location": "query",
@@ skipping 13 matching lines @@
                                 "pageSize": {
                                     "description": "Requested page size. Server may return fewer report types than requested.\nIf unspecified, server will pick an appropriate default.",
                                     "format": "int32",
                                     "location": "query",
                                     "type": "integer"
                                 },
                                 "onBehalfOfContentOwner": {
                                     "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).",
                                     "location": "query",
                                     "type": "string"
+                                },
+                                "startTimeBefore": {
+                                    "description": "If set, only reports whose start time is smaller than the specified\ndate/time are returned.",
+                                    "format": "google-datetime",
+                                    "location": "query",
+                                    "type": "string"
                                 }
                             },
                             "path": "v1/jobs/{jobId}/reports",
                             "response": {
                                 "$ref": "ListReportsResponse"
                             },
                             "scopes": [
                                 "https://www.googleapis.com/auth/yt-analytics-monetary.readonly",
-                                "https://www.googleapis.com/auth/yt-analytics.readonly"
-                            ]
-                        },
-                        "get": {
-                            "description": "Gets the metadata of a specific report.",
-                            "httpMethod": "GET",
-                            "id": "youtubereporting.jobs.reports.get",
-                            "parameterOrder": [
-                                "jobId",
-                                "reportId"
-                            ],
-                            "parameters": {
-                                "jobId": {
-                                    "description": "The ID of the job.",
-                                    "location": "path",
-                                    "required": true,
-                                    "type": "string"
-                                },
-                                "onBehalfOfContentOwner": {
-                                    "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).",
-                                    "location": "query",
-                                    "type": "string"
-                                },
-                                "reportId": {
-                                    "description": "The ID of the report to retrieve.",
-                                    "location": "path",
-                                    "required": true,
-                                    "type": "string"
-                                }
-                            },
-                            "path": "v1/jobs/{jobId}/reports/{reportId}",
-                            "response": {
-                                "$ref": "Report"
-                            },
-                            "scopes": [
-                                "https://www.googleapis.com/auth/yt-analytics-monetary.readonly",
                                 "https://www.googleapis.com/auth/yt-analytics.readonly"
                             ]
                         }
                     }
                 }
             }
         },
         "reportTypes": {
             "methods": {
                 "list": {
                     "description": "Lists report types.",
                     "httpMethod": "GET",
                     "id": "youtubereporting.reportTypes.list",
                     "parameterOrder": [],
                     "parameters": {
+                        "includeSystemManaged": {
+                            "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.",
+                            "location": "query",
+                            "type": "boolean"
+                        },
                         "pageToken": {
                             "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.",
                             "location": "query",
                             "type": "string"
                         },
-                        "includeSystemManaged": {
-                            "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.",
-                            "location": "query",
-                            "type": "boolean"
-                        },
                         "pageSize": {
                             "description": "Requested page size. Server may return fewer report types than requested.\nIf unspecified, server will pick an appropriate default.",
                             "format": "int32",
                             "location": "query",
                             "type": "integer"
                         },
                         "onBehalfOfContentOwner": {
                             "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).",
                             "location": "query",
                             "type": "string"
                         }
                     },
                     "path": "v1/reportTypes",
                     "response": {
                         "$ref": "ListReportTypesResponse"
                     },
                     "scopes": [
                         "https://www.googleapis.com/auth/yt-analytics-monetary.readonly",
                         "https://www.googleapis.com/auth/yt-analytics.readonly"
                     ]
                 }
             }
         }
     },
-    "revision": "20170611",
+    "revision": "20170709",
     "rootUrl": "https://youtubereporting.googleapis.com/",
     "schemas": {
+        "Job": {
+            "description": "A job creating reports of a specific type.",
+            "id": "Job",
+            "properties": {
+                "createTime": {
+                    "description": "The creation date/time of the job.",
+                    "format": "google-datetime",
+                    "type": "string"
+                },
+                "reportTypeId": {
+                    "description": "The type of reports this job creates. Corresponds to the ID of a\nReportType.",
+                    "type": "string"
+                },
+                "expireTime": {
+                    "description": "The date/time when this job will expire/expired. After a job expired, no\nnew reports are generated.",
+                    "format": "google-datetime",
+                    "type": "string"
+                },
+                "name": {
+                    "description": "The name of the job (max. 100 characters).",
+                    "type": "string"
+                },
+                "systemManaged": {
+                    "description": "True if this a system-managed job that cannot be modified by the user;\notherwise false.",
+                    "type": "boolean"
+                },
+                "id": {
+                    "description": "The server-generated ID of the job (max. 40 characters).",
+                    "type": "string"
+                }
+            },
+            "type": "object"
+        },
+        "ListReportsResponse": {
+            "description": "Response message for ReportingService.ListReports.",
+            "id": "ListReportsResponse",
+            "properties": {
+                "nextPageToken": {
+                    "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.",
+                    "type": "string"
+                },
+                "reports": {
+                    "description": "The list of report types.",
+                    "items": {
+                        "$ref": "Report"
+                    },
+                    "type": "array"
+                }
+            },
+            "type": "object"
+        },
         "Media": {
             "description": "Media resource.",
             "id": "Media",
             "properties": {
                 "resourceName": {
                     "description": "Name of the media resource.",
                     "type": "string"
                 }
             },
-            "type": "object"
-        },
-        "ReportType": {
-            "description": "A report type.",
-            "id": "ReportType",
-            "properties": {
-                "id": {
-                    "description": "The ID of the report type (max. 100 characters).",
-                    "type": "string"
-                },
-                "systemManaged": {
-                    "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.",
-                    "type": "boolean"
-                },
-                "deprecateTime": {
-                    "description": "The date/time when this report type was/will be deprecated.",
-                    "format": "google-datetime",
-                    "type": "string"
-                },
-                "name": {
-                    "description": "The name of the report type (max. 100 characters).",
-                    "type": "string"
-                }
-            },
-            "type": "object"
-        },
-        "ListReportTypesResponse": {
-            "description": "Response message for ReportingService.ListReportTypes.",
-            "id": "ListReportTypesResponse",
-            "properties": {
-                "reportTypes": {
-                    "description": "The list of report types.",
-                    "items": {
-                        "$ref": "ReportType"
-                    },
-                    "type": "array"
-                },
-                "nextPageToken": {
-                    "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.",
-                    "type": "string"
-                }
-            },
             "type": "object"
         },
         "Report": {
             "description": "A report's metadata including the URL from which the report itself can be\ndownloaded.",
             "id": "Report",
             "properties": {
                 "jobId": {
                     "description": "The ID of the job that created this report.",
                     "type": "string"
                 },
                 "id": {
                     "description": "The server-generated ID of the report.",
                     "type": "string"
                 },
+                "endTime": {
+                    "description": "The end of the time period that the report instance covers. The value is\nexclusive.",
+                    "format": "google-datetime",
+                    "type": "string"
+                },
                 "jobExpireTime": {
                     "description": "The date/time when the job this report belongs to will expire/expired.",
                     "format": "google-datetime",
                     "type": "string"
                 },
-                "endTime": {
-                    "description": "The end of the time period that the report instance covers. The value is\nexclusive.",
-                    "format": "google-datetime",
-                    "type": "string"
-                },
                 "downloadUrl": {
                     "description": "The URL from which the report can be downloaded (max. 1000 characters).",
                     "type": "string"
                 },
                 "startTime": {
                     "description": "The start of the time period that the report instance covers. The value is\ninclusive.",
                     "format": "google-datetime",
                     "type": "string"
                 },
                 "createTime": {
                     "description": "The date/time when this report was created.",
                     "format": "google-datetime",
                     "type": "string"
                 }
             },
             "type": "object"
         },
         "Empty": {
             "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 `{}`.",
             "id": "Empty",
             "properties": {},
             "type": "object"
         },
+        "ListReportTypesResponse": {
+            "description": "Response message for ReportingService.ListReportTypes.",
+            "id": "ListReportTypesResponse",
+            "properties": {
+                "reportTypes": {
+                    "description": "The list of report types.",
+                    "items": {
+                        "$ref": "ReportType"
+                    },
+                    "type": "array"
+                },
+                "nextPageToken": {
+                    "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.",
+                    "type": "string"
+                }
+            },
+            "type": "object"
+        },
+        "ReportType": {
+            "description": "A report type.",
+            "id": "ReportType",
+            "properties": {
+                "systemManaged": {
+                    "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.",
+                    "type": "boolean"
+                },
+                "id": {
+                    "description": "The ID of the report type (max. 100 characters).",
+                    "type": "string"
+                },
+                "deprecateTime": {
+                    "description": "The date/time when this report type was/will be deprecated.",
+                    "format": "google-datetime",
+                    "type": "string"
+                },
+                "name": {
+                    "description": "The name of the report type (max. 100 characters).",
+                    "type": "string"
+                }
+            },
+            "type": "object"
+        },
         "ListJobsResponse": {
             "description": "Response message for ReportingService.ListJobs.",
             "id": "ListJobsResponse",
             "properties": {
+                "nextPageToken": {
+                    "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.",
+                    "type": "string"
+                },
                 "jobs": {
                     "description": "The list of jobs.",
                     "items": {
                         "$ref": "Job"
                     },
                     "type": "array"
-                },
-                "nextPageToken": {
-                    "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.",
-                    "type": "string"
                 }
-            },
-            "type": "object"
-        },
-        "Job": {
-            "description": "A job creating reports of a specific type.",
-            "id": "Job",
-            "properties": {
-                "id": {
-                    "description": "The server-generated ID of the job (max. 40 characters).",
-                    "type": "string"
-                },
-                "systemManaged": {
-                    "description": "True if this a system-managed job that cannot be modified by the user;\notherwise false.",
-                    "type": "boolean"
-                },
-                "createTime": {
-                    "description": "The creation date/time of the job.",
-                    "format": "google-datetime",
-                    "type": "string"
-                },
-                "reportTypeId": {
-                    "description": "The type of reports this job creates. Corresponds to the ID of a\nReportType.",
-                    "type": "string"
-                },
-                "expireTime": {
-                    "description": "The date/time when this job will expire/expired. After a job expired, no\nnew reports are generated.",
-                    "format": "google-datetime",
-                    "type": "string"
-                },
-                "name": {
-                    "description": "The name of the job (max. 100 characters).",
-                    "type": "string"
-                }
-            },
-            "type": "object"
-        },
-        "ListReportsResponse": {
-            "description": "Response message for ReportingService.ListReports.",
-            "id": "ListReportsResponse",
-            "properties": {
-                "nextPageToken": {
-                    "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.",
-                    "type": "string"
-                },
-                "reports": {
-                    "description": "The list of report types.",
-                    "items": {
-                        "$ref": "Report"
-                    },
-                    "type": "array"
-                }
             },
             "type": "object"
         }
     },
     "servicePath": "",
     "title": "YouTube Reporting API",
     "version": "v1"
 }