Api-roll 43: 2016-12-13

generated/googleapis_beta/lib/cloudresourcemanager/v1beta1.dart

Index: generated/googleapis_beta/lib/cloudresourcemanager/v1beta1.dart
diff --git a/generated/googleapis_beta/lib/cloudresourcemanager/v1beta1.dart b/generated/googleapis_beta/lib/cloudresourcemanager/v1beta1.dart
index e86a70fa005b116fefe3a82cae30dd6e03121a68..395d6f4c8dbe22229c58b1e4900f8f13db184eb9 100644
--- a/generated/googleapis_beta/lib/cloudresourcemanager/v1beta1.dart
+++ b/generated/googleapis_beta/lib/cloudresourcemanager/v1beta1.dart
@@ -49,10 +49,10 @@ class OrganizationsResourceApi {
    *
    * [name] - The resource name of the Organization to fetch, e.g.
    * "organizations/1234".
-   * Value must have pattern "^organizations/[^/]*$".
+   * Value must have pattern "^organizations/[^/]+$".
    *
-   * [organizationId] - The id of the Organization resource to fetch. This field
-   * is deprecated and will be removed in v1. Use name instead.
+   * [organizationId] - The id of the Organization resource to fetch.
+   * This field is deprecated and will be removed in v1. Use name instead.
    *
    * Completes with a [Organization].
    *
@@ -99,9 +99,10 @@ class OrganizationsResourceApi {
    * Request parameters:
    *
    * [resource] - REQUIRED: The resource for which the policy is being
-   * requested. `resource` is usually specified as a path. For example, a
-   * Project resource is specified as `projects/{project}`.
-   * Value must have pattern "^organizations/[^/]*$".
+   * requested.
+   * `resource` is usually specified as a path. For example, a Project
+   * resource is specified as `projects/{project}`.
+   * Value must have pattern "^organizations/[^/]+$".
    *
    * Completes with a [Policy].
    *
@@ -139,8 +140,8 @@ class OrganizationsResourceApi {
   }
 
   /**
-   * Lists Organization resources that are visible to the user and satisfy the
-   * specified filter. This method returns Organizations in an unspecified
+   * Lists Organization resources that are visible to the user and satisfy
+   * the specified filter. This method returns Organizations in an unspecified
    * order. New Organizations do not necessarily appear at the end of the list.
    *
    * Request parameters:
@@ -148,17 +149,25 @@ class OrganizationsResourceApi {
    * [pageSize] - The maximum number of Organizations to return in the response.
    * This field is optional.
    *
-   * [pageToken] - A pagination token returned from a previous call to
-   * `ListOrganizations` that indicates from where listing should continue. This
-   * field is optional.
-   *
    * [filter] - An optional query string used to filter the Organizations to
-   * return in the response. Filter rules are case-insensitive. Organizations
-   * may be filtered by `owner.directoryCustomerId` or by `domain`, where the
-   * domain is a Google for Work domain, for example: |Filter|Description|
-   * |------|-----------| |owner.directorycustomerid:123456789|Organizations
-   * with `owner.directory_customer_id` equal to `123456789`.|
+   * return in
+   * the response. Filter rules are case-insensitive.
+   *
+   *
+   * Organizations may be filtered by `owner.directoryCustomerId` or by
+   * `domain`, where the domain is a Google for Work domain, for example:
+   *
+   * |Filter|Description|
+   * |------|-----------|
+   * |owner.directorycustomerid:123456789|Organizations with
+   * `owner.directory_customer_id` equal to `123456789`.|
    * |domain:google.com|Organizations corresponding to the domain `google.com`.|
+   *
+   * This field is optional.
+   *
+   * [pageToken] - A pagination token returned from a previous call to
+   * `ListOrganizations`
+   * that indicates from where listing should continue.
    * This field is optional.
    *
    * Completes with a [ListOrganizationsResponse].
@@ -169,7 +178,7 @@ class OrganizationsResourceApi {
    * If the used [http.Client] completes with an error when making a REST call,
    * this method will complete with the same error.
    */
-  async.Future<ListOrganizationsResponse> list({core.int pageSize, core.String pageToken, core.String filter}) {
+  async.Future<ListOrganizationsResponse> list({core.int pageSize, core.String filter, core.String pageToken}) {
     var _url = null;
     var _queryParams = new core.Map();
     var _uploadMedia = null;
@@ -180,12 +189,12 @@ class OrganizationsResourceApi {
     if (pageSize != null) {
       _queryParams["pageSize"] = ["${pageSize}"];
     }
-    if (pageToken != null) {
-      _queryParams["pageToken"] = [pageToken];
-    }
     if (filter != null) {
       _queryParams["filter"] = [filter];
     }
+    if (pageToken != null) {
+      _queryParams["pageToken"] = [pageToken];
+    }
 
     _url = 'v1beta1/organizations';
 
@@ -209,9 +218,10 @@ class OrganizationsResourceApi {
    * Request parameters:
    *
    * [resource] - REQUIRED: The resource for which the policy is being
-   * specified. `resource` is usually specified as a path. For example, a
-   * Project resource is specified as `projects/{project}`.
-   * Value must have pattern "^organizations/[^/]*$".
+   * specified.
+   * `resource` is usually specified as a path. For example, a Project
+   * resource is specified as `projects/{project}`.
+   * Value must have pattern "^organizations/[^/]+$".
    *
    * Completes with a [Policy].
    *
@@ -249,18 +259,19 @@ class OrganizationsResourceApi {
   }
 
   /**
-   * Returns permissions that a caller has on the specified Organization. The
-   * `resource` field should be the organization's resource name, e.g.
-   * "organizations/123".
+   * Returns permissions that a caller has on the specified Organization.
+   * The `resource` field should be the organization's resource name,
+   * e.g. "organizations/123".
    *
    * [request] - The metadata request object.
    *
    * Request parameters:
    *
    * [resource] - REQUIRED: The resource for which the policy detail is being
-   * requested. `resource` is usually specified as a path. For example, a
-   * Project resource is specified as `projects/{project}`.
-   * Value must have pattern "^organizations/[^/]*$".
+   * requested.
+   * `resource` is usually specified as a path. For example, a Project
+   * resource is specified as `projects/{project}`.
+   * Value must have pattern "^organizations/[^/]+$".
    *
    * Completes with a [TestIamPermissionsResponse].
    *
@@ -307,7 +318,7 @@ class OrganizationsResourceApi {
    * [name] - Output Only. The resource name of the organization. This is the
    * organization's relative path in the API. Its format is
    * "organizations/[organization_id]". For example, "organizations/1234".
-   * Value must have pattern "^organizations/[^/]*$".
+   * Value must have pattern "^organizations/[^/]+$".
    *
    * Completes with a [Organization].
    *
@@ -354,10 +365,14 @@ class ProjectsResourceApi {
       _requester = client;
 
   /**
-   * Creates a Project resource. Initially, the Project resource is owned by its
-   * creator exclusively. The creator can later grant permission to others to
-   * read or update the Project. Several APIs are activated automatically for
-   * the Project, including Google Cloud Storage.
+   * Creates a Project resource.
+   *
+   * Initially, the Project resource is owned by its creator exclusively.
+   * The creator can later grant permission to others to read or update the
+   * Project.
+   *
+   * Several APIs are activated automatically for the Project, including
+   * Google Cloud Storage.
    *
    * [request] - The metadata request object.
    *
@@ -402,22 +417,36 @@ class ProjectsResourceApi {
   }
 
   /**
-   * Marks the Project identified by the specified `project_id` (for example,
-   * `my-project-123`) for deletion. This method will only affect the Project if
-   * the following criteria are met: + The Project does not have a billing
-   * account associated with it. + The Project has a lifecycle state of ACTIVE.
-   * This method changes the Project's lifecycle state from ACTIVE to
-   * DELETE_REQUESTED. The deletion starts at an unspecified time, at which
-   * point the project is no longer accessible. Until the deletion completes,
-   * you can check the lifecycle state checked by retrieving the Project with
-   * GetProject, and the Project remains visible to ListProjects. However, you
-   * cannot update the project. After the deletion completes, the Project is not
-   * retrievable by the GetProject and ListProjects methods. The caller must
-   * have modify permissions for this Project.
+   * Marks the Project identified by the specified
+   * `project_id` (for example, `my-project-123`) for deletion.
+   * This method will only affect the Project if the following criteria are met:
+   *
+   * + The Project does not have a billing account associated with it.
+   * + The Project has a lifecycle state of
+   * ACTIVE.
+   *
+   * This method changes the Project's lifecycle state from
+   * ACTIVE
+   * to DELETE_REQUESTED.
+   * The deletion starts at an unspecified time, at which point the project is
+   * no longer accessible.
+   *
+   * Until the deletion completes, you can check the lifecycle state
+   * checked by retrieving the Project with GetProject,
+   * and the Project remains visible to ListProjects.
+   * However, you cannot update the project.
+   *
+   * After the deletion completes, the Project is not retrievable by
+   * the  GetProject and
+   * ListProjects methods.
+   *
+   * The caller must have modify permissions for this Project.
    *
    * Request parameters:
    *
-   * [projectId] - The Project ID (for example, `foo-bar-123`). Required.
+   * [projectId] - The Project ID (for example, `foo-bar-123`).
+   *
+   * Required.
    *
    * Completes with a [Empty].
    *
@@ -452,13 +481,16 @@ class ProjectsResourceApi {
   }
 
   /**
-   * Retrieves the Project identified by the specified `project_id` (for
-   * example, `my-project-123`). The caller must have read permissions for this
-   * Project.
+   * Retrieves the Project identified by the specified
+   * `project_id` (for example, `my-project-123`).
+   *
+   * The caller must have read permissions for this Project.
    *
    * Request parameters:
    *
-   * [projectId] - The Project ID (for example, `my-project-123`). Required.
+   * [projectId] - The Project ID (for example, `my-project-123`).
+   *
+   * Required.
    *
    * Completes with a [Project].
    *
@@ -495,13 +527,16 @@ class ProjectsResourceApi {
   /**
    * Gets a list of ancestors in the resource hierarchy for the Project
    * identified by the specified `project_id` (for example, `my-project-123`).
+   *
    * The caller must have read permissions for this Project.
    *
    * [request] - The metadata request object.
    *
    * Request parameters:
    *
-   * [projectId] - The Project ID (for example, `my-project-123`). Required.
+   * [projectId] - The Project ID (for example, `my-project-123`).
+   *
+   * Required.
    *
    * Completes with a [GetAncestryResponse].
    *
@@ -539,16 +574,17 @@ class ProjectsResourceApi {
   }
 
   /**
-   * Returns the IAM access control policy for the specified Project. Permission
-   * is denied if the policy or the resource does not exist.
+   * Returns the IAM access control policy for the specified Project.
+   * Permission is denied if the policy or the resource does not exist.
    *
    * [request] - The metadata request object.
    *
    * Request parameters:
    *
    * [resource] - REQUIRED: The resource for which the policy is being
-   * requested. `resource` is usually specified as a path. For example, a
-   * Project resource is specified as `projects/{project}`.
+   * requested.
+   * `resource` is usually specified as a path. For example, a Project
+   * resource is specified as `projects/{project}`.
    *
    * Completes with a [Policy].
    *
@@ -586,29 +622,46 @@ class ProjectsResourceApi {
   }
 
   /**
-   * Lists Projects that are visible to the user and satisfy the specified
-   * filter. This method returns Projects in an unspecified order. New Projects
-   * do not necessarily appear at the end of the list.
+   * Lists Projects that are visible to the user and satisfy the
+   * specified filter. This method returns Projects in an unspecified order.
+   * New Projects do not necessarily appear at the end of the list.
    *
    * Request parameters:
    *
+   * [pageSize] - The maximum number of Projects to return in the response.
+   * The server can return fewer Projects than requested.
+   * If unspecified, server picks an appropriate default.
+   *
+   * Optional.
+   *
+   * [filter] - An expression for filtering the results of the request.  Filter
+   * rules are
+   * case insensitive. The fields eligible for filtering are:
+   *
+   * + `name`
+   * + `id`
+   * + <code>labels.<em>key</em></code> where *key* is the name of a label
+   *
+   * Some examples of using labels as filters:
+   *
+   * |Filter|Description|
+   * |------|-----------|
+   * |name:*|The project has a name.|
+   * |name:Howl|The project's name is `Howl` or `howl`.|
+   * |name:HOWL|Equivalent to above.|
+   * |NAME:howl|Equivalent to above.|
+   * |labels.color:*|The project has the label `color`.|
+   * |labels.color:red|The project's label `color` has the value `red`.|
+   * |labels.color:red&nbsp;label.size:big|The project's label `color` has the
+   * value `red` and its label `size` has the value `big`.
+   *
+   * Optional.
+   *
    * [pageToken] - A pagination token returned from a previous call to
-   * ListProjects that indicates from where listing should continue. Optional.
-   *
-   * [pageSize] - The maximum number of Projects to return in the response. The
-   * server can return fewer Projects than requested. If unspecified, server
-   * picks an appropriate default. Optional.
-   *
-   * [filter] - An expression for filtering the results of the request. Filter
-   * rules are case insensitive. The fields eligible for filtering are: + `name`
-   * + `id` + labels.key where *key* is the name of a label Some examples of
-   * using labels as filters: |Filter|Description| |------|-----------|
-   * |name:*|The project has a name.| |name:Howl|The project's name is `Howl` or
-   * `howl`.| |name:HOWL|Equivalent to above.| |NAME:howl|Equivalent to above.|
-   * |labels.color:*|The project has the label `color`.| |labels.color:red|The
-   * project's label `color` has the value `red`.|
-   * |labels.color:red label.size:big|The project's label `color` has the value
-   * `red` and its label `size` has the value `big`. Optional.
+   * ListProjects
+   * that indicates from where listing should continue.
+   *
+   * Optional.
    *
    * Completes with a [ListProjectsResponse].
    *
@@ -618,7 +671,7 @@ class ProjectsResourceApi {
    * If the used [http.Client] completes with an error when making a REST call,
    * this method will complete with the same error.
    */
-  async.Future<ListProjectsResponse> list({core.String pageToken, core.int pageSize, core.String filter}) {
+  async.Future<ListProjectsResponse> list({core.int pageSize, core.String filter, core.String pageToken}) {
     var _url = null;
     var _queryParams = new core.Map();
     var _uploadMedia = null;
@@ -626,15 +679,15 @@ class ProjectsResourceApi {
     var _downloadOptions = commons.DownloadOptions.Metadata;
     var _body = null;
 
-    if (pageToken != null) {
-      _queryParams["pageToken"] = [pageToken];
-    }
     if (pageSize != null) {
       _queryParams["pageSize"] = ["${pageSize}"];
     }
     if (filter != null) {
       _queryParams["filter"] = [filter];
     }
+    if (pageToken != null) {
+      _queryParams["pageToken"] = [pageToken];
+    }
 
     _url = 'v1beta1/projects';
 
@@ -649,27 +702,41 @@ class ProjectsResourceApi {
   }
 
   /**
-   * Sets the IAM access control policy for the specified Project. Replaces any
-   * existing policy. The following constraints apply when using
-   * `setIamPolicy()`: + Project does not support `allUsers` and
-   * `allAuthenticatedUsers` as `members` in a `Binding` of a `Policy`. + The
-   * owner role can be granted only to `user` and `serviceAccount`. + Service
-   * accounts can be made owners of a project directly without any restrictions.
-   * However, to be added as an owner, a user must be invited via Cloud Platform
-   * console and must accept the invitation. + A user cannot be granted the
-   * owner role using `setIamPolicy()`. The user must be granted the owner role
-   * using the Cloud Platform Console and must explicitly accept the invitation.
+   * Sets the IAM access control policy for the specified Project. Replaces
+   * any existing policy.
+   *
+   * The following constraints apply when using `setIamPolicy()`:
+   *
+   * + Project does not support `allUsers` and `allAuthenticatedUsers` as
+   * `members` in a `Binding` of a `Policy`.
+   *
+   * + The owner role can be granted only to `user` and `serviceAccount`.
+   *
+   * + Service accounts can be made owners of a project directly
+   * without any restrictions. However, to be added as an owner, a user must be
+   * invited via Cloud Platform console and must accept the invitation.
+   *
+   * + A user cannot be granted the owner role using `setIamPolicy()`. The user
+   * must be granted the owner role using the Cloud Platform Console and must
+   * explicitly accept the invitation.
+   *
    * + Invitations to grant the owner role cannot be sent using
-   * `setIamPolicy()`; they must be sent only using the Cloud Platform Console.
+   * `setIamPolicy()`;
+   * they must be sent only using the Cloud Platform Console.
+   *
    * + Membership changes that leave the project without any owners that have
-   * accepted the Terms of Service (ToS) will be rejected. + There must be at
-   * least one owner who has accepted the Terms of Service (ToS) agreement in
-   * the policy. Calling `setIamPolicy()` to to remove the last ToS-accepted
-   * owner from the policy will fail. This restriction also applies to legacy
-   * projects that no longer have owners who have accepted the ToS. Edits to IAM
-   * policies will be rejected until the lack of a ToS-accepting owner is
-   * rectified. + Calling this method requires enabling the App Engine Admin
-   * API. Note: Removing service accounts from policies or changing their roles
+   * accepted the Terms of Service (ToS) will be rejected.
+   *
+   * + There must be at least one owner who has accepted the Terms of
+   * Service (ToS) agreement in the policy. Calling `setIamPolicy()` to
+   * to remove the last ToS-accepted owner from the policy will fail. This
+   * restriction also applies to legacy projects that no longer have owners
+   * who have accepted the ToS. Edits to IAM policies will be rejected until
+   * the lack of a ToS-accepting owner is rectified.
+   *
+   * + Calling this method requires enabling the App Engine Admin API.
+   *
+   * Note: Removing service accounts from policies or changing their roles
    * can render services completely inoperable. It is important to understand
    * how the service account is being used before removing or updating its
    * roles.
@@ -679,8 +746,9 @@ class ProjectsResourceApi {
    * Request parameters:
    *
    * [resource] - REQUIRED: The resource for which the policy is being
-   * specified. `resource` is usually specified as a path. For example, a
-   * Project resource is specified as `projects/{project}`.
+   * specified.
+   * `resource` is usually specified as a path. For example, a Project
+   * resource is specified as `projects/{project}`.
    *
    * Completes with a [Policy].
    *
@@ -725,8 +793,9 @@ class ProjectsResourceApi {
    * Request parameters:
    *
    * [resource] - REQUIRED: The resource for which the policy detail is being
-   * requested. `resource` is usually specified as a path. For example, a
-   * Project resource is specified as `projects/{project}`.
+   * requested.
+   * `resource` is usually specified as a path. For example, a Project
+   * resource is specified as `projects/{project}`.
    *
    * Completes with a [TestIamPermissionsResponse].
    *
@@ -764,17 +833,21 @@ class ProjectsResourceApi {
   }
 
   /**
-   * Restores the Project identified by the specified `project_id` (for example,
-   * `my-project-123`). You can only use this method for a Project that has a
-   * lifecycle state of DELETE_REQUESTED. After deletion starts, the Project
-   * cannot be restored. The caller must have modify permissions for this
-   * Project.
+   * Restores the Project identified by the specified
+   * `project_id` (for example, `my-project-123`).
+   * You can only use this method for a Project that has a lifecycle state of
+   * DELETE_REQUESTED.
+   * After deletion starts, the Project cannot be restored.
+   *
+   * The caller must have modify permissions for this Project.
    *
    * [request] - The metadata request object.
    *
    * Request parameters:
    *
-   * [projectId] - The project ID (for example, `foo-bar-123`). Required.
+   * [projectId] - The project ID (for example, `foo-bar-123`).
+   *
+   * Required.
    *
    * Completes with a [Empty].
    *
@@ -813,14 +886,17 @@ class ProjectsResourceApi {
 
   /**
    * Updates the attributes of the Project identified by the specified
-   * `project_id` (for example, `my-project-123`). The caller must have modify
-   * permissions for this Project.
+   * `project_id` (for example, `my-project-123`).
+   *
+   * The caller must have modify permissions for this Project.
    *
    * [request] - The metadata request object.
    *
    * Request parameters:
    *
-   * [projectId] - The project ID (for example, `my-project-123`). Required.
+   * [projectId] - The project ID (for example, `my-project-123`).
+   *
+   * Required.
    *
    * Completes with a [Project].
    *
@@ -887,23 +963,32 @@ class Ancestor {
 class Binding {
   /**
    * Specifies the identities requesting access for a Cloud Platform resource.
-   * `members` can have the following values: * `allUsers`: A special identifier
-   * that represents anyone who is on the internet; with or without a Google
-   * account. * `allAuthenticatedUsers`: A special identifier that represents
-   * anyone who is authenticated with a Google account or a service account. *
-   * `user:{emailid}`: An email address that represents a specific Google
-   * account. For example, `alice@gmail.com` or `joe@example.com`. *
-   * `serviceAccount:{emailid}`: An email address that represents a service
-   * account. For example, `my-other-app@appspot.gserviceaccount.com`. *
-   * `group:{emailid}`: An email address that represents a Google group. For
-   * example, `admins@example.com`. * `domain:{domain}`: A Google Apps domain
-   * name that represents all the users of that domain. For example,
-   * `google.com` or `example.com`.
+   * `members` can have the following values:
+   *
+   * * `allUsers`: A special identifier that represents anyone who is
+   *    on the internet; with or without a Google account.
+   *
+   * * `allAuthenticatedUsers`: A special identifier that represents anyone
+   *    who is authenticated with a Google account or a service account.
+   *
+   * * `user:{emailid}`: An email address that represents a specific Google
+   *    account. For example, `alice@gmail.com` or `joe@example.com`.
+   *
+   *
+   * * `serviceAccount:{emailid}`: An email address that represents a service
+   *    account. For example, `my-other-app@appspot.gserviceaccount.com`.
+   *
+   * * `group:{emailid}`: An email address that represents a Google group.
+   *    For example, `admins@example.com`.
+   *
+   * * `domain:{domain}`: A Google Apps domain name that represents all the
+   *    users of that domain. For example, `google.com` or `example.com`.
    */
   core.List<core.String> members;
   /**
-   * Role that is assigned to `members`. For example, `roles/viewer`,
-   * `roles/editor`, or `roles/owner`. Required
+   * Role that is assigned to `members`.
+   * For example, `roles/viewer`, `roles/editor`, or `roles/owner`.
+   * Required
    */
   core.String role;
 
@@ -932,10 +1017,14 @@ class Binding {
 
 /**
  * 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 {
 
@@ -953,8 +1042,8 @@ class Empty {
 /** Metadata describing a long running folder operation */
 class FolderOperation {
   /**
-   * The resource name of the folder or organization we are either creating the
-   * folder under or moving the folder to.
+   * The resource name of the folder or organization we are either creating
+   * the folder under or moving the folder to.
    */
   core.String destinationParent;
   /** The display name of the folder. */
@@ -962,14 +1051,14 @@ class FolderOperation {
   /**
    * The type of this operation.
    * Possible string values are:
-   * - "OPERATION_TYPE_UNSPECIFIED" : A OPERATION_TYPE_UNSPECIFIED.
-   * - "CREATE" : A CREATE.
-   * - "MOVE" : A MOVE.
+   * - "OPERATION_TYPE_UNSPECIFIED" : Operation type not specified.
+   * - "CREATE" : A create folder operation.
+   * - "MOVE" : A move folder operation.
    */
   core.String operationType;
   /**
-   * The resource name of the folder's parent. Only applicable when the
-   * operation_type is MOVE.
+   * The resource name of the folder's parent.
+   * Only applicable when the operation_type is MOVE.
    */
   core.String sourceParent;
 
@@ -1013,15 +1102,24 @@ class FolderOperationError {
   /**
    * The type of operation error experienced.
    * Possible string values are:
-   * - "ERROR_TYPE_UNSPECIFIED" : A ERROR_TYPE_UNSPECIFIED.
-   * - "FOLDER_HEIGHT_VIOLATION" : A FOLDER_HEIGHT_VIOLATION.
-   * - "MAX_CHILD_FOLDERS_VIOLATION" : A MAX_CHILD_FOLDERS_VIOLATION.
-   * - "FOLDER_NAME_UNIQUENESS_VIOLATION" : A FOLDER_NAME_UNIQUENESS_VIOLATION.
-   * - "RESOURCE_DELETED" : A RESOURCE_DELETED.
-   * - "PARENT_DELETED" : A PARENT_DELETED.
-   * - "CYCLE_INTRODUCED_ERROR" : A CYCLE_INTRODUCED_ERROR.
-   * - "FOLDER_ALREADY_BEING_MOVED" : A FOLDER_ALREADY_BEING_MOVED.
-   * - "FOLDER_TO_DELETE_NON_EMPTY" : A FOLDER_TO_DELETE_NON_EMPTY.
+   * - "ERROR_TYPE_UNSPECIFIED" : The error type was unrecognized or
+   * unspecified.
+   * - "FOLDER_HEIGHT_VIOLATION" : The attempted action would violate the max
+   * folder depth constraint.
+   * - "MAX_CHILD_FOLDERS_VIOLATION" : The attempted action would violate the
+   * max child folders constraint.
+   * - "FOLDER_NAME_UNIQUENESS_VIOLATION" : The attempted action would violate
+   * the locally-unique folder
+   * display_name constraint.
+   * - "RESOURCE_DELETED" : The resource being moved has been deleted.
+   * - "PARENT_DELETED" : The resource a folder was being added to has been
+   * deleted.
+   * - "CYCLE_INTRODUCED_ERROR" : The attempted action would introduce cycle in
+   * resource path.
+   * - "FOLDER_ALREADY_BEING_MOVED" : The attempted action would move a folder
+   * that is already being moved.
+   * - "FOLDER_TO_DELETE_NON_EMPTY" : The folder the caller is trying to delete
+   * contains active resources.
    */
   core.String errorMessageId;
 
@@ -1042,7 +1140,11 @@ class FolderOperationError {
   }
 }
 
-/** The request sent to the GetAncestry method. */
+/**
+ * The request sent to the
+ * GetAncestry
+ * method.
+ */
 class GetAncestryRequest {
 
   GetAncestryRequest();
@@ -1135,24 +1237,32 @@ class ListOrganizationsResponse {
 }
 
 /**
- * A page of the response received from the ListProjects method. A paginated
- * response where more pages are available has `next_page_token` set. This token
- * can be used in a subsequent request to retrieve the next request page.
+ * A page of the response received from the
+ * ListProjects
+ * method.
+ *
+ * A paginated response where more pages are available has
+ * `next_page_token` set. This token can be used in a subsequent request to
+ * retrieve the next request page.
  */
 class ListProjectsResponse {
   /**
-   * Pagination token. If the result set is too large to fit in a single
-   * response, this token is returned. It encodes the position of the current
-   * result cursor. Feeding this value into a new list request with the
-   * `page_token` parameter gives the next page of the results. When
-   * `next_page_token` is not filled in, there is no next page and the list
-   * returned is the last page in the result set. Pagination tokens have a
-   * limited lifetime.
+   * Pagination token.
+   *
+   * If the result set is too large to fit in a single response, this token
+   * is returned. It encodes the position of the current result cursor.
+   * Feeding this value into a new list request with the `page_token` parameter
+   * gives the next page of the results.
+   *
+   * When `next_page_token` is not filled in, there is no next page and
+   * the list returned is the last page in the result set.
+   *
+   * Pagination tokens have a limited lifetime.
    */
   core.String nextPageToken;
   /**
-   * The list of Projects that matched the list filter. This list can be
-   * paginated.
+   * The list of Projects that matched the list filter. This list can
+   * be paginated.
    */
   core.List<Project> projects;
 
@@ -1180,8 +1290,8 @@ class ListProjectsResponse {
 }
 
 /**
- * The root node in the resource hierarchy to which a particular entity's (e.g.,
- * company) resources belong.
+ * The root node in the resource hierarchy to which a particular entity's
+ * (e.g., company) resources belong.
  */
 class Organization {
   /**
@@ -1192,16 +1302,19 @@ class Organization {
   /**
    * A friendly string to be used to refer to the Organization in the UI.
    * Assigned by the server, set to the firm name of the Google For Work
-   * customer that owns this organization. @OutputOnly
+   * customer that owns this organization.
+   * @OutputOnly
    */
   core.String displayName;
   /**
    * The organization's current lifecycle state. Assigned by the server.
    * @OutputOnly
    * Possible string values are:
-   * - "LIFECYCLE_STATE_UNSPECIFIED" : A LIFECYCLE_STATE_UNSPECIFIED.
-   * - "ACTIVE" : A ACTIVE.
-   * - "DELETE_REQUESTED" : A DELETE_REQUESTED.
+   * - "LIFECYCLE_STATE_UNSPECIFIED" : Unspecified state.  This is only useful
+   * for distinguishing unset values.
+   * - "ACTIVE" : The normal and active state.
+   * - "DELETE_REQUESTED" : The organization has been marked for deletion by the
+   * user.
    */
   core.String lifecycleState;
   /**
@@ -1212,14 +1325,15 @@ class Organization {
   core.String name;
   /**
    * An immutable id for the Organization that is assigned on creation. This
-   * should be omitted when creating a new Organization. This field is
-   * read-only. This field is deprecated and will be removed in v1. Use name
-   * instead.
+   * should be omitted when creating a new Organization.
+   * This field is read-only.
+   * This field is deprecated and will be removed in v1. Use name instead.
    */
   core.String organizationId;
   /**
-   * The owner of this Organization. The owner should be specified on creation.
-   * Once set, it cannot be changed. This field is required.
+   * The owner of this Organization. The owner should be specified on
+   * creation. Once set, it cannot be changed.
+   * This field is required.
    */
   OrganizationOwner owner;
 
@@ -1298,33 +1412,54 @@ class OrganizationOwner {
 }
 
 /**
- * Defines an Identity and Access Management (IAM) policy. It is used to specify
- * access control policies for Cloud Platform resources. A `Policy` consists of
- * a list of `bindings`. A `Binding` binds a list of `members` to a `role`,
- * where the members can be user accounts, Google groups, Google domains, and
- * service accounts. A `role` is a named list of permissions defined by IAM.
- * **Example** { "bindings": [ { "role": "roles/owner", "members": [
- * "user:mike@example.com", "group:admins@example.com", "domain:google.com",
- * "serviceAccount:my-other-app@appspot.gserviceaccount.com", ] }, { "role":
- * "roles/viewer", "members": ["user:sean@example.com"] } ] } For a description
- * of IAM and its features, see the [IAM developer's
- * guide](https://cloud.google.com/iam).
+ * Defines an Identity and Access Management (IAM) policy. It is used to
+ * specify access control policies for Cloud Platform resources.
+ *
+ *
+ * A `Policy` consists of a list of `bindings`. A `Binding` binds a list of
+ * `members` to a `role`, where the members can be user accounts, Google groups,
+ * Google domains, and service accounts. A `role` is a named list of permissions
+ * defined by IAM.
+ *
+ * **Example**
+ *
+ *     {
+ *       "bindings": [
+ *         {
+ *           "role": "roles/owner",
+ *           "members": [
+ *             "user:mike@example.com",
+ *             "group:admins@example.com",
+ *             "domain:google.com",
+ *             "serviceAccount:my-other-app@appspot.gserviceaccount.com",
+ *           ]
+ *         },
+ *         {
+ *           "role": "roles/viewer",
+ *           "members": ["user:sean@example.com"]
+ *         }
+ *       ]
+ *     }
+ *
+ * For a description of IAM and its features, see the
+ * [IAM developer's guide](https://cloud.google.com/iam).
  */
 class Policy {
   /**
-   * Associates a list of `members` to a `role`. Multiple `bindings` must not be
-   * specified for the same `role`. `bindings` with no members will result in an
-   * error.
+   * Associates a list of `members` to a `role`.
+   * Multiple `bindings` must not be specified for the same `role`.
+   * `bindings` with no members will result in an error.
    */
   core.List<Binding> bindings;
   /**
-   * `etag` is used for optimistic concurrency control as a way to help prevent
-   * simultaneous updates of a policy from overwriting each other. It is
-   * strongly suggested that systems make use of the `etag` in the
+   * `etag` is used for optimistic concurrency control as a way to help
+   * prevent simultaneous updates of a policy from overwriting each other.
+   * It is strongly suggested that systems make use of the `etag` in the
    * read-modify-write cycle to perform policy updates in order to avoid race
    * conditions: An `etag` is returned in the response to `getIamPolicy`, and
    * systems are expected to put that etag in the request to `setIamPolicy` to
    * ensure that their change will be applied to the same version of the policy.
+   *
    * If no `etag` is provided in the call to `setIamPolicy`, then the existing
    * policy is overwritten blindly.
    */
@@ -1369,52 +1504,89 @@ class Policy {
 }
 
 /**
- * A Project is a high-level Google Cloud Platform entity. It is a container for
- * ACLs, APIs, AppEngine Apps, VMs, and other Google Cloud Platform resources.
+ * A Project is a high-level Google Cloud Platform entity.  It is a
+ * container for ACLs, APIs, AppEngine Apps, VMs, and other
+ * Google Cloud Platform resources.
  */
 class Project {
-  /** Creation time. Read-only. */
+  /**
+   * Creation time.
+   *
+   * Read-only.
+   */
   core.String createTime;
   /**
-   * The labels associated with this Project. Label keys must be between 1 and
-   * 63 characters long and must conform to the following regular expression:
-   * \[a-z\](\[-a-z0-9\]*\[a-z0-9\])?. Label values must be between 0 and 63
-   * characters long and must conform to the regular expression
-   * (\[a-z\](\[-a-z0-9\]*\[a-z0-9\])?)?. No more than 256 labels can be
-   * associated with a given resource. Clients should store labels in a
-   * representation such as JSON that does not depend on specific characters
-   * being disallowed. Example: "environment" : "dev" Read-write.
+   * The labels associated with this Project.
+   *
+   * Label keys must be between 1 and 63 characters long and must conform
+   * to the following regular expression: \[a-z\](\[-a-z0-9\]*\[a-z0-9\])?.
+   *
+   * Label values must be between 0 and 63 characters long and must conform
+   * to the regular expression (\[a-z\](\[-a-z0-9\]*\[a-z0-9\])?)?.
+   *
+   * No more than 256 labels can be associated with a given resource.
+   *
+   * Clients should store labels in a representation such as JSON that does not
+   * depend on specific characters being disallowed.
+   *
+   * Example: <code>"environment" : "dev"</code>
+   *
+   * Read-write.
    */
   core.Map<core.String, core.String> labels;
   /**
-   * The Project lifecycle state. Read-only.
+   * The Project lifecycle state.
+   *
+   * Read-only.
    * Possible string values are:
-   * - "LIFECYCLE_STATE_UNSPECIFIED" : A LIFECYCLE_STATE_UNSPECIFIED.
-   * - "ACTIVE" : A ACTIVE.
-   * - "DELETE_REQUESTED" : A DELETE_REQUESTED.
-   * - "DELETE_IN_PROGRESS" : A DELETE_IN_PROGRESS.
+   * - "LIFECYCLE_STATE_UNSPECIFIED" : Unspecified state.  This is only
+   * used/useful for distinguishing
+   * unset values.
+   * - "ACTIVE" : The normal and active state.
+   * - "DELETE_REQUESTED" : The project has been marked for deletion by the user
+   * (by invoking DeleteProject)
+   * or by the system (Google Cloud Platform).
+   * This can generally be reversed by invoking UndeleteProject.
+   * - "DELETE_IN_PROGRESS" : This lifecycle state is no longer used and is not
+   * returned by the API.
    */
   core.String lifecycleState;
   /**
-   * The user-assigned display name of the Project. It must be 4 to 30
-   * characters. Allowed characters are: lowercase and uppercase letters,
-   * numbers, hyphen, single-quote, double-quote, space, and exclamation point.
-   * Example: My Project Read-write.
+   * The user-assigned display name of the Project.
+   * It must be 4 to 30 characters.
+   * Allowed characters are: lowercase and uppercase letters, numbers,
+   * hyphen, single-quote, double-quote, space, and exclamation point.
+   *
+   * Example: <code>My Project</code>
+   *
+   * Read-write.
    */
   core.String name;
   /**
-   * An optional reference to a parent Resource. The only supported parent type
-   * is "organization". Once set, the parent cannot be modified. Read-write.
+   * An optional reference to a parent Resource.
+   *
+   * The only supported parent type is "organization". Once set, the parent
+   * cannot be modified.
+   *
+   * Read-write.
    */
   ResourceId parent;
   /**
-   * The unique, user-assigned ID of the Project. It must be 6 to 30 lowercase
-   * letters, digits, or hyphens. It must start with a letter. Trailing hyphens
-   * are prohibited. Example: tokyo-rain-123 Read-only after creation.
+   * The unique, user-assigned ID of the Project.
+   * It must be 6 to 30 lowercase letters, digits, or hyphens.
+   * It must start with a letter.
+   * Trailing hyphens are prohibited.
+   *
+   * Example: <code>tokyo-rain-123</code>
+   *
+   * Read-only after creation.
    */
   core.String projectId;
   /**
-   * The number uniquely identifying the project. Example: 415104041262
+   * The number uniquely identifying the project.
+   *
+   * Example: <code>415104041262</code>
+   *
    * Read-only.
    */
   core.String projectNumber;
@@ -1521,8 +1693,8 @@ class ProjectCreationStatus {
 /**
  * A container to reference an id for any resource type. A `resource` in Google
  * Cloud Platform is a generic term for something you (a developer) may want to
- * interact with through one of our API's. Some examples are an AppEngine app, a
- * Compute Engine instance, a Cloud SQL database, and so on.
+ * interact with through one of our API's. Some examples are an AppEngine app,
+ * a Compute Engine instance, a Cloud SQL database, and so on.
  */
 class ResourceId {
   /**
@@ -1531,8 +1703,8 @@ class ResourceId {
    */
   core.String id;
   /**
-   * Required field representing the resource type this id is for. At present,
-   * the valid types are "project" and "organization".
+   * Required field representing the resource type this id is for.
+   * At present, the valid types are "project" and "organization".
    */
   core.String type;
 
@@ -1563,8 +1735,9 @@ class ResourceId {
 class SetIamPolicyRequest {
   /**
    * REQUIRED: The complete policy to be applied to the `resource`. The size of
-   * the policy is limited to a few 10s of KB. An empty policy is a valid policy
-   * but certain Cloud Platform services (such as Projects) might reject them.
+   * the policy is limited to a few 10s of KB. An empty policy is a
+   * valid policy but certain Cloud Platform services (such as Projects)
+   * might reject them.
    */
   Policy policy;
 
@@ -1590,8 +1763,8 @@ class TestIamPermissionsRequest {
   /**
    * The set of permissions to check for the `resource`. Permissions with
    * wildcards (such as '*' or 'storage.*') are not allowed. For more
-   * information see [IAM
-   * Overview](https://cloud.google.com/iam/docs/overview#permissions).
+   * information see
+   * [IAM Overview](https://cloud.google.com/iam/docs/overview#permissions).
    */
   core.List<core.String> permissions;
 
@@ -1637,7 +1810,10 @@ class TestIamPermissionsResponse {
   }
 }
 
-/** The request sent to the UndeleteProject method. */
+/**
+ * The request sent to the UndeleteProject
+ * method.
+ */
 class UndeleteProjectRequest {
 
   UndeleteProjectRequest();