Index: discovery/googleapis/youtubereporting__v1.json |
diff --git a/discovery/googleapis/youtubereporting__v1.json b/discovery/googleapis/youtubereporting__v1.json |
index da0f09164a9224b104e7a76475624ddcc76af724..6a8448c574c1fd84962a34bf5029c91760384b25 100644 |
--- a/discovery/googleapis/youtubereporting__v1.json |
+++ b/discovery/googleapis/youtubereporting__v1.json |
@@ -28,51 +28,40 @@ |
"ownerDomain": "google.com", |
"ownerName": "Google", |
"parameters": { |
- "access_token": { |
- "description": "OAuth access token.", |
- "location": "query", |
- "type": "string" |
- }, |
- "prettyPrint": { |
+ "pp": { |
"default": "true", |
- "description": "Returns response with indentations and line breaks.", |
+ "description": "Pretty-print response.", |
"location": "query", |
"type": "boolean" |
}, |
- "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.", |
+ "oauth_token": { |
+ "description": "OAuth 2.0 token for the current user.", |
"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.", |
+ "bearer_token": { |
+ "description": "OAuth bearer token.", |
"location": "query", |
"type": "string" |
}, |
- "pp": { |
+ "upload_protocol": { |
+ "description": "Upload protocol for media (e.g. \"raw\", \"multipart\").", |
+ "location": "query", |
+ "type": "string" |
+ }, |
+ "prettyPrint": { |
"default": "true", |
- "description": "Pretty-print response.", |
+ "description": "Returns response with indentations and line breaks.", |
"location": "query", |
"type": "boolean" |
}, |
- "fields": { |
- "description": "Selector specifying which fields to include in a partial response.", |
+ "uploadType": { |
+ "description": "Legacy upload protocol for media (e.g. \"media\", \"multipart\").", |
"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" |
- ], |
+ "fields": { |
+ "description": "Selector specifying which fields to include in a partial response.", |
"location": "query", |
"type": "string" |
}, |
@@ -94,70 +83,40 @@ |
"location": "query", |
"type": "string" |
}, |
- "oauth_token": { |
- "description": "OAuth 2.0 token for the current user.", |
+ "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" |
}, |
- "uploadType": { |
- "description": "Legacy upload protocol for media (e.g. \"media\", \"multipart\").", |
+ "access_token": { |
+ "description": "OAuth access token.", |
"location": "query", |
"type": "string" |
}, |
- "bearer_token": { |
- "description": "OAuth bearer token.", |
+ "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" |
}, |
- "upload_protocol": { |
- "description": "Upload protocol for media (e.g. \"raw\", \"multipart\").", |
+ "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": { |
- "reportTypes": { |
- "methods": { |
- "list": { |
- "description": "Lists report types.", |
- "httpMethod": "GET", |
- "id": "youtubereporting.reportTypes.list", |
- "parameterOrder": [], |
- "parameters": { |
- "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" |
- }, |
- "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" |
- }, |
- "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", |
- "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" |
- ] |
- } |
- } |
- }, |
"media": { |
"methods": { |
"download": { |
@@ -190,24 +149,37 @@ |
}, |
"jobs": { |
"methods": { |
- "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": { |
+ "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": "Job" |
+ "$ref": "ListJobsResponse" |
}, |
"scopes": [ |
"https://www.googleapis.com/auth/yt-analytics-monetary.readonly", |
@@ -243,37 +215,24 @@ |
"https://www.googleapis.com/auth/yt-analytics.readonly" |
] |
}, |
- "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" |
- }, |
- "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" |
- }, |
"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" |
} |
}, |
"path": "v1/jobs", |
+ "request": { |
+ "$ref": "Job" |
+ }, |
"response": { |
- "$ref": "ListJobsResponse" |
+ "$ref": "Job" |
}, |
"scopes": [ |
"https://www.googleapis.com/auth/yt-analytics-monetary.readonly", |
@@ -313,52 +272,29 @@ |
"resources": { |
"reports": { |
"methods": { |
- "get": { |
- "description": "Gets the metadata of a specific report.", |
+ "list": { |
+ "description": "Lists reports created by a specific job.\nReturns NOT_FOUND if the job does not exist.", |
"httpMethod": "GET", |
- "id": "youtubereporting.jobs.reports.get", |
+ "id": "youtubereporting.jobs.reports.list", |
"parameterOrder": [ |
- "jobId", |
- "reportId" |
+ "jobId" |
], |
"parameters": { |
- "jobId": { |
- "description": "The ID of the job.", |
- "location": "path", |
- "required": true, |
+ "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" |
}, |
- "reportId": { |
- "description": "The ID of the report to retrieve.", |
+ "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": { |
- "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).", |
+ "createdAfter": { |
+ "description": "If set, only reports created after the specified date/time are returned.", |
+ "format": "google-datetime", |
"location": "query", |
"type": "string" |
}, |
@@ -368,9 +304,8 @@ |
"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", |
+ "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" |
}, |
@@ -380,11 +315,35 @@ |
"location": "query", |
"type": "integer" |
}, |
- "createdAfter": { |
- "description": "If set, only reports created after the specified date/time are returned.", |
- "format": "google-datetime", |
+ "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", |
+ "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": { |
+ "reportId": { |
+ "description": "The ID of the report to retrieve.", |
+ "location": "path", |
+ "required": true, |
+ "type": "string" |
}, |
"jobId": { |
"description": "The ID of the job.", |
@@ -392,15 +351,15 @@ |
"required": true, |
"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.", |
+ "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", |
+ "path": "v1/jobs/{jobId}/reports/{reportId}", |
"response": { |
- "$ref": "ListReportsResponse" |
+ "$ref": "Report" |
}, |
"scopes": [ |
"https://www.googleapis.com/auth/yt-analytics-monetary.readonly", |
@@ -410,62 +369,97 @@ |
} |
} |
} |
+ }, |
+ "reportTypes": { |
+ "methods": { |
+ "list": { |
+ "description": "Lists report types.", |
+ "httpMethod": "GET", |
+ "id": "youtubereporting.reportTypes.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 `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": "20170118", |
+ "revision": "20170209", |
"rootUrl": "https://youtubereporting.googleapis.com/", |
"schemas": { |
- "Report": { |
- "description": "A report's metadata including the URL from which the report itself can be\ndownloaded.", |
- "id": "Report", |
+ "Job": { |
+ "description": "A job creating reports of a specific type.", |
+ "id": "Job", |
"properties": { |
- "id": { |
- "description": "The server-generated ID of the report.", |
- "type": "string" |
- }, |
- "downloadUrl": { |
- "description": "The URL from which the report can be downloaded (max. 1000 characters).", |
- "type": "string" |
- }, |
- "endTime": { |
- "description": "The end of the time period that the report instance covers. The value is\nexclusive.", |
+ "createTime": { |
+ "description": "The creation date/time of the job.", |
"format": "google-datetime", |
"type": "string" |
}, |
- "createTime": { |
- "description": "The date/time when this report was created.", |
+ "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" |
}, |
- "startTime": { |
- "description": "The start of the time period that the report instance covers. The value is\ninclusive.", |
- "format": "google-datetime", |
+ "reportTypeId": { |
+ "description": "The type of reports this job creates. Corresponds to the ID of a\nReportType.", |
"type": "string" |
}, |
- "jobExpireTime": { |
- "description": "The date/time when the job this report belongs to will expire/expired.", |
- "format": "google-datetime", |
+ "name": { |
+ "description": "The name of the job (max. 100 characters).", |
"type": "string" |
}, |
- "jobId": { |
- "description": "The ID of the job that created this report.", |
+ "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" |
}, |
- "ListJobsResponse": { |
- "description": "Response message for ReportingService.ListJobs.", |
- "id": "ListJobsResponse", |
+ "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\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" |
}, |
- "jobs": { |
- "description": "The list of jobs.", |
+ "reports": { |
+ "description": "The list of report types.", |
"items": { |
- "$ref": "Job" |
+ "$ref": "Report" |
}, |
"type": "array" |
} |
@@ -483,34 +477,40 @@ |
}, |
"type": "object" |
}, |
- "Job": { |
- "description": "A job creating reports of a specific type.", |
- "id": "Job", |
+ "Report": { |
+ "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 job (max. 40 characters).", |
+ "jobExpireTime": { |
+ "description": "The date/time when the job this report belongs to will expire/expired.", |
+ "format": "google-datetime", |
"type": "string" |
}, |
- "createTime": { |
- "description": "The creation date/time of the job.", |
+ "endTime": { |
+ "description": "The end of the time period that the report instance covers. The value is\nexclusive.", |
"format": "google-datetime", |
"type": "string" |
}, |
- "systemManaged": { |
- "description": "True if this a system-managed job that cannot be modified by the user;\notherwise false.", |
- "type": "boolean" |
+ "downloadUrl": { |
+ "description": "The URL from which the report can be downloaded (max. 1000 characters).", |
+ "type": "string" |
}, |
- "expireTime": { |
- "description": "The date/time when this job will expire/expired. After a job expired, no\nnew reports are generated.", |
+ "startTime": { |
+ "description": "The start of the time period that the report instance covers. The value is\ninclusive.", |
"format": "google-datetime", |
"type": "string" |
}, |
- "name": { |
- "description": "The name of the job (max. 100 characters).", |
+ "createTime": { |
+ "description": "The date/time when this report was created.", |
+ "format": "google-datetime", |
"type": "string" |
}, |
- "reportTypeId": { |
- "description": "The type of reports this job creates. Corresponds to the ID of a\nReportType.", |
+ "jobId": { |
+ "description": "The ID of the job that created this report.", |
+ "type": "string" |
+ }, |
+ "id": { |
+ "description": "The server-generated ID of the report.", |
"type": "string" |
} |
}, |
@@ -522,61 +522,61 @@ |
"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" |
- }, |
"deprecateTime": { |
"description": "The date/time when this report type was/will be deprecated.", |
"format": "google-datetime", |
"type": "string" |
}, |
- "id": { |
- "description": "The ID of the report type (max. 100 characters).", |
- "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", |
- "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.", |
+ }, |
+ "id": { |
+ "description": "The ID of the report type (max. 100 characters).", |
"type": "string" |
}, |
- "reports": { |
- "description": "The list of report types.", |
- "items": { |
- "$ref": "Report" |
- }, |
- "type": "array" |
+ "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" |
} |
}, |
"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" |
} |
}, |