Api-roll 47: 2017-03-27

generated/googleapis/lib/cloudbilling/v1.dart

 // This is a generated file (see the discoveryapis_generator project).
 
 library googleapis.cloudbilling.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;
 
 export 'package:_discoveryapis_commons/_discoveryapis_commons.dart' show
     ApiRequestError, DetailedApiRequestError;
 
 const core.String USER_AGENT = 'dart-api-client cloudbilling/v1';
 
 /**
- * Retrieves Google Developers Console billing accounts and associates them with
- * projects.
+ * Allows developers to manage billing for their Google Cloud Platform projects
+ *     programmatically.
  */
 class CloudbillingApi {
   /** View and manage your data across Google Cloud Platform services */
   static const CloudPlatformScope = "https://www.googleapis.com/auth/cloud-platform";
 
 
   final commons.ApiRequester _requester;
 
   BillingAccountsResourceApi get billingAccounts => new BillingAccountsResourceApi(_requester);
   ProjectsResourceApi get projects => new ProjectsResourceApi(_requester);
@@ skipping 13 matching lines @@
 
   /**
    * Gets information about a billing account. The current authenticated user
    * must be an [owner of the billing
    * account](https://support.google.com/cloud/answer/4430947).
    *
    * Request parameters:
    *
    * [name] - The resource name of the billing account to retrieve. For example,
    * `billingAccounts/012345-567890-ABCDEF`.
-   * Value must have pattern "^billingAccounts/[^/]*$".
+   * Value must have pattern "^billingAccounts/[^/]+$".
    *
    * Completes with a [BillingAccount].
    *
    * 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<BillingAccount> get(core.String name) {
@@ skipping 20 matching lines @@
     return _response.then((data) => new BillingAccount.fromJson(data));
   }
 
   /**
    * Lists the billing accounts that the current authenticated user
    * [owns](https://support.google.com/cloud/answer/4430947).
    *
    * Request parameters:
    *
    * [pageSize] - Requested page size. The maximum page size is 100; this is
-   * also the default.
+   * also the
+   * default.
    *
    * [pageToken] - A token identifying a page of results to return. This should
-   * be a `next_page_token` value returned from a previous `ListBillingAccounts`
+   * be a
+   * `next_page_token` value returned from a previous `ListBillingAccounts`
    * call. If unspecified, the first page of results is returned.
    *
    * Completes with a [ListBillingAccountsResponse].
    *
    * 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.
    */
@@ skipping 34 matching lines @@
       _requester = client;
 
   /**
    * Lists the projects associated with a billing account. The current
    * authenticated user must be an [owner of the billing
    * account](https://support.google.com/cloud/answer/4430947).
    *
    * Request parameters:
    *
    * [name] - The resource name of the billing account associated with the
-   * projects that you want to list. For example,
-   * `billingAccounts/012345-567890-ABCDEF`.
-   * Value must have pattern "^billingAccounts/[^/]*$".
+   * projects that
+   * you want to list. For example, `billingAccounts/012345-567890-ABCDEF`.
+   * Value must have pattern "^billingAccounts/[^/]+$".
    *
    * [pageSize] - Requested page size. The maximum page size is 100; this is
-   * also the default.
+   * also the
+   * default.
    *
    * [pageToken] - A token identifying a page of results to be returned. This
-   * should be a `next_page_token` value returned from a previous
-   * `ListProjectBillingInfo` call. If unspecified, the first page of results is
-   * returned.
+   * should be a
+   * `next_page_token` value returned from a previous `ListProjectBillingInfo`
+   * call. If unspecified, the first page of results is returned.
    *
    * Completes with a [ListProjectBillingInfoResponse].
    *
    * 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<ListProjectBillingInfoResponse> list(core.String name, {core.int pageSize, core.String pageToken}) {
@@ skipping 38 matching lines @@
   /**
    * Gets the billing information for a project. The current authenticated user
    * must have [permission to view the
    * project](https://cloud.google.com/docs/permissions-overview#h.bgs0oxofvnoo
    * ).
    *
    * Request parameters:
    *
    * [name] - The resource name of the project for which billing information is
    * retrieved. For example, `projects/tokyo-rain-123`.
-   * Value must have pattern "^projects/[^/]*$".
+   * Value must have pattern "^projects/[^/]+$".
    *
    * Completes with a [ProjectBillingInfo].
    *
    * 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<ProjectBillingInfo> getBillingInfo(core.String name) {
@@ skipping 20 matching lines @@
     return _response.then((data) => new ProjectBillingInfo.fromJson(data));
   }
 
   /**
    * Sets or updates the billing account associated with a project. You specify
    * the new billing account by setting the `billing_account_name` in the
    * `ProjectBillingInfo` resource to the resource name of a billing account.
    * Associating a project with an open billing account enables billing on the
    * project and allows charges for resource usage. If the project already had a
    * billing account, this method changes the billing account used for resource
-   * usage charges. *Note:* Incurred charges that have not yet been reported in
-   * the transaction history of the Google Developers Console may be billed to
-   * the new billing account, even if the charge occurred before the new billing
-   * account was assigned to the project. The current authenticated user must
-   * have ownership privileges for both the
+   * usage charges.
+   *
+   * *Note:* Incurred charges that have not yet been reported in the transaction
+   * history of the Google Cloud Console may be billed to the new billing
+   * account, even if the charge occurred before the new billing account was
+   * assigned to the project.
+   *
+   * The current authenticated user must have ownership privileges for both the
    * [project](https://cloud.google.com/docs/permissions-overview#h.bgs0oxofvnoo
    * ) and the [billing
-   * account](https://support.google.com/cloud/answer/4430947). You can disable
-   * billing on the project by setting the `billing_account_name` field to
-   * empty. This action disassociates the current billing account from the
-   * project. Any billable activity of your in-use services will stop, and your
-   * application could stop functioning as expected. Any unbilled charges to
-   * date will be billed to the previously associated account. The current
-   * authenticated user must be either an owner of the project or an owner of
-   * the billing account for the project. Note that associating a project with a
-   * *closed* billing account will have much the same effect as disabling
-   * billing on the project: any paid resources used by the project will be shut
-   * down. Thus, unless you wish to disable billing, you should always call this
-   * method with the name of an *open* billing account.
+   * account](https://support.google.com/cloud/answer/4430947).
+   *
+   * You can disable billing on the project by setting the
+   * `billing_account_name` field to empty. This action disassociates the
+   * current billing account from the project. Any billable activity of your
+   * in-use services will stop, and your application could stop functioning as
+   * expected. Any unbilled charges to date will be billed to the previously
+   * associated account. The current authenticated user must be either an owner
+   * of the project or an owner of the billing account for the project.
+   *
+   * Note that associating a project with a *closed* billing account will have
+   * much the same effect as disabling billing on the project: any paid
+   * resources used by the project will be shut down. Thus, unless you wish to
+   * disable billing, you should always call this method with the name of an
+   * *open* billing account.
    *
    * [request] - The metadata request object.
    *
    * Request parameters:
    *
    * [name] - The resource name of the project associated with the billing
-   * information that you want to update. For example,
-   * `projects/tokyo-rain-123`.
-   * Value must have pattern "^projects/[^/]*$".
+   * information
+   * that you want to update. For example, `projects/tokyo-rain-123`.
+   * Value must have pattern "^projects/[^/]+$".
    *
    * Completes with a [ProjectBillingInfo].
    *
    * 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<ProjectBillingInfo> updateBillingInfo(ProjectBillingInfo request, core.String name) {
@@ skipping 21 matching lines @@
                                        uploadMedia: _uploadMedia,
                                        downloadOptions: _downloadOptions);
     return _response.then((data) => new ProjectBillingInfo.fromJson(data));
   }
 
 }
 
 
 
 /**
- * A billing account in [Google Developers
- * Console](https://console.developers.google.com/). You can assign a billing
- * account to one or more projects.
+ * A billing account in [Google Cloud
+ * Console](https://console.cloud.google.com/). You can assign a billing account
+ * to one or more projects.
  */
 class BillingAccount {
   /**
    * The display name given to the billing account, such as `My Billing
-   * Account`. This name is displayed in the Google Developers Console.
+   * Account`. This name is displayed in the Google Cloud Console.
    */
   core.String displayName;
   /**
    * The resource name of the billing account. The resource name has the form
    * `billingAccounts/{billing_account_id}`. For example,
    * `billingAccounts/012345-567890-ABCDEF` would be the resource name for
    * billing account `012345-567890-ABCDEF`.
    */
   core.String name;
   /**
@@ skipping 97 matching lines @@
       _json["nextPageToken"] = nextPageToken;
     }
     if (projectBillingInfo != null) {
       _json["projectBillingInfo"] = projectBillingInfo.map((value) => (value).toJson()).toList();
     }
     return _json;
   }
 }
 
 /**
- * Encapsulation of billing information for a Developers Console project. A
- * project has at most one associated billing account at a time (but a billing
- * account can be assigned to multiple projects).
+ * Encapsulation of billing information for a Cloud Console project. A project
+ * has at most one associated billing account at a time (but a billing account
+ * can be assigned to multiple projects).
  */
 class ProjectBillingInfo {
   /**
    * The resource name of the billing account associated with the project, if
    * any. For example, `billingAccounts/012345-567890-ABCDEF`.
    */
   core.String billingAccountName;
   /**
    * True if the project is associated with an open billing account, to which
    * usage on the project is charged. False if the project is associated with a
@@ skipping 42 matching lines @@
     }
     if (name != null) {
       _json["name"] = name;
     }
     if (projectId != null) {
       _json["projectId"] = projectId;
     }
     return _json;
   }
 }