Api-Roll 58: 2017-12-04 (#27)

diff --git a/generated/googleapis/lib/bigquerydatatransfer/v1.dart b/generated/googleapis/lib/bigquerydatatransfer/v1.dart
index 667332e..70536c2 100644
--- a/generated/googleapis/lib/bigquerydatatransfer/v1.dart
+++ b/generated/googleapis/lib/bigquerydatatransfer/v1.dart
@@ -289,12 +289,12 @@
   /// [name] - The resource that owns the locations collection, if applicable.
   /// Value must have pattern "^projects/[^/]+$".
   ///
-  /// [filter] - The standard list filter.
-  ///
   /// [pageToken] - The standard list page token.
   ///
   /// [pageSize] - The standard list page size.
   ///
+  /// [filter] - The standard list filter.
+  ///
   /// [$fields] - Selector specifying which fields to include in a partial
   /// response.
   ///
@@ -306,9 +306,9 @@
   /// If the used [http.Client] completes with an error when making a REST call,
   /// this method will complete with the same error.
   async.Future<ListLocationsResponse> list(core.String name,
-      {core.String filter,
-      core.String pageToken,
+      {core.String pageToken,
       core.int pageSize,
+      core.String filter,
       core.String $fields}) {
     var _url = null;
     var _queryParams = new core.Map();
@@ -320,15 +320,15 @@
     if (name == null) {
       throw new core.ArgumentError("Parameter name is required.");
     }
-    if (filter != null) {
-      _queryParams["filter"] = [filter];
-    }
     if (pageToken != null) {
       _queryParams["pageToken"] = [pageToken];
     }
     if (pageSize != null) {
       _queryParams["pageSize"] = ["${pageSize}"];
     }
+    if (filter != null) {
+      _queryParams["filter"] = [filter];
+    }
     if ($fields != null) {
       _queryParams["fields"] = [$fields];
     }
@@ -542,10 +542,8 @@
   /// [parent] - The BigQuery project id where the transfer configuration should
   /// be created.
   /// Must be in the format /projects/{project_id}/locations/{location_id}
-  /// or
-  /// /projects/{project_id}/locations/-
-  /// In case when '-' is specified as location_id, location is infered from
-  /// the destination dataset region.
+  /// If specified location and location of the destination bigquery dataset
+  /// do not match - the request will fail.
   /// Value must have pattern "^projects/[^/]+/locations/[^/]+$".
   ///
   /// [authorizationCode] - Optional OAuth2 authorization code to use with this
@@ -713,6 +711,9 @@
   /// should be returned: `projects/{project_id}`.
   /// Value must have pattern "^projects/[^/]+/locations/[^/]+$".
   ///
+  /// [dataSourceIds] - When specified, only configurations of requested data
+  /// sources are returned.
+  ///
   /// [pageToken] - Pagination token, which can be used to request a specific
   /// page
   /// of `ListTransfersRequest` list results. For multiple-page
@@ -723,9 +724,6 @@
   /// [pageSize] - Page size. The default page size is the maximum value of 1000
   /// results.
   ///
-  /// [dataSourceIds] - When specified, only configurations of requested data
-  /// sources are returned.
-  ///
   /// [$fields] - Selector specifying which fields to include in a partial
   /// response.
   ///
@@ -737,9 +735,9 @@
   /// If the used [http.Client] completes with an error when making a REST call,
   /// this method will complete with the same error.
   async.Future<ListTransferConfigsResponse> list(core.String parent,
-      {core.String pageToken,
+      {core.List<core.String> dataSourceIds,
+      core.String pageToken,
       core.int pageSize,
-      core.List<core.String> dataSourceIds,
       core.String $fields}) {
     var _url = null;
     var _queryParams = new core.Map();
@@ -751,15 +749,15 @@
     if (parent == null) {
       throw new core.ArgumentError("Parameter parent is required.");
     }
+    if (dataSourceIds != null) {
+      _queryParams["dataSourceIds"] = dataSourceIds;
+    }
     if (pageToken != null) {
       _queryParams["pageToken"] = [pageToken];
     }
     if (pageSize != null) {
       _queryParams["pageSize"] = ["${pageSize}"];
     }
-    if (dataSourceIds != null) {
-      _queryParams["dataSourceIds"] = dataSourceIds;
-    }
     if ($fields != null) {
       _queryParams["fields"] = [$fields];
     }
@@ -794,10 +792,12 @@
   /// Value must have pattern
   /// "^projects/[^/]+/locations/[^/]+/transferConfigs/[^/]+$".
   ///
+  /// [updateMask] - Required list of fields to be updated in this request.
+  ///
   /// [authorizationCode] - Optional OAuth2 authorization code to use with this
   /// transfer configuration.
   /// If it is provided, the transfer configuration will be associated with the
-  /// gaia id of the authorizing user.
+  /// authorizing user.
   /// In order to obtain authorization_code, please make a
   /// request to
   /// https://www.gstatic.com/bigquerydatatransfer/oauthz/auth?client_id=<datatransferapiclientid>&scope=<data_source_scopes>&redirect_uri=<redirect_uri>
@@ -812,8 +812,6 @@
   ///   returned in the title bar of the browser, with the page text prompting
   ///   the user to copy the code and paste it in the application.
   ///
-  /// [updateMask] - Required list of fields to be updated in this request.
-  ///
   /// [$fields] - Selector specifying which fields to include in a partial
   /// response.
   ///
@@ -825,8 +823,8 @@
   /// If the used [http.Client] completes with an error when making a REST call,
   /// this method will complete with the same error.
   async.Future<TransferConfig> patch(TransferConfig request, core.String name,
-      {core.String authorizationCode,
-      core.String updateMask,
+      {core.String updateMask,
+      core.String authorizationCode,
       core.String $fields}) {
     var _url = null;
     var _queryParams = new core.Map();
@@ -841,12 +839,12 @@
     if (name == null) {
       throw new core.ArgumentError("Parameter name is required.");
     }
-    if (authorizationCode != null) {
-      _queryParams["authorizationCode"] = [authorizationCode];
-    }
     if (updateMask != null) {
       _queryParams["updateMask"] = [updateMask];
     }
+    if (authorizationCode != null) {
+      _queryParams["authorizationCode"] = [authorizationCode];
+    }
     if ($fields != null) {
       _queryParams["fields"] = [$fields];
     }
@@ -862,7 +860,7 @@
     return _response.then((data) => new TransferConfig.fromJson(data));
   }
 
-  /// Creates transfer runs for a time range [range_start_time, range_end_time].
+  /// Creates transfer runs for a time range [start_time, end_time].
   /// For each date - or whatever granularity the data source supports - in the
   /// range, one transfer run is created.
   /// Note that runs are created per UTC time in the time range.
@@ -1035,11 +1033,6 @@
   /// Value must have pattern
   /// "^projects/[^/]+/locations/[^/]+/transferConfigs/[^/]+$".
   ///
-  /// [runAttempt] - Indicates how run attempts are to be pulled.
-  /// Possible string values are:
-  /// - "RUN_ATTEMPT_UNSPECIFIED" : A RUN_ATTEMPT_UNSPECIFIED.
-  /// - "LATEST" : A LATEST.
-  ///
   /// [pageToken] - Pagination token, which can be used to request a specific
   /// page
   /// of `ListTransferRunsRequest` list results. For multiple-page
@@ -1053,6 +1046,11 @@
   /// [pageSize] - Page size. The default page size is the maximum value of 1000
   /// results.
   ///
+  /// [runAttempt] - Indicates how run attempts are to be pulled.
+  /// Possible string values are:
+  /// - "RUN_ATTEMPT_UNSPECIFIED" : A RUN_ATTEMPT_UNSPECIFIED.
+  /// - "LATEST" : A LATEST.
+  ///
   /// [$fields] - Selector specifying which fields to include in a partial
   /// response.
   ///
@@ -1064,10 +1062,10 @@
   /// If the used [http.Client] completes with an error when making a REST call,
   /// this method will complete with the same error.
   async.Future<ListTransferRunsResponse> list(core.String parent,
-      {core.String runAttempt,
-      core.String pageToken,
+      {core.String pageToken,
       core.List<core.String> states,
       core.int pageSize,
+      core.String runAttempt,
       core.String $fields}) {
     var _url = null;
     var _queryParams = new core.Map();
@@ -1079,9 +1077,6 @@
     if (parent == null) {
       throw new core.ArgumentError("Parameter parent is required.");
     }
-    if (runAttempt != null) {
-      _queryParams["runAttempt"] = [runAttempt];
-    }
     if (pageToken != null) {
       _queryParams["pageToken"] = [pageToken];
     }
@@ -1091,6 +1086,9 @@
     if (pageSize != null) {
       _queryParams["pageSize"] = ["${pageSize}"];
     }
+    if (runAttempt != null) {
+      _queryParams["runAttempt"] = [runAttempt];
+    }
     if ($fields != null) {
       _queryParams["fields"] = [$fields];
     }
@@ -1209,10 +1207,8 @@
   /// [parent] - The BigQuery project id where the transfer configuration should
   /// be created.
   /// Must be in the format /projects/{project_id}/locations/{location_id}
-  /// or
-  /// /projects/{project_id}/locations/-
-  /// In case when '-' is specified as location_id, location is infered from
-  /// the destination dataset region.
+  /// If specified location and location of the destination bigquery dataset
+  /// do not match - the request will fail.
   /// Value must have pattern "^projects/[^/]+$".
   ///
   /// [authorizationCode] - Optional OAuth2 authorization code to use with this
@@ -1461,7 +1457,7 @@
   /// [authorizationCode] - Optional OAuth2 authorization code to use with this
   /// transfer configuration.
   /// If it is provided, the transfer configuration will be associated with the
-  /// gaia id of the authorizing user.
+  /// authorizing user.
   /// In order to obtain authorization_code, please make a
   /// request to
   /// https://www.gstatic.com/bigquerydatatransfer/oauthz/auth?client_id=<datatransferapiclientid>&scope=<data_source_scopes>&redirect_uri=<redirect_uri>
@@ -1526,7 +1522,7 @@
     return _response.then((data) => new TransferConfig.fromJson(data));
   }
 
-  /// Creates transfer runs for a time range [range_start_time, range_end_time].
+  /// Creates transfer runs for a time range [start_time, end_time].
   /// For each date - or whatever granularity the data source supports - in the
   /// range, one transfer run is created.
   /// Note that runs are created per UTC time in the time range.
@@ -1695,11 +1691,6 @@
   /// `projects/{project_id}/transferConfigs/{config_id}`.
   /// Value must have pattern "^projects/[^/]+/transferConfigs/[^/]+$".
   ///
-  /// [runAttempt] - Indicates how run attempts are to be pulled.
-  /// Possible string values are:
-  /// - "RUN_ATTEMPT_UNSPECIFIED" : A RUN_ATTEMPT_UNSPECIFIED.
-  /// - "LATEST" : A LATEST.
-  ///
   /// [pageToken] - Pagination token, which can be used to request a specific
   /// page
   /// of `ListTransferRunsRequest` list results. For multiple-page
@@ -1713,6 +1704,11 @@
   /// [pageSize] - Page size. The default page size is the maximum value of 1000
   /// results.
   ///
+  /// [runAttempt] - Indicates how run attempts are to be pulled.
+  /// Possible string values are:
+  /// - "RUN_ATTEMPT_UNSPECIFIED" : A RUN_ATTEMPT_UNSPECIFIED.
+  /// - "LATEST" : A LATEST.
+  ///
   /// [$fields] - Selector specifying which fields to include in a partial
   /// response.
   ///
@@ -1724,10 +1720,10 @@
   /// If the used [http.Client] completes with an error when making a REST call,
   /// this method will complete with the same error.
   async.Future<ListTransferRunsResponse> list(core.String parent,
-      {core.String runAttempt,
-      core.String pageToken,
+      {core.String pageToken,
       core.List<core.String> states,
       core.int pageSize,
+      core.String runAttempt,
       core.String $fields}) {
     var _url = null;
     var _queryParams = new core.Map();
@@ -1739,9 +1735,6 @@
     if (parent == null) {
       throw new core.ArgumentError("Parameter parent is required.");
     }
-    if (runAttempt != null) {
-      _queryParams["runAttempt"] = [runAttempt];
-    }
     if (pageToken != null) {
       _queryParams["pageToken"] = [pageToken];
     }
@@ -1751,6 +1744,9 @@
     if (pageSize != null) {
       _queryParams["pageSize"] = ["${pageSize}"];
     }
+    if (runAttempt != null) {
+      _queryParams["runAttempt"] = [runAttempt];
+    }
     if ($fields != null) {
       _queryParams["fields"] = [$fields];
     }
@@ -1784,10 +1780,6 @@
   /// Value must have pattern
   /// "^projects/[^/]+/transferConfigs/[^/]+/runs/[^/]+$".
   ///
-  /// [messageTypes] - Message types to return. If not populated - INFO, WARNING
-  /// and ERROR
-  /// messages are returned.
-  ///
   /// [pageToken] - Pagination token, which can be used to request a specific
   /// page
   /// of `ListTransferLogsRequest` list results. For multiple-page
@@ -1798,6 +1790,10 @@
   /// [pageSize] - Page size. The default page size is the maximum value of 1000
   /// results.
   ///
+  /// [messageTypes] - Message types to return. If not populated - INFO, WARNING
+  /// and ERROR
+  /// messages are returned.
+  ///
   /// [$fields] - Selector specifying which fields to include in a partial
   /// response.
   ///
@@ -1809,9 +1805,9 @@
   /// If the used [http.Client] completes with an error when making a REST call,
   /// this method will complete with the same error.
   async.Future<ListTransferLogsResponse> list(core.String parent,
-      {core.List<core.String> messageTypes,
-      core.String pageToken,
+      {core.String pageToken,
       core.int pageSize,
+      core.List<core.String> messageTypes,
       core.String $fields}) {
     var _url = null;
     var _queryParams = new core.Map();
@@ -1823,15 +1819,15 @@
     if (parent == null) {
       throw new core.ArgumentError("Parameter parent is required.");
     }
-    if (messageTypes != null) {
-      _queryParams["messageTypes"] = messageTypes;
-    }
     if (pageToken != null) {
       _queryParams["pageToken"] = [pageToken];
     }
     if (pageSize != null) {
       _queryParams["pageSize"] = ["${pageSize}"];
     }
+    if (messageTypes != null) {
+      _queryParams["messageTypes"] = messageTypes;
+    }
     if ($fields != null) {
       _queryParams["fields"] = [$fields];
     }
@@ -2776,7 +2772,6 @@
   /// Output only. State of the most recently updated transfer run.
   /// Possible string values are:
   /// - "TRANSFER_STATE_UNSPECIFIED" : State placeholder.
-  /// - "INACTIVE" : Data transfer is inactive.
   /// - "PENDING" : Data transfer is scheduled and is waiting to be picked up by
   /// data transfer backend.
   /// - "RUNNING" : Data transfer is in progress.
@@ -2791,6 +2786,8 @@
   /// Output only. Unique ID of the user on whose behalf transfer is done.
   /// Applicable only to data sources that do not support service accounts.
   /// When set to 0, the data source service account credentials are used.
+  /// May be negative. Note, that this identifier is not stable.
+  /// It may change over time even for the same user.
   core.String userId;
 
   TransferConfig();
@@ -2930,7 +2927,7 @@
 }
 
 /// Represents a data transfer run.
-/// Next id: 23
+/// Next id: 24
 class TransferRun {
   /// Output only. Data source id.
   core.String dataSourceId;
@@ -2978,7 +2975,6 @@
   /// Data transfer run state. Ignored for input requests.
   /// Possible string values are:
   /// - "TRANSFER_STATE_UNSPECIFIED" : State placeholder.
-  /// - "INACTIVE" : Data transfer is inactive.
   /// - "PENDING" : Data transfer is scheduled and is waiting to be picked up by
   /// data transfer backend.
   /// - "RUNNING" : Data transfer is in progress.
@@ -2993,7 +2989,8 @@
   /// Output only. Unique ID of the user on whose behalf transfer is done.
   /// Applicable only to data sources that do not support service accounts.
   /// When set to 0, the data source service account credentials are used.
-  /// May be negative.
+  /// May be negative. Note, that this identifier is not stable.
+  /// It may change over time even for the same user.
   core.String userId;
 
   TransferRun();