google-api-client 0.45.1 → 0.48.0

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 = '20200911'
+      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

@@ -254,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

data/generated/google/apis/cloudbilling_v1.rb

@@ -26,7 +26,7 @@ module Google
     # @see https://cloud.google.com/billing/
     module CloudbillingV1
       VERSION = 'V1'
-      REVISION = '20200912'
+      REVISION = '20201017'
 
       # 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

@@ -477,7 +477,7 @@ module Google
       class Money
         include Google::Apis::Core::Hashable
       
-        # The 3-letter currency code defined in ISO 4217.
+        # The three-letter currency code defined in ISO 4217.
         # Corresponds to the JSON property `currencyCode`
         # @return [String]
         attr_accessor :currency_code

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 = '20200921'
+      REVISION = '20201015'
 
       # 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

@@ -929,7 +929,8 @@ module Google
         # @return [Array<Google::Apis::CloudbuildV1::Build>]
         attr_accessor :builds
       
-        # Token to receive the next page of results.
+        # Token to receive the next page of results. This will be absent if the end of
+        # the response list has been reached.
         # Corresponds to the JSON property `nextPageToken`
         # @return [String]
         attr_accessor :next_page_token

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

@@ -241,7 +241,11 @@ module Google
         # @param [Fixnum] page_size
         #   Number of results to return in the list.
         # @param [String] page_token
-        #   Token to provide to skip to a particular spot in the list.
+        #   The page token for the next page of Builds. If unspecified, the first page of
+        #   results is returned. If the token is rejected for any reason, INVALID_ARGUMENT
+        #   will be thrown. In this case, the token should be discarded, and pagination
+        #   should be restarted from the first page of results. See https://google.aip.dev/
+        #   158 for more.
         # @param [String] parent
         #   The parent of the collection of `Builds`. Format: `projects/`project`/
         #   locations/location`
@@ -449,7 +453,11 @@ module Google
         # @param [Fixnum] page_size
         #   Number of results to return in the list.
         # @param [String] page_token
-        #   Token to provide to skip to a particular spot in the list.
+        #   The page token for the next page of Builds. If unspecified, the first page of
+        #   results is returned. If the token is rejected for any reason, INVALID_ARGUMENT
+        #   will be thrown. In this case, the token should be discarded, and pagination
+        #   should be restarted from the first page of results. See https://google.aip.dev/
+        #   158 for more.
         # @param [String] project_id
         #   Required. ID of the project.
         # @param [String] fields

data/generated/google/apis/cloudidentity_v1.rb

@@ -25,7 +25,7 @@ module Google
     # @see https://cloud.google.com/identity/
     module CloudidentityV1
       VERSION = 'V1'
-      REVISION = '20200919'
+      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
@@ -1154,7 +1166,9 @@ module Google
       class ModifyMembershipRolesResponse
         include Google::Apis::Core::Hashable
       
-        # 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".
         # Corresponds to the JSON property `membership`
         # @return [Google::Apis::CloudidentityV1::Membership]
         attr_accessor :membership
@@ -1231,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

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

@@ -839,11 +839,11 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Deletes a Group.
+        # Deletes a `Group`.
         # @param [String] name
-        #   Required. [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.
+        #   Required. The [resource name](https://cloud.google.com/apis/design/
+        #   resource_names) of the `Group` to retrieve. Must be of the form `groups/`
+        #   group_id``.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -871,11 +871,11 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Retrieves a Group.
+        # Retrieves a `Group`.
         # @param [String] name
-        #   Required. [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.
+        #   Required. The [resource name](https://cloud.google.com/apis/design/
+        #   resource_names) of the `Group` to retrieve. Must be of the form `groups/`
+        #   group_id``.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -903,16 +903,22 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Lists groups within a customer or a domain.
+        # Lists the `Group`s under a customer or namespace.
         # @param [Fixnum] page_size
-        #   The default page size is 200 (max 1000) for the BASIC view, and 50 (max 500)
-        #   for the FULL view.
+        #   The maximum number of results to return. Note that the number of results
+        #   returned may be less than this value even if there are more available results.
+        #   To fetch all results, clients must continue calling this method repeatedly
+        #   until the response no longer contains a `next_page_token`. If unspecified,
+        #   defaults to 200 for `View.BASIC` and to 50 for `View.FULL`. Must not be
+        #   greater than 1000 for `View.BASIC` or 500 for `View.FULL`.
         # @param [String] page_token
-        #   The next_page_token value returned from a previous list request, if any.
+        #   The `next_page_token` value returned from a previous list request, if any.
         # @param [String] parent
-        #   Required. Customer ID to list all groups from.
+        #   Required. The parent resource under which to list all `Group`s. Must be of the
+        #   form `identitysources/`identity_source_id`` for external- identity-mapped
+        #   groups or `customers/`customer_id`` for Google Groups.
         # @param [String] view
-        #   Group resource view to be returned. Defaults to [View.BASIC]().
+        #   The level of detail to be returned. If unspecified, defaults to `View.BASIC`.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -943,16 +949,19 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Looks up [resource name](https://cloud.google.com/apis/design/resource_names)
-        # of a Group by its EntityKey.
+        # Looks up the [resource name](https://cloud.google.com/apis/design/
+        # resource_names) of a `Group` by its `EntityKey`.
         # @param [String] group_key_id
-        #   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`.
         # @param [String] group_key_namespace
-        #   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`.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -981,15 +990,14 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Updates a Group.
+        # Updates a `Group`.
         # @param [String] name
-        #   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``.
         # @param [Google::Apis::CloudidentityV1::Group] group_object
         # @param [String] update_mask
-        #   Required. Editable fields: `display_name`, `description`
+        #   Required. The fully-qualified names of fields to update. May only contain the
+        #   following fields: `display_name`, `description`.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -1020,18 +1028,24 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Searches for Groups.
+        # Searches for `Group`s matching a specified query.
         # @param [Fixnum] page_size
-        #   The default page size is 200 (max 1000) for the BASIC view, and 50 (max 500)
-        #   for the FULL view.
+        #   The maximum number of results to return. Note that the number of results
+        #   returned may be less than this value even if there are more available results.
+        #   To fetch all results, clients must continue calling this method repeatedly
+        #   until the response no longer contains a `next_page_token`. If unspecified,
+        #   defaults to 200 for `GroupView.BASIC` and 50 for `GroupView.FULL`. Must not be
+        #   greater than 1000 for `GroupView.BASIC` or 500 for `GroupView.FULL`.
         # @param [String] page_token
-        #   The next_page_token value returned from a previous search request, if any.
+        #   The `next_page_token` value returned from a previous search request, if any.
         # @param [String] query
-        #   Required. `Required`. Query string for performing search on groups. Users can
-        #   search on parent and label attributes of groups. EXACT match ('==') is
-        #   supported on parent, and CONTAINS match ('in') is supported on labels.
+        #   Required. The search query. Must be specified in [Common Expression Language](
+        #   https://opensource.google/projects/cel). May only contain equality operators
+        #   on the parent and inclusion operators on labels (e.g., `parent == 'customers/`
+        #   customer_id`' && 'cloudidentity.googleapis.com/groups.discussion_forum' in
+        #   labels`).
         # @param [String] view
-        #   Group resource view to be returned. Defaults to [View.BASIC]().
+        #   The level of detail to be returned. If unspecified, defaults to `View.BASIC`.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -1062,11 +1076,10 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Creates a Membership.
+        # Creates a `Membership`.
         # @param [String] parent
-        #   Required. [Resource name](https://cloud.google.com/apis/design/resource_names)
-        #   of the Group to create Membership within. Format: `groups/`group_id``, where `
-        #   group_id` is the unique ID assigned to the Group.
+        #   Required. The parent `Group` resource under which to create the `Membership`.
+        #   Must be of the form `groups/`group_id``.
         # @param [Google::Apis::CloudidentityV1::Membership] membership_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -1097,12 +1110,11 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Deletes a Membership.
+        # Deletes a `Membership`.
         # @param [String] name
-        #   Required. [Resource name](https://cloud.google.com/apis/design/resource_names)
-        #   of the Membership to be deleted. 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.
+        #   Required. The [resource name](https://cloud.google.com/apis/design/
+        #   resource_names) of the `Membership` to delete. Must be of the form `groups/`
+        #   group_id`/memberships/`membership_id``
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -1130,12 +1142,11 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Retrieves a Membership.
+        # Retrieves a `Membership`.
         # @param [String] name
-        #   Required. [Resource name](https://cloud.google.com/apis/design/resource_names)
-        #   of the Membership to be retrieved. 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.
+        #   Required. The [resource name](https://cloud.google.com/apis/design/
+        #   resource_names) of the `Membership` to retrieve. Must be of the form `groups/`
+        #   group_id`/memberships/`membership_id``.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -1163,18 +1174,21 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Lists Memberships within a Group.
+        # Lists the `Membership`s within a `Group`.
         # @param [String] parent
-        #   Required. [Resource name](https://cloud.google.com/apis/design/resource_names)
-        #   of the Group to list Memberships within. Format: `groups/`group_id``, where `
-        #   group_id` is the unique ID assigned to the Group.
+        #   Required. The parent `Group` resource under which to lookup the `Membership`
+        #   name. Must be of the form `groups/`group_id``.
         # @param [Fixnum] page_size
-        #   The default page size is 200 (max 1000) for the BASIC view, and 50 (max 500)
-        #   for the FULL view.
+        #   The maximum number of results to return. Note that the number of results
+        #   returned may be less than this value even if there are more available results.
+        #   To fetch all results, clients must continue calling this method repeatedly
+        #   until the response no longer contains a `next_page_token`. If unspecified,
+        #   defaults to 200 for `GroupView.BASIC` and to 50 for `GroupView.FULL`. Must not
+        #   be greater than 1000 for `GroupView.BASIC` or 500 for `GroupView.FULL`.
         # @param [String] page_token
-        #   The next_page_token value returned from a previous list request, if any.
+        #   The `next_page_token` value returned from a previous search request, if any.
         # @param [String] view
-        #   Membership resource view to be returned. Defaults to View.BASIC.
+        #   The level of detail to be returned. If unspecified, defaults to `View.BASIC`.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -1205,20 +1219,22 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Looks up [resource name](https://cloud.google.com/apis/design/resource_names)
-        # of a Membership within a Group by member's EntityKey.
+        # Looks up the [resource name](https://cloud.google.com/apis/design/
+        # resource_names) of a `Membership` by its `EntityKey`.
         # @param [String] parent
-        #   Required. [Resource name](https://cloud.google.com/apis/design/resource_names)
-        #   of the Group to lookup Membership within. Format: `groups/`group_id``, where `
-        #   group_id` is the unique ID assigned to the Group.
+        #   Required. The parent `Group` resource under which to lookup the `Membership`
+        #   name. Must be of the form `groups/`group_id``.
         # @param [String] member_key_id
-        #   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`.
         # @param [String] member_key_namespace
-        #   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`.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user