Api-Roll 54: 2017-09-11

discovery/googleapis/youtubereporting__v1.json

 {
     "auth": {
         "oauth2": {
             "scopes": {
                 "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"
                 }
@@ skipping 10 matching lines @@
     "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"
+        },
         "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"
         },
+        "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"
         },
-        "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"
-        },
         "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"
-        },
-        "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"
         }
     },
     "protocol": "rest",
     "resources": {
-        "jobs": {
+        "media": {
             "methods": {
-                "create": {
-                    "description": "Creates a job and returns it.",
-                    "httpMethod": "POST",
-                    "id": "youtubereporting.jobs.create",
-                    "parameterOrder": [],
+                "download": {
+                    "description": "Method for media download. Download is supported\non the URI `/v1/media/{+name}?alt=media`.",
+                    "httpMethod": "GET",
+                    "id": "youtubereporting.media.download",
+                    "parameterOrder": [
+                        "resourceName"
+                    ],
                     "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",
+                        "resourceName": {
+                            "description": "Name of the media that is being downloaded.  See\nReadRequest.resource_name.",
+                            "location": "path",
+                            "pattern": "^.+$",
+                            "required": true,
                             "type": "string"
                         }
                     },
-                    "path": "v1/jobs",
-                    "request": {
-                        "$ref": "Job"
-                    },
+                    "path": "v1/media/{+resourceName}",
                     "response": {
-                        "$ref": "Job"
+                        "$ref": "Media"
                     },
                     "scopes": [
                         "https://www.googleapis.com/auth/yt-analytics-monetary.readonly",
                         "https://www.googleapis.com/auth/yt-analytics.readonly"
-                    ]
-                },
-                "delete": {
-                    "description": "Deletes a job.",
-                    "httpMethod": "DELETE",
-                    "id": "youtubereporting.jobs.delete",
-                    "parameterOrder": [
-                        "jobId"
                     ],
-                    "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"
-                        },
-                        "jobId": {
-                            "description": "The ID of the job to delete.",
-                            "location": "path",
-                            "required": true,
-                            "type": "string"
-                        }
-                    },
-                    "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"
-                    ]
-                },
+                    "supportsMediaDownload": true
+                }
+            }
+        },
+        "jobs": {
+            "methods": {
                 "get": {
                     "description": "Gets a job.",
                     "httpMethod": "GET",
                     "id": "youtubereporting.jobs.get",
                     "parameterOrder": [
                         "jobId"
                     ],
                     "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"
-                        },
                         "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"
                     ]
@@ skipping 27 matching lines @@
                         }
                     },
                     "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": {
+                            "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",
+                    "request": {
+                        "$ref": "Job"
+                    },
+                    "response": {
+                        "$ref": "Job"
+                    },
+                    "scopes": [
+                        "https://www.googleapis.com/auth/yt-analytics-monetary.readonly",
+                        "https://www.googleapis.com/auth/yt-analytics.readonly"
+                    ]
+                },
+                "delete": {
+                    "description": "Deletes a job.",
+                    "httpMethod": "DELETE",
+                    "id": "youtubereporting.jobs.delete",
+                    "parameterOrder": [
+                        "jobId"
+                    ],
+                    "parameters": {
+                        "jobId": {
+                            "description": "The ID of the job to delete.",
+                            "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": "Empty"
+                    },
+                    "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"
-                                },
-                                "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"
                             ]
                         },
                         "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": {
+                                "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"
+                                },
+                                "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",
                                     "type": "string"
                                 },
-                                "pageToken": {
-                                    "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.",
-                                    "location": "query",
-                                    "type": "string"
-                                },
                                 "startTimeAtOrAfter": {
                                     "description": "If set, only reports whose start time is greater than or equal the\nspecified date/time are returned.",
                                     "format": "google-datetime",
                                     "location": "query",
                                     "type": "string"
                                 },
+                                "pageToken": {
+                                    "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.",
+                                    "location": "query",
+                                    "type": "string"
+                                },
                                 "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"
-                                },
-                                "jobId": {
-                                    "description": "The ID of the job.",
-                                    "location": "path",
-                                    "required": true,
-                                    "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"
                             ]
@@ skipping 35 matching lines @@
                     "path": "v1/reportTypes",
                     "response": {
                         "$ref": "ListReportTypesResponse"
                     },
                     "scopes": [
                         "https://www.googleapis.com/auth/yt-analytics-monetary.readonly",
                         "https://www.googleapis.com/auth/yt-analytics.readonly"
                     ]
                 }
             }
-        },
-        "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",
-                    "parameterOrder": [
-                        "resourceName"
-                    ],
-                    "parameters": {
-                        "resourceName": {
-                            "description": "Name of the media that is being downloaded.  See\nReadRequest.resource_name.",
-                            "location": "path",
-                            "pattern": "^.+$",
-                            "required": true,
-                            "type": "string"
-                        }
-                    },
-                    "path": "v1/media/{+resourceName}",
-                    "response": {
-                        "$ref": "Media"
-                    },
-                    "scopes": [
-                        "https://www.googleapis.com/auth/yt-analytics-monetary.readonly",
-                        "https://www.googleapis.com/auth/yt-analytics.readonly"
-                    ],
-                    "supportsMediaDownload": true
-                }
-            }
         }
     },
-    "revision": "20170816",
+    "revision": "20170905",
     "rootUrl": "https://youtubereporting.googleapis.com/",
     "schemas": {
-        "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"
-                }
-            },
-            "type": "object"
-        },
         "Job": {
             "description": "A job creating reports of a specific type.",
             "id": "Job",
             "properties": {
-                "name": {
-                    "description": "The name of the job (max. 100 characters).",
-                    "type": "string"
-                },
-                "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"
+                },
+                "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.",
@@ skipping 13 matching lines @@
             "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": {
-                "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"
-        },
-        "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"
-        },
-        "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"
-        },
         "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.",
+                "jobExpireTime": {
+                    "description": "The date/time when the job this report belongs to will expire/expired.",
                     "format": "google-datetime",
                     "type": "string"
                 },
-                "jobExpireTime": {
-                    "description": "The date/time when the job this report belongs to will expire/expired.",
+                "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": {
+                "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"
                 },
-                "jobId": {
-                    "description": "The ID of the job that created this report.",
+                "reportTypes": {
+                    "description": "The list of report types.",
+                    "items": {
+                        "$ref": "ReportType"
+                    },
+                    "type": "array"
+                }
+            },
+            "type": "object"
+        },
+        "ReportType": {
+            "description": "A report type.",
+            "id": "ReportType",
+            "properties": {
+                "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"
+                },
+                "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"
                 }
             },
+            "type": "object"
+        },
+        "ListJobsResponse": {
+            "description": "Response message for ReportingService.ListJobs.",
+            "id": "ListJobsResponse",
+            "properties": {
+                "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"
         }
     },
     "servicePath": "",
     "title": "YouTube Reporting API",
     "version": "v1"
 }