google-api-client 0.44.2 → 0.46.2

data/generated/google/apis/cloudasset_v1.rb

@@ -25,7 +25,7 @@ module Google
     # @see https://cloud.google.com/asset-inventory/docs/quickstart
     module CloudassetV1
       VERSION = 'V1'
-      REVISION = '20200828'
+      REVISION = '20200911'
 
       # View and manage your data across Google Cloud Platform services
       AUTH_CLOUD_PLATFORM = 'https://www.googleapis.com/auth/cloud-platform'

data/generated/google/apis/cloudasset_v1/classes.rb

@@ -264,6 +264,37 @@ module Google
         attr_accessor :force
         alias_method :force?, :force
       
+        # Specifications of BigQuery partitioned table as export destination.
+        # Corresponds to the JSON property `partitionSpec`
+        # @return [Google::Apis::CloudassetV1::PartitionSpec]
+        attr_accessor :partition_spec
+      
+        # If this flag is `TRUE`, the snapshot results will be written to one or
+        # multiple tables, each of which contains results of one asset type. The [force]
+        # and [partition_spec] fields will apply to each of them. Field [table] will be
+        # concatenated with "_" and the asset type names (see https://cloud.google.com/
+        # asset-inventory/docs/supported-asset-types for supported asset types) to
+        # construct per-asset-type table names, in which all non-alphanumeric characters
+        # like "." and "/" will be substituted by "_". Example: if field [table] is "
+        # mytable" and snapshot results contain "storage.googleapis.com/Bucket" assets,
+        # the corresponding table name will be "mytable_storage_googleapis_com_Bucket".
+        # If any of these tables does not exist, a new table with the concatenated name
+        # will be created. When [content_type] in the ExportAssetsRequest is `RESOURCE`,
+        # the schema of each table will include RECORD-type columns mapped to the nested
+        # fields in the Asset.resource.data field of that asset type (up to the 15
+        # nested level BigQuery supports (https://cloud.google.com/bigquery/docs/nested-
+        # repeated#limitations)). The fields in >15 nested levels will be stored in JSON
+        # format string as a child column of its parent RECORD column. If error occurs
+        # when exporting to any table, the whole export call will return an error but
+        # the export results that already succeed will persist. Example: if exporting to
+        # table_type_A succeeds when exporting to table_type_B fails during one export
+        # call, the results in table_type_A will persist and there will not be partial
+        # results persisting in a table.
+        # Corresponds to the JSON property `separateTablesPerAssetType`
+        # @return [Boolean]
+        attr_accessor :separate_tables_per_asset_type
+        alias_method :separate_tables_per_asset_type?, :separate_tables_per_asset_type
+      
         # Required. The BigQuery table to which the snapshot result should be written.
         # If this table does not exist, a new table with the given name will be created.
         # Corresponds to the JSON property `table`
@@ -278,6 +309,8 @@ module Google
         def update!(**args)
           @dataset = args[:dataset] if args.key?(:dataset)
           @force = args[:force] if args.key?(:force)
+          @partition_spec = args[:partition_spec] if args.key?(:partition_spec)
+          @separate_tables_per_asset_type = args[:separate_tables_per_asset_type] if args.key?(:separate_tables_per_asset_type)
           @table = args[:table] if args.key?(:table)
         end
       end
@@ -1610,6 +1643,25 @@ module Google
         end
       end
       
+      # Specifications of BigQuery partitioned table as export destination.
+      class PartitionSpec
+        include Google::Apis::Core::Hashable
+      
+        # The partition key for BigQuery partitioned table.
+        # Corresponds to the JSON property `partitionKey`
+        # @return [String]
+        attr_accessor :partition_key
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @partition_key = args[:partition_key] if args.key?(:partition_key)
+        end
+      end
+      
       # IAM permissions
       class Permissions
         include Google::Apis::Core::Hashable

data/generated/google/apis/cloudasset_v1/representations.rb

@@ -214,6 +214,12 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class PartitionSpec
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class Permissions
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -332,6 +338,9 @@ module Google
         class Representation < Google::Apis::Core::JsonRepresentation
           property :dataset, as: 'dataset'
           property :force, as: 'force'
+          property :partition_spec, as: 'partitionSpec', class: Google::Apis::CloudassetV1::PartitionSpec, decorator: Google::Apis::CloudassetV1::PartitionSpec::Representation
+      
+          property :separate_tables_per_asset_type, as: 'separateTablesPerAssetType'
           property :table, as: 'table'
         end
       end
@@ -611,6 +620,13 @@ module Google
         end
       end
       
+      class PartitionSpec
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :partition_key, as: 'partitionKey'
+        end
+      end
+      
       class Permissions
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation

data/generated/google/apis/cloudasset_v1p4beta1.rb

@@ -25,7 +25,7 @@ module Google
     # @see https://cloud.google.com/asset-inventory/docs/quickstart
     module CloudassetV1p4beta1
       VERSION = 'V1p4beta1'
-      REVISION = '20200814'
+      REVISION = '20201003'
 
       # View and manage your data across Google Cloud Platform services
       AUTH_CLOUD_PLATFORM = 'https://www.googleapis.com/auth/cloud-platform'

data/generated/google/apis/cloudasset_v1p4beta1/classes.rb

@@ -25,7 +25,8 @@ module Google
       # Specifies roles and/or permissions to analyze, to determine both the
       # identities possessing them and the resources they control. If multiple values
       # are specified, results will include identities and resources matching any of
-      # them.
+      # them. The total number of roles and permissions should be equal or less than
+      # 10.
       class AccessSelector
         include Google::Apis::Core::Hashable
       
@@ -253,9 +254,9 @@ module Google
         include Google::Apis::Core::Hashable
       
         # Required. The uri of the Cloud Storage object. It's the same uri that is used
-        # by gsutil. For example: "gs://bucket_name/object_name". See [Viewing and
-        # Editing Object Metadata](https://cloud.google.com/storage/docs/viewing-editing-
-        # metadata) for more information.
+        # by gsutil. For example: "gs://bucket_name/object_name". See [Quickstart: Using
+        # the gsutil tool] (https://cloud.google.com/storage/docs/quickstart-gsutil) for
+        # examples.
         # Corresponds to the JSON property `uri`
         # @return [String]
         attr_accessor :uri
@@ -551,7 +552,8 @@ module Google
         # Specifies roles and/or permissions to analyze, to determine both the
         # identities possessing them and the resources they control. If multiple values
         # are specified, results will include identities and resources matching any of
-        # them.
+        # them. The total number of roles and permissions should be equal or less than
+        # 10.
         # Corresponds to the JSON property `accessSelector`
         # @return [Google::Apis::CloudassetV1p4beta1::AccessSelector]
         attr_accessor :access_selector

data/generated/google/apis/cloudbilling_v1.rb

@@ -26,7 +26,7 @@ module Google
     # @see https://cloud.google.com/billing/
     module CloudbillingV1
       VERSION = 'V1'
-      REVISION = '20200821'
+      REVISION = '20200912'
 
       # View and manage your Google Cloud Platform billing accounts
       AUTH_CLOUD_BILLING = 'https://www.googleapis.com/auth/cloud-billing'

data/generated/google/apis/cloudbilling_v1/classes.rb

@@ -143,10 +143,10 @@ module Google
         # @return [String]
         attr_accessor :master_billing_account
       
-        # 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`.
+        # Output only. 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`.
         # Corresponds to the JSON property `name`
         # @return [String]
         attr_accessor :name

data/generated/google/apis/cloudbuild_v1.rb

@@ -25,7 +25,7 @@ module Google
     # @see https://cloud.google.com/cloud-build/docs/
     module CloudbuildV1
       VERSION = 'V1'
-      REVISION = '20200910'
+      REVISION = '20200921'
 
       # View and manage your data across Google Cloud Platform services
       AUTH_CLOUD_PLATFORM = 'https://www.googleapis.com/auth/cloud-platform'

data/generated/google/apis/cloudbuild_v1/classes.rb

@@ -767,40 +767,6 @@ module Google
         end
       end
       
-      # Request to create a new build.
-      class CreateBuildRequest
-        include Google::Apis::Core::Hashable
-      
-        # A build resource in the Cloud Build API. At a high level, a `Build` describes
-        # where to find source code, how to build it (for example, the builder image to
-        # run on the source), and where to store the built artifacts. Fields can include
-        # the following variables, which will be expanded when the build is created: - $
-        # PROJECT_ID: the project ID of the build. - $BUILD_ID: the autogenerated ID of
-        # the build. - $REPO_NAME: the source repository name specified by RepoSource. -
-        # $BRANCH_NAME: the branch name specified by RepoSource. - $TAG_NAME: the tag
-        # name specified by RepoSource. - $REVISION_ID or $COMMIT_SHA: the commit SHA
-        # specified by RepoSource or resolved from the specified branch or tag. - $
-        # SHORT_SHA: first 7 characters of $REVISION_ID or $COMMIT_SHA.
-        # Corresponds to the JSON property `build`
-        # @return [Google::Apis::CloudbuildV1::Build]
-        attr_accessor :build
-      
-        # Required. ID of the project.
-        # Corresponds to the JSON property `projectId`
-        # @return [String]
-        attr_accessor :project_id
-      
-        def initialize(**args)
-           update!(**args)
-        end
-      
-        # Update properties of this object
-        def update!(**args)
-          @build = args[:build] if args.key?(:build)
-          @project_id = args[:project_id] if args.key?(:project_id)
-        end
-      end
-      
       # 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.

data/generated/google/apis/cloudbuild_v1/representations.rb

@@ -88,12 +88,6 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
-      class CreateBuildRequest
-        class Representation < Google::Apis::Core::JsonRepresentation; end
-      
-        include Google::Apis::Core::JsonObjectSupport
-      end
-      
       class Empty
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -425,15 +419,6 @@ module Google
         end
       end
       
-      class CreateBuildRequest
-        # @private
-        class Representation < Google::Apis::Core::JsonRepresentation
-          property :build, as: 'build', class: Google::Apis::CloudbuildV1::Build, decorator: Google::Apis::CloudbuildV1::Build::Representation
-      
-          property :project_id, as: 'projectId'
-        end
-      end
-      
       class Empty
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation

data/generated/google/apis/cloudbuild_v1/service.rb

@@ -367,7 +367,9 @@ module Google
         # @param [String] parent
         #   The parent resource where this build will be created. Format: `projects/`
         #   project`/locations/`location``
-        # @param [Google::Apis::CloudbuildV1::CreateBuildRequest] create_build_request_object
+        # @param [Google::Apis::CloudbuildV1::Build] build_object
+        # @param [String] project_id
+        #   Required. ID of the project.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -385,13 +387,14 @@ module Google
         # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
         # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
         # @raise [Google::Apis::AuthorizationError] Authorization is required
-        def create_build(parent, create_build_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
+        def create_build(parent, build_object = nil, project_id: nil, fields: nil, quota_user: nil, options: nil, &block)
           command = make_simple_command(:post, 'v1/{+parent}/builds', options)
-          command.request_representation = Google::Apis::CloudbuildV1::CreateBuildRequest::Representation
-          command.request_object = create_build_request_object
+          command.request_representation = Google::Apis::CloudbuildV1::Build::Representation
+          command.request_object = build_object
           command.response_representation = Google::Apis::CloudbuildV1::Operation::Representation
           command.response_class = Google::Apis::CloudbuildV1::Operation
           command.params['parent'] = parent unless parent.nil?
+          command.query['projectId'] = project_id unless project_id.nil?
           command.query['fields'] = fields unless fields.nil?
           command.query['quotaUser'] = quota_user unless quota_user.nil?
           execute_or_queue_command(command, &block)

data/generated/google/apis/cloudfunctions_v1.rb

@@ -25,7 +25,7 @@ module Google
     # @see https://cloud.google.com/functions
     module CloudfunctionsV1
       VERSION = 'V1'
-      REVISION = '20200806'
+      REVISION = '20200917'
 
       # View and manage your data across Google Cloud Platform services
       AUTH_CLOUD_PLATFORM = 'https://www.googleapis.com/auth/cloud-platform'

data/generated/google/apis/cloudfunctions_v1/classes.rb

@@ -226,6 +226,11 @@ module Google
         # @return [Fixnum]
         attr_accessor :available_memory_mb
       
+        # Build environment variables that shall be available during build time.
+        # Corresponds to the JSON property `buildEnvironmentVariables`
+        # @return [Hash<String,String>]
+        attr_accessor :build_environment_variables
+      
         # Output only. The Cloud Build ID of the latest successful deployment of the
         # function.
         # Corresponds to the JSON property `buildId`
@@ -272,7 +277,12 @@ module Google
         attr_accessor :labels
       
         # The limit on the maximum number of function instances that may coexist at a
-        # given time.
+        # given time. In some cases, such as rapid traffic surges, Cloud Functions may,
+        # for a short period of time, create more instances than the specified max
+        # instances limit. If your function cannot tolerate this temporary behavior, you
+        # may want to factor in a safety margin and set a lower max instances value than
+        # your function can tolerate. See the [Max Instances](https://cloud.google.com/
+        # functions/docs/max-instances) Guide for more details.
         # Corresponds to the JSON property `maxInstances`
         # @return [Fixnum]
         attr_accessor :max_instances
@@ -375,6 +385,7 @@ module Google
         # Update properties of this object
         def update!(**args)
           @available_memory_mb = args[:available_memory_mb] if args.key?(:available_memory_mb)
+          @build_environment_variables = args[:build_environment_variables] if args.key?(:build_environment_variables)
           @build_id = args[:build_id] if args.key?(:build_id)
           @description = args[:description] if args.key?(:description)
           @entry_point = args[:entry_point] if args.key?(:entry_point)

data/generated/google/apis/cloudfunctions_v1/representations.rb

@@ -231,6 +231,7 @@ module Google
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
           property :available_memory_mb, as: 'availableMemoryMb'
+          hash :build_environment_variables, as: 'buildEnvironmentVariables'
           property :build_id, as: 'buildId'
           property :description, as: 'description'
           property :entry_point, as: 'entryPoint'

data/generated/google/apis/cloudidentity_v1.rb

@@ -25,7 +25,7 @@ module Google
     # @see https://cloud.google.com/identity/
     module CloudidentityV1
       VERSION = 'V1'
-      REVISION = '20200908'
+      REVISION = '20200927'
 
       # See your device details
       AUTH_CLOUD_IDENTITY_DEVICES_LOOKUP = 'https://www.googleapis.com/auth/cloud-identity.devices.lookup'

data/generated/google/apis/cloudidentity_v1/classes.rb

@@ -22,22 +22,26 @@ module Google
   module Apis
     module CloudidentityV1
       
-      # An EntityKey uniquely identifies an Entity. Namespaces are used to provide
-      # isolation for IDs. A single ID can be reused across namespaces but the
-      # combination of a namespace and an ID must be unique.
+      # A unique identifier for an entity in the Cloud Identity Groups API. An entity
+      # can represent either a group with an optional `namespace` or a user without a `
+      # namespace`. The combination of `id` and `namespace` must be unique; however,
+      # the same `id` can be used with different `namespace`s.
       class EntityKey
         include Google::Apis::Core::Hashable
       
-        # The ID of the entity within the given namespace. The ID must be unique within
-        # its namespace.
+        # The ID of the entity. For Google-managed entities, the `id` should be the
+        # email address of an existing group or user. For external-identity-mapped
+        # entities, the `id` must be a string conforming to the Identity Source's
+        # requirements. Must be unique within a `namespace`.
         # Corresponds to the JSON property `id`
         # @return [String]
         attr_accessor :id
       
-        # Namespaces provide isolation for IDs, so an ID only needs to be unique within
-        # its namespace. Namespaces are currently only created as part of IdentitySource
-        # creation from Admin Console. A namespace `"identitysources/`identity_source_id`
-        # "` is created corresponding to every Identity Source `identity_source_id`.
+        # The namespace in which the entity exists. If not specified, the `EntityKey`
+        # represents a Google-managed entity such as a Google user or a Google Group. If
+        # specified, the `EntityKey` represents an external-identity-mapped group. The
+        # namespace must correspond to an identity source created in Admin Console and
+        # must be in the form of `identitysources/`identity_source_id`.
         # Corresponds to the JSON property `namespace`
         # @return [String]
         attr_accessor :namespace
@@ -875,58 +879,66 @@ module Google
         end
       end
       
-      # Resource representing a Group.
+      # A group within the Cloud Identity Groups API. A `Group` is a collection of
+      # entities, where each entity is either a user, another group, or a service
+      # account.
       class Group
         include Google::Apis::Core::Hashable
       
-        # Output only. The time when the Group was created. Output only.
+        # Output only. The time when the `Group` was created.
         # Corresponds to the JSON property `createTime`
         # @return [String]
         attr_accessor :create_time
       
-        # An extended description to help users determine the purpose of a Group. For
-        # example, you can include information about who should join the Group, the
-        # types of messages to send to the Group, links to FAQs about the Group, or
-        # related Groups. Maximum length is 4,096 characters.
+        # An extended description to help users determine the purpose of a `Group`. Must
+        # not be longer than 4,096 characters.
         # Corresponds to the JSON property `description`
         # @return [String]
         attr_accessor :description
       
-        # The Group's display name.
+        # The display name of the `Group`.
         # Corresponds to the JSON property `displayName`
         # @return [String]
         attr_accessor :display_name
       
-        # An EntityKey uniquely identifies an Entity. Namespaces are used to provide
-        # isolation for IDs. A single ID can be reused across namespaces but the
-        # combination of a namespace and an ID must be unique.
+        # A unique identifier for an entity in the Cloud Identity Groups API. An entity
+        # can represent either a group with an optional `namespace` or a user without a `
+        # namespace`. The combination of `id` and `namespace` must be unique; however,
+        # the same `id` can be used with different `namespace`s.
         # Corresponds to the JSON property `groupKey`
         # @return [Google::Apis::CloudidentityV1::EntityKey]
         attr_accessor :group_key
       
-        # Required. `Required`. Labels for Group resource. For creating Groups under a
-        # namespace, set label key to 'labels/system/groups/external' and label value as
-        # empty.
+        # Required. One or more label entries that apply to the Group. Currently
+        # supported labels contain a key with an empty value. Google Groups are the
+        # default type of group and have a label with a key of `cloudidentity.googleapis.
+        # com/groups.discussion_forum` and an empty value. Existing Google Groups can
+        # have an additional label with a key of `cloudidentity.googleapis.com/groups.
+        # security` and an empty value added to them. **This is an immutable change and
+        # the security label cannot be removed once added.** Dynamic groups have a label
+        # with a key of `cloudidentity.googleapis.com/groups.dynamic`. Identity-mapped
+        # groups for Cloud Search have a label with a key of `system/groups/external`
+        # and an empty value. Examples: `"cloudidentity.googleapis.com/groups.
+        # discussion_forum": ""` or `"system/groups/external": ""`.
         # Corresponds to the JSON property `labels`
         # @return [Hash<String,String>]
         attr_accessor :labels
       
-        # Output only. [Resource name](https://cloud.google.com/apis/design/
-        # resource_names) of the Group in the format: `groups/`group_id``, where
-        # group_id is the unique ID assigned to the Group. Must be left blank while
-        # creating a Group.
+        # Output only. The [resource name](https://cloud.google.com/apis/design/
+        # resource_names) of the `Group`. Shall be of the form `groups/`group_id``.
         # Corresponds to the JSON property `name`
         # @return [String]
         attr_accessor :name
       
-        # Required. Immutable. The entity under which this Group resides in Cloud
-        # Identity resource hierarchy. Must be set when creating a Group, read-only
-        # afterwards. Currently allowed types: `identitysources`.
+        # Required. Immutable. The resource name of the entity under which this `Group`
+        # resides in the Cloud Identity resource hierarchy. Must be of the form `
+        # identitysources/`identity_source_id`` for external- identity-mapped groups or `
+        # customers/`customer_id`` for Google Groups.
         # Corresponds to the JSON property `parent`
         # @return [String]
         attr_accessor :parent
       
-        # Output only. The time when the Group was last updated. Output only.
+        # Output only. The time when the `Group` was last updated.
         # Corresponds to the JSON property `updateTime`
         # @return [String]
         attr_accessor :update_time
@@ -974,17 +986,17 @@ module Google
         end
       end
       
-      # 
+      # The response message for MembershipsService.ListMemberships.
       class ListMembershipsResponse
         include Google::Apis::Core::Hashable
       
-        # List of Memberships.
+        # The `Membership`s under the specified `parent`.
         # Corresponds to the JSON property `memberships`
         # @return [Array<Google::Apis::CloudidentityV1::Membership>]
         attr_accessor :memberships
       
-        # Token to retrieve the next page of results, or empty if there are no more
-        # results available for listing.
+        # A continuation token to retrieve the next page of results, or empty if there
+        # are no more results available.
         # Corresponds to the JSON property `nextPageToken`
         # @return [String]
         attr_accessor :next_page_token
@@ -1000,13 +1012,12 @@ module Google
         end
       end
       
-      # 
+      # The response message for GroupsService.LookupGroupName.
       class LookupGroupNameResponse
         include Google::Apis::Core::Hashable
       
-        # [Resource name](https://cloud.google.com/apis/design/resource_names) of the
-        # Group in the format: `groups/`group_id``, where `group_id` is the unique ID
-        # assigned to the Group.
+        # The [resource name](https://cloud.google.com/apis/design/resource_names) of
+        # the looked-up `Group`.
         # Corresponds to the JSON property `name`
         # @return [String]
         attr_accessor :name
@@ -1021,14 +1032,13 @@ module Google
         end
       end
       
-      # 
+      # The response message for MembershipsService.LookupMembershipName.
       class LookupMembershipNameResponse
         include Google::Apis::Core::Hashable
       
-        # [Resource name](https://cloud.google.com/apis/design/resource_names) of the
-        # Membership being looked up. Format: `groups/`group_id`/memberships/`member_id``
-        # , where `group_id` is the unique ID assigned to the Group to which Membership
-        # belongs to, and `member_id` is the unique ID assigned to the member.
+        # The [resource name](https://cloud.google.com/apis/design/resource_names) of
+        # the looked-up `Membership`. Must be of the form `groups/`group_id`/memberships/
+        # `membership_id``.
         # Corresponds to the JSON property `name`
         # @return [String]
         attr_accessor :name
@@ -1043,33 +1053,35 @@ module Google
         end
       end
       
-      # Resource representing a Membership within a Group
+      # A membership within the Cloud Identity Groups API. A `Membership` defines a
+      # relationship between a `Group` and an entity belonging to that `Group`,
+      # referred to as a "member".
       class Membership
         include Google::Apis::Core::Hashable
       
-        # Output only. Creation timestamp of the Membership. Output only.
+        # Output only. The time when the `Membership` was created.
         # Corresponds to the JSON property `createTime`
         # @return [String]
         attr_accessor :create_time
       
-        # Output only. [Resource name](https://cloud.google.com/apis/design/
-        # resource_names) of the Membership in the format: `groups/`group_id`/
-        # memberships/`member_id``, where group_id is the unique ID assigned to the
-        # Group to which Membership belongs to, and member_id is the unique ID assigned
-        # to the member Must be left blank while creating a Membership.
+        # Output only. The [resource name](https://cloud.google.com/apis/design/
+        # resource_names) of the `Membership`. Shall be of the form `groups/`group_id`/
+        # memberships/`membership_id``.
         # Corresponds to the JSON property `name`
         # @return [String]
         attr_accessor :name
       
-        # An EntityKey uniquely identifies an Entity. Namespaces are used to provide
-        # isolation for IDs. A single ID can be reused across namespaces but the
-        # combination of a namespace and an ID must be unique.
+        # A unique identifier for an entity in the Cloud Identity Groups API. An entity
+        # can represent either a group with an optional `namespace` or a user without a `
+        # namespace`. The combination of `id` and `namespace` must be unique; however,
+        # the same `id` can be used with different `namespace`s.
         # Corresponds to the JSON property `preferredMemberKey`
         # @return [Google::Apis::CloudidentityV1::EntityKey]
         attr_accessor :preferred_member_key
       
-        # Roles for a member within the Group. Currently supported MembershipRoles: `"
-        # MEMBER"`.
+        # The `MembershipRole`s that apply to the `Membership`. If unspecified, defaults
+        # to a single `MembershipRole` with `name` `MEMBER`. Must not contain duplicate `
+        # MembershipRole`s with the same `name`.
         # Corresponds to the JSON property `roles`
         # @return [Array<Google::Apis::CloudidentityV1::MembershipRole>]
         attr_accessor :roles
@@ -1079,7 +1091,7 @@ module Google
         # @return [String]
         attr_accessor :type
       
-        # Output only. Last updated timestamp of the Membership. Output only.
+        # Output only. The time when the `Membership` was last updated.
         # Corresponds to the JSON property `updateTime`
         # @return [String]
         attr_accessor :update_time
@@ -1099,12 +1111,12 @@ module Google
         end
       end
       
-      # Resource representing a role within a Membership.
+      # A membership role within the Cloud Identity Groups API. A `MembershipRole`
+      # defines the privileges granted to a `Membership`.
       class MembershipRole
         include Google::Apis::Core::Hashable
       
-        # MembershipRole in string format. Currently supported MembershipRoles: `"MEMBER"
-        # `.
+        # The name of the `MembershipRole`. Must be one of `OWNER`, `MANAGER`, `MEMBER`.
         # Corresponds to the JSON property `name`
         # @return [String]
         attr_accessor :name
@@ -1119,6 +1131,58 @@ module Google
         end
       end
       
+      # The request message for MembershipsService.ModifyMembershipRoles.
+      class ModifyMembershipRolesRequest
+        include Google::Apis::Core::Hashable
+      
+        # The `MembershipRole`s to be added. Adding or removing roles in the same
+        # request as updating roles is not supported. Must not be set if `
+        # update_roles_params` is set.
+        # Corresponds to the JSON property `addRoles`
+        # @return [Array<Google::Apis::CloudidentityV1::MembershipRole>]
+        attr_accessor :add_roles
+      
+        # The `name`s of the `MembershipRole`s to be removed. Adding or removing roles
+        # in the same request as updating roles is not supported. It is not possible to
+        # remove the `MEMBER` `MembershipRole`. If you wish to delete a `Membership`,
+        # call MembershipsService.DeleteMembership instead. Must not contain `MEMBER`.
+        # Must not be set if `update_roles_params` is set.
+        # Corresponds to the JSON property `removeRoles`
+        # @return [Array<String>]
+        attr_accessor :remove_roles
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @add_roles = args[:add_roles] if args.key?(:add_roles)
+          @remove_roles = args[:remove_roles] if args.key?(:remove_roles)
+        end
+      end
+      
+      # The response message for MembershipsService.ModifyMembershipRoles.
+      class ModifyMembershipRolesResponse
+        include Google::Apis::Core::Hashable
+      
+        # A membership within the Cloud Identity Groups API. A `Membership` defines a
+        # relationship between a `Group` and an entity belonging to that `Group`,
+        # referred to as a "member".
+        # Corresponds to the JSON property `membership`
+        # @return [Google::Apis::CloudidentityV1::Membership]
+        attr_accessor :membership
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @membership = args[:membership] if args.key?(:membership)
+        end
+      end
+      
       # This resource represents a long-running operation that is the result of a
       # network API call.
       class Operation
@@ -1181,17 +1245,17 @@ module Google
         end
       end
       
-      # 
+      # The response message for GroupsService.SearchGroups.
       class SearchGroupsResponse
         include Google::Apis::Core::Hashable
       
-        # List of Groups satisfying the search query.
+        # The `Group`s that match the search query.
         # Corresponds to the JSON property `groups`
         # @return [Array<Google::Apis::CloudidentityV1::Group>]
         attr_accessor :groups
       
-        # Token to retrieve the next page of results, or empty if there are no more
-        # results available for specified query.
+        # A continuation token to retrieve the next page of results, or empty if there
+        # are no more results available.
         # Corresponds to the JSON property `nextPageToken`
         # @return [String]
         attr_accessor :next_page_token