Api-roll 44: 2017-01-23

generated/googleapis/lib/youtubereporting/v1.dart

 // This is a generated file (see the discoveryapis_generator project).
 
 library googleapis.youtubereporting.v1;
 
 import 'dart:core' as core;
 import 'dart:async' as async;
 import 'dart:convert' as convert;
 
 import 'package:_discoveryapis_commons/_discoveryapis_commons.dart' as commons;
 import 'package:http/http.dart' as http;
@@ skipping 40 matching lines @@
       _requester = client;
 
   /**
    * Creates a job and returns it.
    *
    * [request] - The metadata request object.
    *
    * Request parameters:
    *
    * [onBehalfOfContentOwner] - The content owner's external ID on which behalf
-   * the user is acting on. If not set, the user is acting for himself (his own
-   * channel).
+   * the user is acting on. If
+   * not set, the user is acting for himself (his own channel).
    *
    * Completes with a [Job].
    *
    * Completes with a [commons.ApiRequestError] if the API endpoint returned an
    * error.
    *
    * If the used [http.Client] completes with an error when making a REST call,
    * this method will complete with the same error.
    */
   async.Future<Job> create(Job request, {core.String onBehalfOfContentOwner}) {
@@ skipping 24 matching lines @@
   }
 
   /**
    * Deletes a job.
    *
    * Request parameters:
    *
    * [jobId] - The ID of the job to delete.
    *
    * [onBehalfOfContentOwner] - The content owner's external ID on which behalf
-   * the user is acting on. If not set, the user is acting for himself (his own
-   * channel).
+   * the user is acting on. If
+   * not set, the user is acting for himself (his own channel).
    *
    * Completes with a [Empty].
    *
    * Completes with a [commons.ApiRequestError] if the API endpoint returned an
    * error.
    *
    * If the used [http.Client] completes with an error when making a REST call,
    * this method will complete with the same error.
    */
   async.Future<Empty> delete(core.String jobId, {core.String onBehalfOfContentOwner}) {
@@ skipping 24 matching lines @@
   }
 
   /**
    * Gets a job.
    *
    * Request parameters:
    *
    * [jobId] - The ID of the job to retrieve.
    *
    * [onBehalfOfContentOwner] - The content owner's external ID on which behalf
-   * the user is acting on. If not set, the user is acting for himself (his own
-   * channel).
+   * the user is acting on. If
+   * not set, the user is acting for himself (his own channel).
    *
    * Completes with a [Job].
    *
    * Completes with a [commons.ApiRequestError] if the API endpoint returned an
    * error.
    *
    * If the used [http.Client] completes with an error when making a REST call,
    * this method will complete with the same error.
    */
   async.Future<Job> get(core.String jobId, {core.String onBehalfOfContentOwner}) {
@@ skipping 21 matching lines @@
                                        uploadMedia: _uploadMedia,
                                        downloadOptions: _downloadOptions);
     return _response.then((data) => new Job.fromJson(data));
   }
 
   /**
    * Lists jobs.
    *
    * Request parameters:
    *
+   * [pageSize] - Requested page size. Server may return fewer jobs than
+   * requested.
+   * If unspecified, server will pick an appropriate default.
+   *
+   * [includeSystemManaged] - If set to true, also system-managed jobs will be
+   * returned; otherwise only
+   * user-created jobs will be returned. System-managed jobs can neither be
+   * modified nor deleted.
+   *
    * [onBehalfOfContentOwner] - The content owner's external ID on which behalf
-   * the user is acting on. If not set, the user is acting for himself (his own
-   * channel).
-   *
-   * [pageSize] - Requested page size. Server may return fewer jobs than
-   * requested. If unspecified, server will pick an appropriate default.
+   * the user is acting on. If
+   * not set, the user is acting for himself (his own channel).
    *
    * [pageToken] - A token identifying a page of results the server should
-   * return. Typically, this is the value of
-   * ListReportTypesResponse.next_page_token returned in response to the
-   * previous call to the `ListJobs` method.
-   *
-   * [includeSystemManaged] - If set to true, also system-managed jobs will be
-   * returned; otherwise only user-created jobs will be returned. System-managed
-   * jobs can neither be modified nor deleted.
+   * return. Typically,
+   * this is the value of
+   * ListReportTypesResponse.next_page_token
+   * returned in response to the previous call to the `ListJobs` method.
    *
    * Completes with a [ListJobsResponse].
    *
    * Completes with a [commons.ApiRequestError] if the API endpoint returned an
    * error.
    *
    * If the used [http.Client] completes with an error when making a REST call,
    * this method will complete with the same error.
    */
-  async.Future<ListJobsResponse> list({core.String onBehalfOfContentOwner, core.int pageSize, core.String pageToken, core.bool includeSystemManaged}) {
+  async.Future<ListJobsResponse> list({core.int pageSize, core.bool includeSystemManaged, core.String onBehalfOfContentOwner, core.String pageToken}) {
     var _url = null;
     var _queryParams = new core.Map();
     var _uploadMedia = null;
     var _uploadOptions = null;
     var _downloadOptions = commons.DownloadOptions.Metadata;
     var _body = null;
 
+    if (pageSize != null) {
+      _queryParams["pageSize"] = ["${pageSize}"];
+    }
+    if (includeSystemManaged != null) {
+      _queryParams["includeSystemManaged"] = ["${includeSystemManaged}"];
+    }
     if (onBehalfOfContentOwner != null) {
       _queryParams["onBehalfOfContentOwner"] = [onBehalfOfContentOwner];
     }
-    if (pageSize != null) {
-      _queryParams["pageSize"] = ["${pageSize}"];
-    }
     if (pageToken != null) {
       _queryParams["pageToken"] = [pageToken];
     }
-    if (includeSystemManaged != null) {
-      _queryParams["includeSystemManaged"] = ["${includeSystemManaged}"];
-    }
 
     _url = 'v1/jobs';
 
     var _response = _requester.request(_url,
                                        "GET",
                                        body: _body,
                                        queryParams: _queryParams,
                                        uploadOptions: _uploadOptions,
                                        uploadMedia: _uploadMedia,
                                        downloadOptions: _downloadOptions);
@@ skipping 12 matching lines @@
   /**
    * Gets the metadata of a specific report.
    *
    * Request parameters:
    *
    * [jobId] - The ID of the job.
    *
    * [reportId] - The ID of the report to retrieve.
    *
    * [onBehalfOfContentOwner] - The content owner's external ID on which behalf
-   * the user is acting on. If not set, the user is acting for himself (his own
-   * channel).
+   * the user is acting on. If
+   * not set, the user is acting for himself (his own channel).
    *
    * Completes with a [Report].
    *
    * Completes with a [commons.ApiRequestError] if the API endpoint returned an
    * error.
    *
    * If the used [http.Client] completes with an error when making a REST call,
    * this method will complete with the same error.
    */
   async.Future<Report> get(core.String jobId, core.String reportId, {core.String onBehalfOfContentOwner}) {
@@ skipping 20 matching lines @@
                                        "GET",
                                        body: _body,
                                        queryParams: _queryParams,
                                        uploadOptions: _uploadOptions,
                                        uploadMedia: _uploadMedia,
                                        downloadOptions: _downloadOptions);
     return _response.then((data) => new Report.fromJson(data));
   }
 
   /**
-   * Lists reports created by a specific job. Returns NOT_FOUND if the job does
-   * not exist.
+   * Lists reports created by a specific job.
+   * Returns NOT_FOUND if the job does not exist.
    *
    * Request parameters:
    *
    * [jobId] - The ID of the job.
    *
    * [onBehalfOfContentOwner] - The content owner's external ID on which behalf
-   * the user is acting on. If not set, the user is acting for himself (his own
-   * channel).
+   * the user is acting on. If
+   * not set, the user is acting for himself (his own channel).
+   *
+   * [startTimeAtOrAfter] - If set, only reports whose start time is greater
+   * than or equal the
+   * specified date/time are returned.
+   *
+   * [startTimeBefore] - If set, only reports whose start time is smaller than
+   * the specified
+   * date/time are returned.
    *
    * [pageSize] - Requested page size. Server may return fewer report types than
-   * requested. If unspecified, server will pick an appropriate default.
-   *
-   * [pageToken] - A token identifying a page of results the server should
-   * return. Typically, this is the value of ListReportsResponse.next_page_token
-   * returned in response to the previous call to the `ListReports` method.
+   * requested.
+   * If unspecified, server will pick an appropriate default.
    *
    * [createdAfter] - If set, only reports created after the specified date/time
    * are returned.
    *
-   * [startTimeAtOrAfter] - If set, only reports whose start time is greater
-   * than or equal the specified date/time are returned.
-   *
-   * [startTimeBefore] - If set, only reports whose start time is smaller than
-   * the specified date/time are returned.
+   * [pageToken] - A token identifying a page of results the server should
+   * return. Typically,
+   * this is the value of
+   * ListReportsResponse.next_page_token
+   * returned in response to the previous call to the `ListReports` method.
    *
    * Completes with a [ListReportsResponse].
    *
    * Completes with a [commons.ApiRequestError] if the API endpoint returned an
    * error.
    *
    * If the used [http.Client] completes with an error when making a REST call,
    * this method will complete with the same error.
    */
-  async.Future<ListReportsResponse> list(core.String jobId, {core.String onBehalfOfContentOwner, core.int pageSize, core.String pageToken, core.String createdAfter, core.String startTimeAtOrAfter, core.String startTimeBefore}) {
+  async.Future<ListReportsResponse> list(core.String jobId, {core.String onBehalfOfContentOwner, core.String startTimeAtOrAfter, core.String startTimeBefore, core.int pageSize, core.String createdAfter, core.String pageToken}) {
     var _url = null;
     var _queryParams = new core.Map();
     var _uploadMedia = null;
     var _uploadOptions = null;
     var _downloadOptions = commons.DownloadOptions.Metadata;
     var _body = null;
 
     if (jobId == null) {
       throw new core.ArgumentError("Parameter jobId is required.");
     }
     if (onBehalfOfContentOwner != null) {
       _queryParams["onBehalfOfContentOwner"] = [onBehalfOfContentOwner];
     }
-    if (pageSize != null) {
-      _queryParams["pageSize"] = ["${pageSize}"];
-    }
-    if (pageToken != null) {
-      _queryParams["pageToken"] = [pageToken];
-    }
-    if (createdAfter != null) {
-      _queryParams["createdAfter"] = [createdAfter];
-    }
     if (startTimeAtOrAfter != null) {
       _queryParams["startTimeAtOrAfter"] = [startTimeAtOrAfter];
     }
     if (startTimeBefore != null) {
       _queryParams["startTimeBefore"] = [startTimeBefore];
     }
+    if (pageSize != null) {
+      _queryParams["pageSize"] = ["${pageSize}"];
+    }
+    if (createdAfter != null) {
+      _queryParams["createdAfter"] = [createdAfter];
+    }
+    if (pageToken != null) {
+      _queryParams["pageToken"] = [pageToken];
+    }
 
     _url = 'v1/jobs/' + commons.Escaper.ecapeVariable('$jobId') + '/reports';
 
     var _response = _requester.request(_url,
                                        "GET",
                                        body: _body,
                                        queryParams: _queryParams,
                                        uploadOptions: _uploadOptions,
                                        uploadMedia: _uploadMedia,
                                        downloadOptions: _downloadOptions);
     return _response.then((data) => new ListReportsResponse.fromJson(data));
   }
 
 }
 
 
 class MediaResourceApi {
   final commons.ApiRequester _requester;
 
   MediaResourceApi(commons.ApiRequester client) : 
       _requester = client;
 
   /**
-   * Method for media download. Download is supported on the URI
-   * `/v1/media/{+name}?alt=media`.
+   * Method for media download. Download is supported
+   * on the URI `/v1/media/{+name}?alt=media`.
    *
    * Request parameters:
    *
-   * [resourceName] - Name of the media that is being downloaded. See
+   * [resourceName] - Name of the media that is being downloaded.  See
    * ReadRequest.resource_name.
-   * Value must have pattern "^.*$".
+   * Value must have pattern "^.+$".
    *
    * [downloadOptions] - Options for downloading. A download can be either a
    * Metadata (default) or Media download. Partial Media downloads are possible
    * as well.
    *
    * Completes with a
    *
    * - [Media] for Metadata downloads (see [downloadOptions]).
    *
    * - [commons.Media] for Media downloads (see [downloadOptions]).
@@ skipping 42 matching lines @@
   final commons.ApiRequester _requester;
 
   ReportTypesResourceApi(commons.ApiRequester client) : 
       _requester = client;
 
   /**
    * Lists report types.
    *
    * Request parameters:
    *
+   * [pageSize] - Requested page size. Server may return fewer report types than
+   * requested.
+   * If unspecified, server will pick an appropriate default.
+   *
+   * [includeSystemManaged] - If set to true, also system-managed report types
+   * will be returned;
+   * otherwise only the report types that can be used to create new reporting
+   * jobs will be returned.
+   *
    * [onBehalfOfContentOwner] - The content owner's external ID on which behalf
-   * the user is acting on. If not set, the user is acting for himself (his own
-   * channel).
-   *
-   * [pageSize] - Requested page size. Server may return fewer report types than
-   * requested. If unspecified, server will pick an appropriate default.
+   * the user is acting on. If
+   * not set, the user is acting for himself (his own channel).
    *
    * [pageToken] - A token identifying a page of results the server should
-   * return. Typically, this is the value of
-   * ListReportTypesResponse.next_page_token returned in response to the
-   * previous call to the `ListReportTypes` method.
-   *
-   * [includeSystemManaged] - If set to true, also system-managed report types
-   * will be returned; otherwise only the report types that can be used to
-   * create new reporting jobs will be returned.
+   * return. Typically,
+   * this is the value of
+   * ListReportTypesResponse.next_page_token
+   * returned in response to the previous call to the `ListReportTypes` method.
    *
    * Completes with a [ListReportTypesResponse].
    *
    * Completes with a [commons.ApiRequestError] if the API endpoint returned an
    * error.
    *
    * If the used [http.Client] completes with an error when making a REST call,
    * this method will complete with the same error.
    */
-  async.Future<ListReportTypesResponse> list({core.String onBehalfOfContentOwner, core.int pageSize, core.String pageToken, core.bool includeSystemManaged}) {
+  async.Future<ListReportTypesResponse> list({core.int pageSize, core.bool includeSystemManaged, core.String onBehalfOfContentOwner, core.String pageToken}) {
     var _url = null;
     var _queryParams = new core.Map();
     var _uploadMedia = null;
     var _uploadOptions = null;
     var _downloadOptions = commons.DownloadOptions.Metadata;
     var _body = null;
 
+    if (pageSize != null) {
+      _queryParams["pageSize"] = ["${pageSize}"];
+    }
+    if (includeSystemManaged != null) {
+      _queryParams["includeSystemManaged"] = ["${includeSystemManaged}"];
+    }
     if (onBehalfOfContentOwner != null) {
       _queryParams["onBehalfOfContentOwner"] = [onBehalfOfContentOwner];
     }
-    if (pageSize != null) {
-      _queryParams["pageSize"] = ["${pageSize}"];
-    }
     if (pageToken != null) {
       _queryParams["pageToken"] = [pageToken];
     }
-    if (includeSystemManaged != null) {
-      _queryParams["includeSystemManaged"] = ["${includeSystemManaged}"];
-    }
 
     _url = 'v1/reportTypes';
 
     var _response = _requester.request(_url,
                                        "GET",
                                        body: _body,
                                        queryParams: _queryParams,
                                        uploadOptions: _uploadOptions,
                                        uploadMedia: _uploadMedia,
                                        downloadOptions: _downloadOptions);
     return _response.then((data) => new ListReportTypesResponse.fromJson(data));
   }
 
 }
 
 
 
 /**
  * A generic empty message that you can re-use to avoid defining duplicated
- * empty messages in your APIs. A typical example is to use it as the request or
- * the response type of an API method. For instance: service Foo { rpc
- * Bar(google.protobuf.Empty) returns (google.protobuf.Empty); } The JSON
- * representation for `Empty` is empty JSON object `{}`.
+ * empty messages in your APIs. A typical example is to use it as the request
+ * or the response type of an API method. For instance:
+ *
+ *     service Foo {
+ *       rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty);
+ *     }
+ *
+ * The JSON representation for `Empty` is empty JSON object `{}`.
  */
 class Empty {
 
   Empty();
 
   Empty.fromJson(core.Map _json) {
   }
 
   core.Map toJson() {
     var _json = new core.Map();
@@ skipping 70 matching lines @@
     }
     return _json;
   }
 }
 
 /** Response message for ReportingService.ListJobs. */
 class ListJobsResponse {
   /** The list of jobs. */
   core.List<Job> jobs;
   /**
-   * A token to retrieve next page of results. Pass this value in the
-   * ListJobsRequest.page_token field in the subsequent call to `ListJobs`
-   * method to retrieve the next page of results.
+   * A token to retrieve next page of results.
+   * Pass this value in the
+   * ListJobsRequest.page_token
+   * field in the subsequent call to `ListJobs` method to retrieve the next
+   * page of results.
    */
   core.String nextPageToken;
 
   ListJobsResponse();
 
   ListJobsResponse.fromJson(core.Map _json) {
     if (_json.containsKey("jobs")) {
       jobs = _json["jobs"].map((value) => new Job.fromJson(value)).toList();
     }
     if (_json.containsKey("nextPageToken")) {
       nextPageToken = _json["nextPageToken"];
     }
   }
 
   core.Map toJson() {
     var _json = new core.Map();
     if (jobs != null) {
       _json["jobs"] = jobs.map((value) => (value).toJson()).toList();
     }
     if (nextPageToken != null) {
       _json["nextPageToken"] = nextPageToken;
     }
     return _json;
   }
 }
 
 /** Response message for ReportingService.ListReportTypes. */
 class ListReportTypesResponse {
   /**
-   * A token to retrieve next page of results. Pass this value in the
-   * ListReportTypesRequest.page_token field in the subsequent call to
-   * `ListReportTypes` method to retrieve the next page of results.
+   * A token to retrieve next page of results.
+   * Pass this value in the
+   * ListReportTypesRequest.page_token
+   * field in the subsequent call to `ListReportTypes` method to retrieve the
+   * next
+   * page of results.
    */
   core.String nextPageToken;
   /** The list of report types. */
   core.List<ReportType> reportTypes;
 
   ListReportTypesResponse();
 
   ListReportTypesResponse.fromJson(core.Map _json) {
     if (_json.containsKey("nextPageToken")) {
       nextPageToken = _json["nextPageToken"];
@@ skipping 11 matching lines @@
     if (reportTypes != null) {
       _json["reportTypes"] = reportTypes.map((value) => (value).toJson()).toList();
     }
     return _json;
   }
 }
 
 /** Response message for ReportingService.ListReports. */
 class ListReportsResponse {
   /**
-   * A token to retrieve next page of results. Pass this value in the
-   * ListReportsRequest.page_token field in the subsequent call to `ListReports`
-   * method to retrieve the next page of results.
+   * A token to retrieve next page of results.
+   * Pass this value in the
+   * ListReportsRequest.page_token
+   * field in the subsequent call to `ListReports` method to retrieve the next
+   * page of results.
    */
   core.String nextPageToken;
   /** The list of report types. */
   core.List<Report> reports;
 
   ListReportsResponse();
 
   ListReportsResponse.fromJson(core.Map _json) {
     if (_json.containsKey("nextPageToken")) {
       nextPageToken = _json["nextPageToken"];
@@ skipping 160 matching lines @@
     }
     if (name != null) {
       _json["name"] = name;
     }
     if (systemManaged != null) {
       _json["systemManaged"] = systemManaged;
     }
     return _json;
   }
 }