| Index: discovery/googleapis/youtubereporting__v1.json
|
| diff --git a/discovery/googleapis/youtubereporting__v1.json b/discovery/googleapis/youtubereporting__v1.json
|
| index 6a8448c574c1fd84962a34bf5029c91760384b25..1739ceaecce272ca97d6467241a1aeccf8d03405 100644
|
| --- a/discovery/googleapis/youtubereporting__v1.json
|
| +++ b/discovery/googleapis/youtubereporting__v1.json
|
| @@ -28,19 +28,34 @@
|
| "ownerDomain": "google.com",
|
| "ownerName": "Google",
|
| "parameters": {
|
| + "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.",
|
| + "bearer_token": {
|
| + "description": "OAuth bearer token.",
|
| "location": "query",
|
| "type": "string"
|
| },
|
| - "bearer_token": {
|
| - "description": "OAuth bearer token.",
|
| + "oauth_token": {
|
| + "description": "OAuth 2.0 token for the current user.",
|
| "location": "query",
|
| "type": "string"
|
| },
|
| @@ -55,13 +70,18 @@
|
| "location": "query",
|
| "type": "boolean"
|
| },
|
| + "fields": {
|
| + "description": "Selector specifying which fields to include in a partial response.",
|
| + "location": "query",
|
| + "type": "string"
|
| + },
|
| "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.",
|
| + "callback": {
|
| + "description": "JSONP",
|
| "location": "query",
|
| "type": "string"
|
| },
|
| @@ -78,11 +98,6 @@
|
| "location": "query",
|
| "type": "string"
|
| },
|
| - "callback": {
|
| - "description": "JSONP",
|
| - "location": "query",
|
| - "type": "string"
|
| - },
|
| "alt": {
|
| "default": "json",
|
| "description": "Data format for response.",
|
| @@ -98,129 +113,87 @@
|
| ],
|
| "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"
|
| }
|
| },
|
| "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",
|
| - "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
|
| - }
|
| - }
|
| - },
|
| "jobs": {
|
| "methods": {
|
| - "list": {
|
| - "description": "Lists jobs.",
|
| - "httpMethod": "GET",
|
| - "id": "youtubereporting.jobs.list",
|
| + "create": {
|
| + "description": "Creates a job and returns it.",
|
| + "httpMethod": "POST",
|
| + "id": "youtubereporting.jobs.create",
|
| "parameterOrder": [],
|
| "parameters": {
|
| - "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"
|
| - },
|
| - "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"
|
| }
|
| },
|
| "path": "v1/jobs",
|
| + "request": {
|
| + "$ref": "Job"
|
| + },
|
| "response": {
|
| - "$ref": "ListJobsResponse"
|
| + "$ref": "Job"
|
| },
|
| "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",
|
| + "delete": {
|
| + "description": "Deletes a job.",
|
| + "httpMethod": "DELETE",
|
| + "id": "youtubereporting.jobs.delete",
|
| "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"
|
| + },
|
| + "jobId": {
|
| + "description": "The ID of the job to delete.",
|
| + "location": "path",
|
| + "required": true,
|
| + "type": "string"
|
| }
|
| },
|
| "path": "v1/jobs/{jobId}",
|
| "response": {
|
| - "$ref": "Job"
|
| + "$ref": "Empty"
|
| },
|
| "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",
|
| + "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",
|
| @@ -228,27 +201,24 @@
|
| }
|
| },
|
| "path": "v1/jobs",
|
| - "request": {
|
| - "$ref": "Job"
|
| - },
|
| "response": {
|
| - "$ref": "Job"
|
| + "$ref": "ListJobsResponse"
|
| },
|
| "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",
|
| + "get": {
|
| + "description": "Gets a job.",
|
| + "httpMethod": "GET",
|
| + "id": "youtubereporting.jobs.get",
|
| "parameterOrder": [
|
| "jobId"
|
| ],
|
| "parameters": {
|
| "jobId": {
|
| - "description": "The ID of the job to delete.",
|
| + "description": "The ID of the job to retrieve.",
|
| "location": "path",
|
| "required": true,
|
| "type": "string"
|
| @@ -261,7 +231,7 @@
|
| },
|
| "path": "v1/jobs/{jobId}",
|
| "response": {
|
| - "$ref": "Empty"
|
| + "$ref": "Job"
|
| },
|
| "scopes": [
|
| "https://www.googleapis.com/auth/yt-analytics-monetary.readonly",
|
| @@ -280,6 +250,11 @@
|
| "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",
|
| @@ -314,11 +289,6 @@
|
| "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/{jobId}/reports",
|
| @@ -339,6 +309,11 @@
|
| "reportId"
|
| ],
|
| "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"
|
| + },
|
| "reportId": {
|
| "description": "The ID of the report to retrieve.",
|
| "location": "path",
|
| @@ -350,11 +325,6 @@
|
| "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}",
|
| @@ -378,6 +348,11 @@
|
| "id": "youtubereporting.reportTypes.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"
|
| + },
|
| "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",
|
| @@ -393,11 +368,6 @@
|
| "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",
|
| @@ -410,68 +380,89 @@
|
| ]
|
| }
|
| }
|
| + },
|
| + "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": "20170209",
|
| + "revision": "20170302",
|
| "rootUrl": "https://youtubereporting.googleapis.com/",
|
| "schemas": {
|
| - "Job": {
|
| - "description": "A job creating reports of a specific type.",
|
| - "id": "Job",
|
| + "Media": {
|
| + "description": "Media resource.",
|
| + "id": "Media",
|
| "properties": {
|
| - "createTime": {
|
| - "description": "The creation date/time of the job.",
|
| - "format": "google-datetime",
|
| - "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"
|
| - },
|
| - "reportTypeId": {
|
| - "description": "The type of reports this job creates. Corresponds to the ID of a\nReportType.",
|
| + "resourceName": {
|
| + "description": "Name of the media resource.",
|
| "type": "string"
|
| - },
|
| - "name": {
|
| - "description": "The name of the job (max. 100 characters).",
|
| + }
|
| + },
|
| + "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 job that cannot be modified by the user;\notherwise false.",
|
| + "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 server-generated ID of the job (max. 40 characters).",
|
| + "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"
|
| },
|
| - "ListReportsResponse": {
|
| - "description": "Response message for ReportingService.ListReports.",
|
| - "id": "ListReportsResponse",
|
| + "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\nListReportsRequest.page_token\nfield in the subsequent call to `ListReports` method to retrieve the next\npage of results.",
|
| - "type": "string"
|
| - },
|
| - "reports": {
|
| + "reportTypes": {
|
| "description": "The list of report types.",
|
| "items": {
|
| - "$ref": "Report"
|
| + "$ref": "ReportType"
|
| },
|
| "type": "array"
|
| - }
|
| - },
|
| - "type": "object"
|
| - },
|
| - "Media": {
|
| - "description": "Media resource.",
|
| - "id": "Media",
|
| - "properties": {
|
| - "resourceName": {
|
| - "description": "Name of the media resource.",
|
| + },
|
| + "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"
|
| }
|
| },
|
| @@ -481,6 +472,10 @@
|
| "description": "A report's metadata including the URL from which the report itself can be\ndownloaded.",
|
| "id": "Report",
|
| "properties": {
|
| + "id": {
|
| + "description": "The server-generated ID of the report.",
|
| + "type": "string"
|
| + },
|
| "jobExpireTime": {
|
| "description": "The date/time when the job this report belongs to will expire/expired.",
|
| "format": "google-datetime",
|
| @@ -508,10 +503,6 @@
|
| "jobId": {
|
| "description": "The ID of the job that created this report.",
|
| "type": "string"
|
| - },
|
| - "id": {
|
| - "description": "The server-generated ID of the report.",
|
| - "type": "string"
|
| }
|
| },
|
| "type": "object"
|
| @@ -522,61 +513,70 @@
|
| "properties": {},
|
| "type": "object"
|
| },
|
| - "ListReportTypesResponse": {
|
| - "description": "Response message for ReportingService.ListReportTypes.",
|
| - "id": "ListReportTypesResponse",
|
| + "ListJobsResponse": {
|
| + "description": "Response message for ReportingService.ListJobs.",
|
| + "id": "ListJobsResponse",
|
| "properties": {
|
| - "reportTypes": {
|
| - "description": "The list of report types.",
|
| + "jobs": {
|
| + "description": "The list of jobs.",
|
| "items": {
|
| - "$ref": "ReportType"
|
| + "$ref": "Job"
|
| },
|
| "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.",
|
| + "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"
|
| },
|
| - "ReportType": {
|
| - "description": "A report type.",
|
| - "id": "ReportType",
|
| + "Job": {
|
| + "description": "A job creating reports of a specific type.",
|
| + "id": "Job",
|
| "properties": {
|
| - "deprecateTime": {
|
| - "description": "The date/time when this report type was/will be deprecated.",
|
| + "createTime": {
|
| + "description": "The creation date/time of the job.",
|
| "format": "google-datetime",
|
| "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"
|
| + },
|
| + "reportTypeId": {
|
| + "description": "The type of reports this job creates. Corresponds to the ID of a\nReportType.",
|
| + "type": "string"
|
| + },
|
| "name": {
|
| - "description": "The name of the report type (max. 100 characters).",
|
| + "description": "The name of the job (max. 100 characters).",
|
| "type": "string"
|
| },
|
| "id": {
|
| - "description": "The ID of the report type (max. 100 characters).",
|
| + "description": "The server-generated ID of the job (max. 40 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.",
|
| + "description": "True if this a system-managed job that cannot be modified by the user;\notherwise false.",
|
| "type": "boolean"
|
| }
|
| },
|
| "type": "object"
|
| },
|
| - "ListJobsResponse": {
|
| - "description": "Response message for ReportingService.ListJobs.",
|
| - "id": "ListJobsResponse",
|
| + "ListReportsResponse": {
|
| + "description": "Response message for ReportingService.ListReports.",
|
| + "id": "ListReportsResponse",
|
| "properties": {
|
| - "jobs": {
|
| - "description": "The list of jobs.",
|
| + "reports": {
|
| + "description": "The list of report types.",
|
| "items": {
|
| - "$ref": "Job"
|
| + "$ref": "Report"
|
| },
|
| "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.",
|
| + "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"
|
| }
|
| },
|
|
|