Api-Roll 54: 2017-09-11

generated/googleapis/lib/siteverification/v1.dart

Index: generated/googleapis/lib/siteverification/v1.dart
diff --git a/generated/googleapis/lib/siteverification/v1.dart b/generated/googleapis/lib/siteverification/v1.dart
index eccbbea341e1909786e90fe409fcb95ffce22d98..9b17b5b5fcc80c57034a99b6d2a49d244b783240 100644
--- a/generated/googleapis/lib/siteverification/v1.dart
+++ b/generated/googleapis/lib/siteverification/v1.dart
@@ -9,48 +9,49 @@ import 'dart:convert' as convert;
 import 'package:_discoveryapis_commons/_discoveryapis_commons.dart' as commons;
 import 'package:http/http.dart' as http;
 
-export 'package:_discoveryapis_commons/_discoveryapis_commons.dart' show
-    ApiRequestError, DetailedApiRequestError;
+export 'package:_discoveryapis_commons/_discoveryapis_commons.dart'
+    show ApiRequestError, DetailedApiRequestError;
 
 const core.String USER_AGENT = 'dart-api-client siteVerification/v1';
 
-/** Verifies ownership of websites or domains with Google. */
+/// Verifies ownership of websites or domains with Google.
 class SiteVerificationApi {
-  /** Manage the list of sites and domains you control */
-  static const SiteverificationScope = "https://www.googleapis.com/auth/siteverification";
-
-  /** Manage your new site verifications with Google */
-  static const SiteverificationVerifyOnlyScope = "https://www.googleapis.com/auth/siteverification.verify_only";
+  /// Manage the list of sites and domains you control
+  static const SiteverificationScope =
+      "https://www.googleapis.com/auth/siteverification";
 
+  /// Manage your new site verifications with Google
+  static const SiteverificationVerifyOnlyScope =
+      "https://www.googleapis.com/auth/siteverification.verify_only";
 
   final commons.ApiRequester _requester;
 
-  WebResourceResourceApi get webResource => new WebResourceResourceApi(_requester);
+  WebResourceResourceApi get webResource =>
+      new WebResourceResourceApi(_requester);
 
-  SiteVerificationApi(http.Client client, {core.String rootUrl: "https://www.googleapis.com/", core.String servicePath: "siteVerification/v1/"}) :
-      _requester = new commons.ApiRequester(client, rootUrl, servicePath, USER_AGENT);
+  SiteVerificationApi(http.Client client,
+      {core.String rootUrl: "https://www.googleapis.com/",
+      core.String servicePath: "siteVerification/v1/"})
+      : _requester =
+            new commons.ApiRequester(client, rootUrl, servicePath, USER_AGENT);
 }
 
-
 class WebResourceResourceApi {
   final commons.ApiRequester _requester;
 
-  WebResourceResourceApi(commons.ApiRequester client) : 
-      _requester = client;
-
-  /**
-   * Relinquish ownership of a website or domain.
-   *
-   * Request parameters:
-   *
-   * [id] - The id of a verified site or domain.
-   *
-   * 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.
-   */
+  WebResourceResourceApi(commons.ApiRequester client) : _requester = client;
+
+  /// Relinquish ownership of a website or domain.
+  ///
+  /// Request parameters:
+  ///
+  /// [id] - The id of a verified site or domain.
+  ///
+  /// 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 delete(core.String id) {
     var _url = null;
     var _queryParams = new core.Map();
@@ -67,31 +68,28 @@ class WebResourceResourceApi {
 
     _url = 'webResource/' + commons.Escaper.ecapeVariable('$id');
 
-    var _response = _requester.request(_url,
-                                       "DELETE",
-                                       body: _body,
-                                       queryParams: _queryParams,
-                                       uploadOptions: _uploadOptions,
-                                       uploadMedia: _uploadMedia,
-                                       downloadOptions: _downloadOptions);
+    var _response = _requester.request(_url, "DELETE",
+        body: _body,
+        queryParams: _queryParams,
+        uploadOptions: _uploadOptions,
+        uploadMedia: _uploadMedia,
+        downloadOptions: _downloadOptions);
     return _response.then((data) => null);
   }
 
-  /**
-   * Get the most current data for a website or domain.
-   *
-   * Request parameters:
-   *
-   * [id] - The id of a verified site or domain.
-   *
-   * Completes with a [SiteVerificationWebResourceResource].
-   *
-   * 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.
-   */
+  /// Get the most current data for a website or domain.
+  ///
+  /// Request parameters:
+  ///
+  /// [id] - The id of a verified site or domain.
+  ///
+  /// Completes with a [SiteVerificationWebResourceResource].
+  ///
+  /// 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<SiteVerificationWebResourceResource> get(core.String id) {
     var _url = null;
     var _queryParams = new core.Map();
@@ -106,32 +104,31 @@ class WebResourceResourceApi {
 
     _url = 'webResource/' + commons.Escaper.ecapeVariable('$id');
 
-    var _response = _requester.request(_url,
-                                       "GET",
-                                       body: _body,
-                                       queryParams: _queryParams,
-                                       uploadOptions: _uploadOptions,
-                                       uploadMedia: _uploadMedia,
-                                       downloadOptions: _downloadOptions);
-    return _response.then((data) => new SiteVerificationWebResourceResource.fromJson(data));
+    var _response = _requester.request(_url, "GET",
+        body: _body,
+        queryParams: _queryParams,
+        uploadOptions: _uploadOptions,
+        uploadMedia: _uploadMedia,
+        downloadOptions: _downloadOptions);
+    return _response
+        .then((data) => new SiteVerificationWebResourceResource.fromJson(data));
   }
 
-  /**
-   * Get a verification token for placing on a website or domain.
-   *
-   * [request] - The metadata request object.
-   *
-   * Request parameters:
-   *
-   * Completes with a [SiteVerificationWebResourceGettokenResponse].
-   *
-   * 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<SiteVerificationWebResourceGettokenResponse> getToken(SiteVerificationWebResourceGettokenRequest request) {
+  /// Get a verification token for placing on a website or domain.
+  ///
+  /// [request] - The metadata request object.
+  ///
+  /// Request parameters:
+  ///
+  /// Completes with a [SiteVerificationWebResourceGettokenResponse].
+  ///
+  /// 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<SiteVerificationWebResourceGettokenResponse> getToken(
+      SiteVerificationWebResourceGettokenRequest request) {
     var _url = null;
     var _queryParams = new core.Map();
     var _uploadMedia = null;
@@ -145,34 +142,34 @@ class WebResourceResourceApi {
 
     _url = 'token';
 
-    var _response = _requester.request(_url,
-                                       "POST",
-                                       body: _body,
-                                       queryParams: _queryParams,
-                                       uploadOptions: _uploadOptions,
-                                       uploadMedia: _uploadMedia,
-                                       downloadOptions: _downloadOptions);
-    return _response.then((data) => new SiteVerificationWebResourceGettokenResponse.fromJson(data));
+    var _response = _requester.request(_url, "POST",
+        body: _body,
+        queryParams: _queryParams,
+        uploadOptions: _uploadOptions,
+        uploadMedia: _uploadMedia,
+        downloadOptions: _downloadOptions);
+    return _response.then((data) =>
+        new SiteVerificationWebResourceGettokenResponse.fromJson(data));
   }
 
-  /**
-   * Attempt verification of a website or domain.
-   *
-   * [request] - The metadata request object.
-   *
-   * Request parameters:
-   *
-   * [verificationMethod] - The method to use for verifying a site or domain.
-   *
-   * Completes with a [SiteVerificationWebResourceResource].
-   *
-   * 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<SiteVerificationWebResourceResource> insert(SiteVerificationWebResourceResource request, core.String verificationMethod) {
+  /// Attempt verification of a website or domain.
+  ///
+  /// [request] - The metadata request object.
+  ///
+  /// Request parameters:
+  ///
+  /// [verificationMethod] - The method to use for verifying a site or domain.
+  ///
+  /// Completes with a [SiteVerificationWebResourceResource].
+  ///
+  /// 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<SiteVerificationWebResourceResource> insert(
+      SiteVerificationWebResourceResource request,
+      core.String verificationMethod) {
     var _url = null;
     var _queryParams = new core.Map();
     var _uploadMedia = null;
@@ -190,29 +187,27 @@ class WebResourceResourceApi {
 
     _url = 'webResource';
 
-    var _response = _requester.request(_url,
-                                       "POST",
-                                       body: _body,
-                                       queryParams: _queryParams,
-                                       uploadOptions: _uploadOptions,
-                                       uploadMedia: _uploadMedia,
-                                       downloadOptions: _downloadOptions);
-    return _response.then((data) => new SiteVerificationWebResourceResource.fromJson(data));
+    var _response = _requester.request(_url, "POST",
+        body: _body,
+        queryParams: _queryParams,
+        uploadOptions: _uploadOptions,
+        uploadMedia: _uploadMedia,
+        downloadOptions: _downloadOptions);
+    return _response
+        .then((data) => new SiteVerificationWebResourceResource.fromJson(data));
   }
 
-  /**
-   * Get the list of your verified websites and domains.
-   *
-   * Request parameters:
-   *
-   * Completes with a [SiteVerificationWebResourceListResponse].
-   *
-   * 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.
-   */
+  /// Get the list of your verified websites and domains.
+  ///
+  /// Request parameters:
+  ///
+  /// Completes with a [SiteVerificationWebResourceListResponse].
+  ///
+  /// 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<SiteVerificationWebResourceListResponse> list() {
     var _url = null;
     var _queryParams = new core.Map();
@@ -221,38 +216,36 @@ class WebResourceResourceApi {
     var _downloadOptions = commons.DownloadOptions.Metadata;
     var _body = null;
 
-
     _url = 'webResource';
 
-    var _response = _requester.request(_url,
-                                       "GET",
-                                       body: _body,
-                                       queryParams: _queryParams,
-                                       uploadOptions: _uploadOptions,
-                                       uploadMedia: _uploadMedia,
-                                       downloadOptions: _downloadOptions);
-    return _response.then((data) => new SiteVerificationWebResourceListResponse.fromJson(data));
+    var _response = _requester.request(_url, "GET",
+        body: _body,
+        queryParams: _queryParams,
+        uploadOptions: _uploadOptions,
+        uploadMedia: _uploadMedia,
+        downloadOptions: _downloadOptions);
+    return _response.then(
+        (data) => new SiteVerificationWebResourceListResponse.fromJson(data));
   }
 
-  /**
-   * Modify the list of owners for your website or domain. This method supports
-   * patch semantics.
-   *
-   * [request] - The metadata request object.
-   *
-   * Request parameters:
-   *
-   * [id] - The id of a verified site or domain.
-   *
-   * Completes with a [SiteVerificationWebResourceResource].
-   *
-   * 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<SiteVerificationWebResourceResource> patch(SiteVerificationWebResourceResource request, core.String id) {
+  /// Modify the list of owners for your website or domain. This method
+  /// supports patch semantics.
+  ///
+  /// [request] - The metadata request object.
+  ///
+  /// Request parameters:
+  ///
+  /// [id] - The id of a verified site or domain.
+  ///
+  /// Completes with a [SiteVerificationWebResourceResource].
+  ///
+  /// 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<SiteVerificationWebResourceResource> patch(
+      SiteVerificationWebResourceResource request, core.String id) {
     var _url = null;
     var _queryParams = new core.Map();
     var _uploadMedia = null;
@@ -269,34 +262,33 @@ class WebResourceResourceApi {
 
     _url = 'webResource/' + commons.Escaper.ecapeVariable('$id');
 
-    var _response = _requester.request(_url,
-                                       "PATCH",
-                                       body: _body,
-                                       queryParams: _queryParams,
-                                       uploadOptions: _uploadOptions,
-                                       uploadMedia: _uploadMedia,
-                                       downloadOptions: _downloadOptions);
-    return _response.then((data) => new SiteVerificationWebResourceResource.fromJson(data));
+    var _response = _requester.request(_url, "PATCH",
+        body: _body,
+        queryParams: _queryParams,
+        uploadOptions: _uploadOptions,
+        uploadMedia: _uploadMedia,
+        downloadOptions: _downloadOptions);
+    return _response
+        .then((data) => new SiteVerificationWebResourceResource.fromJson(data));
   }
 
-  /**
-   * Modify the list of owners for your website or domain.
-   *
-   * [request] - The metadata request object.
-   *
-   * Request parameters:
-   *
-   * [id] - The id of a verified site or domain.
-   *
-   * Completes with a [SiteVerificationWebResourceResource].
-   *
-   * 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<SiteVerificationWebResourceResource> update(SiteVerificationWebResourceResource request, core.String id) {
+  /// Modify the list of owners for your website or domain.
+  ///
+  /// [request] - The metadata request object.
+  ///
+  /// Request parameters:
+  ///
+  /// [id] - The id of a verified site or domain.
+  ///
+  /// Completes with a [SiteVerificationWebResourceResource].
+  ///
+  /// 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<SiteVerificationWebResourceResource> update(
+      SiteVerificationWebResourceResource request, core.String id) {
     var _url = null;
     var _queryParams = new core.Map();
     var _uploadMedia = null;
@@ -313,31 +305,25 @@ class WebResourceResourceApi {
 
     _url = 'webResource/' + commons.Escaper.ecapeVariable('$id');
 
-    var _response = _requester.request(_url,
-                                       "PUT",
-                                       body: _body,
-                                       queryParams: _queryParams,
-                                       uploadOptions: _uploadOptions,
-                                       uploadMedia: _uploadMedia,
-                                       downloadOptions: _downloadOptions);
-    return _response.then((data) => new SiteVerificationWebResourceResource.fromJson(data));
+    var _response = _requester.request(_url, "PUT",
+        body: _body,
+        queryParams: _queryParams,
+        uploadOptions: _uploadOptions,
+        uploadMedia: _uploadMedia,
+        downloadOptions: _downloadOptions);
+    return _response
+        .then((data) => new SiteVerificationWebResourceResource.fromJson(data));
   }
-
 }
 
-
-
-/** The site for which a verification token will be generated. */
+/// The site for which a verification token will be generated.
 class SiteVerificationWebResourceGettokenRequestSite {
-  /**
-   * The site identifier. If the type is set to SITE, the identifier is a URL.
-   * If the type is set to INET_DOMAIN, the site identifier is a domain name.
-   */
+  /// The site identifier. If the type is set to SITE, the identifier is a URL.
+  /// If the type is set to INET_DOMAIN, the site identifier is a domain name.
   core.String identifier;
-  /**
-   * The type of resource to be verified. Can be SITE or INET_DOMAIN (domain
-   * name).
-   */
+
+  /// The type of resource to be verified. Can be SITE or INET_DOMAIN (domain
+  /// name).
   core.String type;
 
   SiteVerificationWebResourceGettokenRequestSite();
@@ -352,7 +338,8 @@ class SiteVerificationWebResourceGettokenRequestSite {
   }
 
   core.Map<core.String, core.Object> toJson() {
-    final core.Map<core.String, core.Object> _json = new core.Map<core.String, core.Object>();
+    final core.Map<core.String, core.Object> _json =
+        new core.Map<core.String, core.Object>();
     if (identifier != null) {
       _json["identifier"] = identifier;
     }
@@ -364,19 +351,20 @@ class SiteVerificationWebResourceGettokenRequestSite {
 }
 
 class SiteVerificationWebResourceGettokenRequest {
-  /** The site for which a verification token will be generated. */
+  /// The site for which a verification token will be generated.
   SiteVerificationWebResourceGettokenRequestSite site;
-  /**
-   * The verification method that will be used to verify this site. For sites,
-   * 'FILE' or 'META' methods may be used. For domains, only 'DNS' may be used.
-   */
+
+  /// The verification method that will be used to verify this site. For sites,
+  /// 'FILE' or 'META' methods may be used. For domains, only 'DNS' may be
+  /// used.
   core.String verificationMethod;
 
   SiteVerificationWebResourceGettokenRequest();
 
   SiteVerificationWebResourceGettokenRequest.fromJson(core.Map _json) {
     if (_json.containsKey("site")) {
-      site = new SiteVerificationWebResourceGettokenRequestSite.fromJson(_json["site"]);
+      site = new SiteVerificationWebResourceGettokenRequestSite.fromJson(
+          _json["site"]);
     }
     if (_json.containsKey("verificationMethod")) {
       verificationMethod = _json["verificationMethod"];
@@ -384,7 +372,8 @@ class SiteVerificationWebResourceGettokenRequest {
   }
 
   core.Map<core.String, core.Object> toJson() {
-    final core.Map<core.String, core.Object> _json = new core.Map<core.String, core.Object>();
+    final core.Map<core.String, core.Object> _json =
+        new core.Map<core.String, core.Object>();
     if (site != null) {
       _json["site"] = (site).toJson();
     }
@@ -396,18 +385,15 @@ class SiteVerificationWebResourceGettokenRequest {
 }
 
 class SiteVerificationWebResourceGettokenResponse {
-  /**
-   * The verification method to use in conjunction with this token. For FILE,
-   * the token should be placed in the top-level directory of the site, stored
-   * inside a file of the same name. For META, the token should be placed in the
-   * HEAD tag of the default page that is loaded for the site. For DNS, the
-   * token should be placed in a TXT record of the domain.
-   */
+  /// The verification method to use in conjunction with this token. For FILE,
+  /// the token should be placed in the top-level directory of the site, stored
+  /// inside a file of the same name. For META, the token should be placed in
+  /// the HEAD tag of the default page that is loaded for the site. For DNS,
+  /// the token should be placed in a TXT record of the domain.
   core.String method;
-  /**
-   * The verification token. The token must be placed appropriately in order for
-   * verification to succeed.
-   */
+
+  /// The verification token. The token must be placed appropriately in order
+  /// for verification to succeed.
   core.String token;
 
   SiteVerificationWebResourceGettokenResponse();
@@ -422,7 +408,8 @@ class SiteVerificationWebResourceGettokenResponse {
   }
 
   core.Map<core.String, core.Object> toJson() {
-    final core.Map<core.String, core.Object> _json = new core.Map<core.String, core.Object>();
+    final core.Map<core.String, core.Object> _json =
+        new core.Map<core.String, core.Object>();
     if (method != null) {
       _json["method"] = method;
     }
@@ -434,19 +421,23 @@ class SiteVerificationWebResourceGettokenResponse {
 }
 
 class SiteVerificationWebResourceListResponse {
-  /** The list of sites that are owned by the authenticated user. */
+  /// The list of sites that are owned by the authenticated user.
   core.List<SiteVerificationWebResourceResource> items;
 
   SiteVerificationWebResourceListResponse();
 
   SiteVerificationWebResourceListResponse.fromJson(core.Map _json) {
     if (_json.containsKey("items")) {
-      items = _json["items"].map((value) => new SiteVerificationWebResourceResource.fromJson(value)).toList();
+      items = _json["items"]
+          .map((value) =>
+              new SiteVerificationWebResourceResource.fromJson(value))
+          .toList();
     }
   }
 
   core.Map<core.String, core.Object> toJson() {
-    final core.Map<core.String, core.Object> _json = new core.Map<core.String, core.Object>();
+    final core.Map<core.String, core.Object> _json =
+        new core.Map<core.String, core.Object>();
     if (items != null) {
       _json["items"] = items.map((value) => (value).toJson()).toList();
     }
@@ -454,14 +445,13 @@ class SiteVerificationWebResourceListResponse {
   }
 }
 
-/** The address and type of a site that is verified or will be verified. */
+/// The address and type of a site that is verified or will be verified.
 class SiteVerificationWebResourceResourceSite {
-  /**
-   * The site identifier. If the type is set to SITE, the identifier is a URL.
-   * If the type is set to INET_DOMAIN, the site identifier is a domain name.
-   */
+  /// The site identifier. If the type is set to SITE, the identifier is a URL.
+  /// If the type is set to INET_DOMAIN, the site identifier is a domain name.
   core.String identifier;
-  /** The site type. Can be SITE or INET_DOMAIN (domain name). */
+
+  /// The site type. Can be SITE or INET_DOMAIN (domain name).
   core.String type;
 
   SiteVerificationWebResourceResourceSite();
@@ -476,7 +466,8 @@ class SiteVerificationWebResourceResourceSite {
   }
 
   core.Map<core.String, core.Object> toJson() {
-    final core.Map<core.String, core.Object> _json = new core.Map<core.String, core.Object>();
+    final core.Map<core.String, core.Object> _json =
+        new core.Map<core.String, core.Object>();
     if (identifier != null) {
       _json["identifier"] = identifier;
     }
@@ -488,14 +479,14 @@ class SiteVerificationWebResourceResourceSite {
 }
 
 class SiteVerificationWebResourceResource {
-  /**
-   * The string used to identify this site. This value should be used in the
-   * "id" portion of the REST URL for the Get, Update, and Delete operations.
-   */
+  /// The string used to identify this site. This value should be used in the
+  /// "id" portion of the REST URL for the Get, Update, and Delete operations.
   core.String id;
-  /** The email addresses of all verified owners. */
+
+  /// The email addresses of all verified owners.
   core.List<core.String> owners;
-  /** The address and type of a site that is verified or will be verified. */
+
+  /// The address and type of a site that is verified or will be verified.
   SiteVerificationWebResourceResourceSite site;
 
   SiteVerificationWebResourceResource();
@@ -508,12 +499,14 @@ class SiteVerificationWebResourceResource {
       owners = _json["owners"];
     }
     if (_json.containsKey("site")) {
-      site = new SiteVerificationWebResourceResourceSite.fromJson(_json["site"]);
+      site =
+          new SiteVerificationWebResourceResourceSite.fromJson(_json["site"]);
     }
   }
 
   core.Map<core.String, core.Object> toJson() {
-    final core.Map<core.String, core.Object> _json = new core.Map<core.String, core.Object>();
+    final core.Map<core.String, core.Object> _json =
+        new core.Map<core.String, core.Object>();
     if (id != null) {
       _json["id"] = id;
     }