google-api-client 0.43.0 → 0.44.0

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

@@ -48,15 +48,14 @@ module Google
           @batch_path = 'batch'
         end
         
-        # A policy specifies the attestors that must attest to
-        # a container image, before the project is allowed to deploy that
-        # image. There is at most one policy per project. All image admission
-        # requests are permitted if a project has no policy.
-        # Gets the policy for this project. Returns a default
-        # policy if the project does not have one.
+        # A policy specifies the attestors that must attest to a container image, before
+        # the project is allowed to deploy that image. There is at most one policy per
+        # project. All image admission requests are permitted if a project has no policy.
+        # Gets the policy for this project. Returns a default policy if the project
+        # does not have one.
         # @param [String] name
-        #   Required. The resource name of the policy to retrieve,
-        #   in the format `projects/*/policy`.
+        #   Required. The resource name of the policy to retrieve, in the format `projects/
+        #   */policy`.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -84,14 +83,13 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Creates or updates a project's policy, and returns a copy of the
-        # new policy. A policy is always updated as a whole, to avoid race
-        # conditions with concurrent policy enforcement (or management!)
-        # requests. Returns NOT_FOUND if the project does not exist, INVALID_ARGUMENT
-        # if the request is malformed.
+        # Creates or updates a project's policy, and returns a copy of the new policy. A
+        # policy is always updated as a whole, to avoid race conditions with concurrent
+        # policy enforcement (or management!) requests. Returns NOT_FOUND if the project
+        # does not exist, INVALID_ARGUMENT if the request is malformed.
         # @param [String] name
-        #   Output only. The resource name, in the format `projects/*/policy`. There is
-        #   at most one policy per project.
+        #   Output only. The resource name, in the format `projects/*/policy`. There is at
+        #   most one policy per project.
         # @param [Google::Apis::BinaryauthorizationV1beta1::Policy] policy_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -122,10 +120,9 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Creates an attestor, and returns a copy of the new
-        # attestor. Returns NOT_FOUND if the project does not exist,
-        # INVALID_ARGUMENT if the request is malformed, ALREADY_EXISTS if the
-        # attestor already exists.
+        # Creates an attestor, and returns a copy of the new attestor. Returns NOT_FOUND
+        # if the project does not exist, INVALID_ARGUMENT if the request is malformed,
+        # ALREADY_EXISTS if the attestor already exists.
         # @param [String] parent
         #   Required. The parent of this attestor.
         # @param [Google::Apis::BinaryauthorizationV1beta1::Attestor] attestor_object
@@ -161,11 +158,10 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Deletes an attestor. Returns NOT_FOUND if the
-        # attestor does not exist.
+        # Deletes an attestor. Returns NOT_FOUND if the attestor does not exist.
         # @param [String] name
-        #   Required. The name of the attestors to delete, in the format
-        #   `projects/*/attestors/*`.
+        #   Required. The name of the attestors to delete, in the format `projects/*/
+        #   attestors/*`.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -193,11 +189,10 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Gets an attestor.
-        # Returns NOT_FOUND if the attestor does not exist.
+        # Gets an attestor. Returns NOT_FOUND if the attestor does not exist.
         # @param [String] name
-        #   Required. The name of the attestor to retrieve, in the format
-        #   `projects/*/attestors/*`.
+        #   Required. The name of the attestor to retrieve, in the format `projects/*/
+        #   attestors/*`.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -225,22 +220,19 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Gets the access control policy for a resource.
-        # Returns an empty policy if the resource exists and does not have a policy
-        # set.
+        # Gets the access control policy for a resource. Returns an empty policy if the
+        # resource exists and does not have a policy set.
         # @param [String] resource
-        #   REQUIRED: The resource for which the policy is being requested.
-        #   See the operation documentation for the appropriate value for this field.
+        #   REQUIRED: The resource for which the policy is being requested. See the
+        #   operation documentation for the appropriate value for this field.
         # @param [Fixnum] options_requested_policy_version
-        #   Optional. The policy format version to be returned.
-        #   Valid values are 0, 1, and 3. Requests specifying an invalid value will be
-        #   rejected.
-        #   Requests for policies with any conditional bindings must specify version 3.
-        #   Policies without any conditional bindings may specify any valid value or
-        #   leave the field unset.
-        #   To learn which resources support conditions in their IAM policies, see the
-        #   [IAM
-        #   documentation](https://cloud.google.com/iam/help/conditions/resource-policies).
+        #   Optional. The policy format version to be returned. Valid values are 0, 1, and
+        #   3. Requests specifying an invalid value will be rejected. Requests for
+        #   policies with any conditional bindings must specify version 3. Policies
+        #   without any conditional bindings may specify any valid value or leave the
+        #   field unset. To learn which resources support conditions in their IAM policies,
+        #   see the [IAM documentation](https://cloud.google.com/iam/help/conditions/
+        #   resource-policies).
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -269,18 +261,17 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Lists attestors.
-        # Returns INVALID_ARGUMENT if the project does not exist.
+        # Lists attestors. Returns INVALID_ARGUMENT if the project does not exist.
         # @param [String] parent
-        #   Required. The resource name of the project associated with the
-        #   attestors, in the format `projects/*`.
+        #   Required. The resource name of the project associated with the attestors, in
+        #   the format `projects/*`.
         # @param [Fixnum] page_size
         #   Requested page size. The server may return fewer results than requested. If
         #   unspecified, the server will pick an appropriate default.
         # @param [String] page_token
         #   A token identifying a page of results the server should return. Typically,
-        #   this is the value of ListAttestorsResponse.next_page_token returned
-        #   from the previous call to the `ListAttestors` method.
+        #   this is the value of ListAttestorsResponse.next_page_token returned from the
+        #   previous call to the `ListAttestors` method.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -311,11 +302,11 @@ module Google
         end
         
         # Sets the access control policy on the specified resource. Replaces any
-        # existing policy.
-        # Can return `NOT_FOUND`, `INVALID_ARGUMENT`, and `PERMISSION_DENIED` errors.
+        # existing policy. Can return `NOT_FOUND`, `INVALID_ARGUMENT`, and `
+        # PERMISSION_DENIED` errors.
         # @param [String] resource
-        #   REQUIRED: The resource for which the policy is being specified.
-        #   See the operation documentation for the appropriate value for this field.
+        #   REQUIRED: The resource for which the policy is being specified. See the
+        #   operation documentation for the appropriate value for this field.
         # @param [Google::Apis::BinaryauthorizationV1beta1::SetIamPolicyRequest] set_iam_policy_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -346,15 +337,14 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Returns permissions that a caller has on the specified resource.
-        # If the resource does not exist, this will return an empty set of
-        # permissions, not a `NOT_FOUND` error.
-        # Note: This operation is designed to be used for building permission-aware
-        # UIs and command-line tools, not for authorization checking. This operation
-        # may "fail open" without warning.
+        # Returns permissions that a caller has on the specified resource. If the
+        # resource does not exist, this will return an empty set of permissions, not a `
+        # NOT_FOUND` error. Note: This operation is designed to be used for building
+        # permission-aware UIs and command-line tools, not for authorization checking.
+        # This operation may "fail open" without warning.
         # @param [String] resource
-        #   REQUIRED: The resource for which the policy detail is being requested.
-        #   See the operation documentation for the appropriate value for this field.
+        #   REQUIRED: The resource for which the policy detail is being requested. See the
+        #   operation documentation for the appropriate value for this field.
         # @param [Google::Apis::BinaryauthorizationV1beta1::TestIamPermissionsRequest] test_iam_permissions_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -385,11 +375,10 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Updates an attestor.
-        # Returns NOT_FOUND if the attestor does not exist.
+        # Updates an attestor. Returns NOT_FOUND if the attestor does not exist.
         # @param [String] name
-        #   Required. The resource name, in the format:
-        #   `projects/*/attestors/*`. This field may not be updated.
+        #   Required. The resource name, in the format: `projects/*/attestors/*`. This
+        #   field may not be updated.
         # @param [Google::Apis::BinaryauthorizationV1beta1::Attestor] attestor_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -420,22 +409,19 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Gets the access control policy for a resource.
-        # Returns an empty policy if the resource exists and does not have a policy
-        # set.
+        # Gets the access control policy for a resource. Returns an empty policy if the
+        # resource exists and does not have a policy set.
         # @param [String] resource
-        #   REQUIRED: The resource for which the policy is being requested.
-        #   See the operation documentation for the appropriate value for this field.
+        #   REQUIRED: The resource for which the policy is being requested. See the
+        #   operation documentation for the appropriate value for this field.
         # @param [Fixnum] options_requested_policy_version
-        #   Optional. The policy format version to be returned.
-        #   Valid values are 0, 1, and 3. Requests specifying an invalid value will be
-        #   rejected.
-        #   Requests for policies with any conditional bindings must specify version 3.
-        #   Policies without any conditional bindings may specify any valid value or
-        #   leave the field unset.
-        #   To learn which resources support conditions in their IAM policies, see the
-        #   [IAM
-        #   documentation](https://cloud.google.com/iam/help/conditions/resource-policies).
+        #   Optional. The policy format version to be returned. Valid values are 0, 1, and
+        #   3. Requests specifying an invalid value will be rejected. Requests for
+        #   policies with any conditional bindings must specify version 3. Policies
+        #   without any conditional bindings may specify any valid value or leave the
+        #   field unset. To learn which resources support conditions in their IAM policies,
+        #   see the [IAM documentation](https://cloud.google.com/iam/help/conditions/
+        #   resource-policies).
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -465,11 +451,11 @@ module Google
         end
         
         # Sets the access control policy on the specified resource. Replaces any
-        # existing policy.
-        # Can return `NOT_FOUND`, `INVALID_ARGUMENT`, and `PERMISSION_DENIED` errors.
+        # existing policy. Can return `NOT_FOUND`, `INVALID_ARGUMENT`, and `
+        # PERMISSION_DENIED` errors.
         # @param [String] resource
-        #   REQUIRED: The resource for which the policy is being specified.
-        #   See the operation documentation for the appropriate value for this field.
+        #   REQUIRED: The resource for which the policy is being specified. See the
+        #   operation documentation for the appropriate value for this field.
         # @param [Google::Apis::BinaryauthorizationV1beta1::SetIamPolicyRequest] set_iam_policy_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -500,15 +486,14 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Returns permissions that a caller has on the specified resource.
-        # If the resource does not exist, this will return an empty set of
-        # permissions, not a `NOT_FOUND` error.
-        # Note: This operation is designed to be used for building permission-aware
-        # UIs and command-line tools, not for authorization checking. This operation
-        # may "fail open" without warning.
+        # Returns permissions that a caller has on the specified resource. If the
+        # resource does not exist, this will return an empty set of permissions, not a `
+        # NOT_FOUND` error. Note: This operation is designed to be used for building
+        # permission-aware UIs and command-line tools, not for authorization checking.
+        # This operation may "fail open" without warning.
         # @param [String] resource
-        #   REQUIRED: The resource for which the policy detail is being requested.
-        #   See the operation documentation for the appropriate value for this field.
+        #   REQUIRED: The resource for which the policy detail is being requested. See the
+        #   operation documentation for the appropriate value for this field.
         # @param [Google::Apis::BinaryauthorizationV1beta1::TestIamPermissionsRequest] test_iam_permissions_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.

data/generated/google/apis/calendar_v3.rb

@@ -25,7 +25,7 @@ module Google
     # @see https://developers.google.com/google-apps/calendar/firstapp
     module CalendarV3
       VERSION = 'V3'
-      REVISION = '20200610'
+      REVISION = '20200827'
 
       # See, edit, share, and permanently delete all the calendars you can access using Google Calendar
       AUTH_CALENDAR = 'https://www.googleapis.com/auth/calendar'

data/generated/google/apis/chat_v1.rb

@@ -25,7 +25,7 @@ module Google
     # @see https://developers.google.com/hangouts/chat
     module ChatV1
       VERSION = 'V1'
-      REVISION = '20200722'
+      REVISION = '20200801'
     end
   end
 end

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

@@ -22,10 +22,10 @@ module Google
   module Apis
     module ChatV1
       
-      # List of string parameters to supply when the action method is invoked.
-      # For example, consider three snooze buttons: snooze now, snooze 1 day,
-      # snooze next week. You might use action method = snooze(), passing the
-      # snooze type and snooze time in the list of string parameters.
+      # List of string parameters to supply when the action method is invoked. For
+      # example, consider three snooze buttons: snooze now, snooze 1 day, snooze next
+      # week. You might use action method = snooze(), passing the snooze type and
+      # snooze time in the list of string parameters.
       class ActionParameter
         include Google::Apis::Core::Hashable
       
@@ -75,28 +75,12 @@ module Google
         end
       end
       
-      # Annotations associated with the plain-text body of the message.
-      # Example plain-text message body:
-      # ```
-      # Hello @FooBot how are you!"
-      # ```
-      # The corresponding annotations metadata:
-      # ```
-      # "annotations":[`
-      # "type":"USER_MENTION",
-      # "startIndex":6,
-      # "length":7,
-      # "userMention": `
-      # "user": `
-      # "name":"users/107946847022116401880",
-      # "displayName":"FooBot",
-      # "avatarUrl":"https://goo.gl/aeDtrS",
-      # "type":"BOT"
-      # `,
-      # "type":"MENTION"
-      # `
-      # `]
-      # ```
+      # Annotations associated with the plain-text body of the message. Example plain-
+      # text message body: ``` Hello @FooBot how are you!" ``` The corresponding
+      # annotations metadata: ``` "annotations":[` "type":"USER_MENTION", "startIndex":
+      # 6, "length":7, "userMention": ` "user": ` "name":"users/107946847022116401880",
+      # "displayName":"FooBot", "avatarUrl":"https://goo.gl/aeDtrS", "type":"BOT" `, "
+      # type":"MENTION" ` `] ```
       class Annotation
         include Google::Apis::Core::Hashable
       
@@ -155,8 +139,8 @@ module Google
         attr_accessor :content_type
       
         # Output only. The download URL which should be used to allow a human user to
-        # download the attachment. Bots should not use this URL to download
-        # attachment content.
+        # download the attachment. Bots should not use this URL to download attachment
+        # content.
         # Corresponds to the JSON property `downloadUri`
         # @return [String]
         attr_accessor :download_uri
@@ -166,8 +150,8 @@ module Google
         # @return [Google::Apis::ChatV1::DriveDataRef]
         attr_accessor :drive_data_ref
       
-        # Resource name of the attachment, in the form
-        # "spaces/*/messages/*/attachments/*".
+        # Resource name of the attachment, in the form "spaces/*/messages/*/attachments/*
+        # ".
         # Corresponds to the JSON property `name`
         # @return [String]
         attr_accessor :name
@@ -177,9 +161,8 @@ module Google
         # @return [String]
         attr_accessor :source
       
-        # Output only. The thumbnail URL which should be used to preview the
-        # attachment to a human user. Bots should not use this URL to download
-        # attachment content.
+        # Output only. The thumbnail URL which should be used to preview the attachment
+        # to a human user. Bots should not use this URL to download attachment content.
         # Corresponds to the JSON property `thumbnailUri`
         # @return [String]
         attr_accessor :thumbnail_uri
@@ -205,8 +188,8 @@ module Google
       class AttachmentDataRef
         include Google::Apis::Core::Hashable
       
-        # The resource name of the attachment data. This is used with the media API
-        # to download the attachment data.
+        # The resource name of the attachment data. This is used with the media API to
+        # download the attachment data.
         # Corresponds to the JSON property `resourceName`
         # @return [String]
         attr_accessor :resource_name
@@ -283,10 +266,9 @@ module Google
         end
       end
       
-      # A card action is
-      # the action associated with the card. For an invoice card, a
-      # typical action would be: delete invoice, email invoice or open the
-      # invoice in browser.
+      # A card action is the action associated with the card. For an invoice card, a
+      # typical action would be: delete invoice, email invoice or open the invoice in
+      # browser.
       class CardAction
         include Google::Apis::Core::Hashable
       
@@ -330,9 +312,9 @@ module Google
         # @return [String]
         attr_accessor :subtitle
       
-        # The title must be specified. The header has a fixed height: if both a
-        # title and subtitle is specified, each will take up 1 line. If only the
-        # title is specified, it will take up both lines.
+        # The title must be specified. The header has a fixed height: if both a title
+        # and subtitle is specified, each will take up 1 line. If only the title is
+        # specified, it will take up both lines.
         # Corresponds to the JSON property `title`
         # @return [String]
         attr_accessor :title
@@ -354,16 +336,16 @@ module Google
       class DeprecatedEvent
         include Google::Apis::Core::Hashable
       
-        # A form action describes the behavior when the form is submitted.
-        # For example, an Apps Script can be invoked to handle the form.
+        # A form action describes the behavior when the form is submitted. For example,
+        # an Apps Script can be invoked to handle the form.
         # Corresponds to the JSON property `action`
         # @return [Google::Apis::ChatV1::FormAction]
         attr_accessor :action
       
         # The URL the bot should redirect the user to after they have completed an
-        # authorization or configuration flow outside of Hangouts Chat. See the
-        # [Authorizing access to 3p services guide](/hangouts/chat/how-tos/auth-3p)
-        # for more information.
+        # authorization or configuration flow outside of Hangouts Chat. See the [
+        # Authorizing access to 3p services guide](/hangouts/chat/how-tos/auth-3p) for
+        # more information.
         # Corresponds to the JSON property `configCompleteRedirectUrl`
         # @return [String]
         attr_accessor :config_complete_redirect_url
@@ -383,17 +365,16 @@ module Google
         # @return [Google::Apis::ChatV1::Space]
         attr_accessor :space
       
-        # The bot-defined key for the thread related to the event. See the
-        # thread_key field of the
-        # `spaces.message.create` request for more information.
+        # The bot-defined key for the thread related to the event. See the thread_key
+        # field of the `spaces.message.create` request for more information.
         # Corresponds to the JSON property `threadKey`
         # @return [String]
         attr_accessor :thread_key
       
         # A secret value that bots can use to verify if a request is from Google. The
         # token is randomly generated by Google, remains static, and can be obtained
-        # from the Hangouts Chat API configuration page in the Cloud Console.
-        # Developers can revoke/regenerate it if needed from the same page.
+        # from the Hangouts Chat API configuration page in the Cloud Console. Developers
+        # can revoke/regenerate it if needed from the same page.
         # Corresponds to the JSON property `token`
         # @return [String]
         attr_accessor :token
@@ -445,13 +426,11 @@ module Google
         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.protobuf.Empty) returns (google.protobuf.Empty);
-      # `
-      # The JSON representation for `Empty` is empty JSON object ````.
+      # 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 ````.
       class Empty
         include Google::Apis::Core::Hashable
       
@@ -464,15 +443,15 @@ module Google
         end
       end
       
-      # A form action describes the behavior when the form is submitted.
-      # For example, an Apps Script can be invoked to handle the form.
+      # A form action describes the behavior when the form is submitted. For example,
+      # an Apps Script can be invoked to handle the form.
       class FormAction
         include Google::Apis::Core::Hashable
       
-        # The method name is used to identify which part of the form triggered the
-        # form submission. This information is echoed back to the bot as part of
-        # the card click event. The same method name can be used for several
-        # elements that trigger a common behavior if desired.
+        # The method name is used to identify which part of the form triggered the form
+        # submission. This information is echoed back to the bot as part of the card
+        # click event. The same method name can be used for several elements that
+        # trigger a common behavior if desired.
         # Corresponds to the JSON property `actionMethodName`
         # @return [String]
         attr_accessor :action_method_name
@@ -497,10 +476,10 @@ module Google
       class Image
         include Google::Apis::Core::Hashable
       
-        # The aspect ratio of this image (width/height). This field allows clients
-        # to reserve the right height for the image while waiting for it to load.
-        # It's not meant to override the native aspect ratio of the image.
-        # If unset, the server fills it by prefetching the image.
+        # The aspect ratio of this image (width/height). This field allows clients to
+        # reserve the right height for the image while waiting for it to load. It's not
+        # meant to override the native aspect ratio of the image. If unset, the server
+        # fills it by prefetching the image.
         # Corresponds to the JSON property `aspectRatio`
         # @return [Float]
         attr_accessor :aspect_ratio
@@ -531,8 +510,7 @@ module Google
       class ImageButton
         include Google::Apis::Core::Hashable
       
-        # The icon specified by an enum that indices to an icon provided by Chat
-        # API.
+        # The icon specified by an enum that indices to an icon provided by Chat API.
         # Corresponds to the JSON property `icon`
         # @return [String]
         attr_accessor :icon
@@ -542,8 +520,8 @@ module Google
         # @return [String]
         attr_accessor :icon_url
       
-        # The name of this image_button which will be used for accessibility.
-        # Default value will be provided if developers don't specify.
+        # The name of this image_button which will be used for accessibility. Default
+        # value will be provided if developers don't specify.
         # Corresponds to the JSON property `name`
         # @return [String]
         attr_accessor :name
@@ -566,8 +544,8 @@ module Google
         end
       end
       
-      # A UI element contains a key (label) and a value (content). And this
-      # element may also contain some actions such as onclick button.
+      # A UI element contains a key (label) and a value (content). And this element
+      # may also contain some actions such as onclick button.
       class KeyValue
         include Google::Apis::Core::Hashable
       
@@ -592,8 +570,8 @@ module Google
         attr_accessor :content_multiline
         alias_method :content_multiline?, :content_multiline
       
-        # An enum value that will be replaced by the Chat API with the
-        # corresponding icon image.
+        # An enum value that will be replaced by the Chat API with the corresponding
+        # icon image.
         # Corresponds to the JSON property `icon`
         # @return [String]
         attr_accessor :icon
@@ -639,8 +617,8 @@ module Google
         # @return [Array<Google::Apis::ChatV1::Membership>]
         attr_accessor :memberships
       
-        # Continuation token to retrieve the next page of results. It will be empty
-        # for the last page of results.
+        # Continuation token to retrieve the next page of results. It will be empty for
+        # the last page of results.
         # Corresponds to the JSON property `nextPageToken`
         # @return [String]
         attr_accessor :next_page_token
@@ -660,9 +638,9 @@ module Google
       class ListSpacesResponse
         include Google::Apis::Core::Hashable
       
-        # Continuation token to retrieve the next page of results. It will be empty
-        # for the last page of results. Tokens expire in an hour. An error is thrown
-        # if an expired token is passed.
+        # Continuation token to retrieve the next page of results. It will be empty for
+        # the last page of results. Tokens expire in an hour. An error is thrown if an
+        # expired token is passed.
         # Corresponds to the JSON property `nextPageToken`
         # @return [String]
         attr_accessor :next_page_token
@@ -706,8 +684,8 @@ module Google
       class Membership
         include Google::Apis::Core::Hashable
       
-        # The creation time of the membership a.k.a the time at which the member
-        # joined the space, if applicable.
+        # The creation time of the membership a.k.a the time at which the member joined
+        # the space, if applicable.
         # Corresponds to the JSON property `createTime`
         # @return [String]
         attr_accessor :create_time
@@ -717,8 +695,8 @@ module Google
         # @return [Google::Apis::ChatV1::User]
         attr_accessor :member
       
-        # Resource name of the membership, in the form "spaces/*/members/*".
-        # Example: spaces/AAAAMpdlehY/members/105115627578887013105
+        # Resource name of the membership, in the form "spaces/*/members/*". Example:
+        # spaces/AAAAMpdlehY/members/105115627578887013105
         # Corresponds to the JSON property `name`
         # @return [String]
         attr_accessor :name
@@ -765,15 +743,14 @@ module Google
         # @return [Array<Google::Apis::ChatV1::Attachment>]
         attr_accessor :attachment
       
-        # Rich, formatted and interactive cards that can be used to display UI
-        # elements such as: formatted texts, buttons, clickable images. Cards are
-        # normally displayed below the plain-text body of the message.
+        # Rich, formatted and interactive cards that can be used to display UI elements
+        # such as: formatted texts, buttons, clickable images. Cards are normally
+        # displayed below the plain-text body of the message.
         # Corresponds to the JSON property `cards`
         # @return [Array<Google::Apis::ChatV1::Card>]
         attr_accessor :cards
       
-        # Output only. The time at which the message was created in Hangouts Chat
-        # server.
+        # Output only. The time at which the message was created in Hangouts Chat server.
         # Corresponds to the JSON property `createTime`
         # @return [String]
         attr_accessor :create_time
@@ -784,15 +761,15 @@ module Google
         # @return [String]
         attr_accessor :fallback_text
       
-        # Resource name, in the form "spaces/*/messages/*".
-        # Example: spaces/AAAAMpdlehY/messages/UMxbHmzDlr4.UMxbHmzDlr4
+        # Resource name, in the form "spaces/*/messages/*". Example: spaces/AAAAMpdlehY/
+        # messages/UMxbHmzDlr4.UMxbHmzDlr4
         # Corresponds to the JSON property `name`
         # @return [String]
         attr_accessor :name
       
-        # Text for generating preview chips. This text will not be displayed to the
-        # user, but any links to images, web pages, videos, etc. included here will
-        # generate preview chips.
+        # Text for generating preview chips. This text will not be displayed to the user,
+        # but any links to images, web pages, videos, etc. included here will generate
+        # preview chips.
         # Corresponds to the JSON property `previewText`
         # @return [String]
         attr_accessor :preview_text
@@ -843,8 +820,8 @@ module Google
       class OnClick
         include Google::Apis::Core::Hashable
       
-        # A form action describes the behavior when the form is submitted.
-        # For example, an Apps Script can be invoked to handle the form.
+        # A form action describes the behavior when the form is submitted. For example,
+        # an Apps Script can be invoked to handle the form.
         # Corresponds to the JSON property `action`
         # @return [Google::Apis::ChatV1::FormAction]
         attr_accessor :action
@@ -884,10 +861,9 @@ module Google
         end
       end
       
-      # A section contains a collection of widgets that are rendered
-      # (vertically) in the order that they are specified. Across all platforms,
-      # cards have a narrow fixed width, so
-      # there is currently no need for layout properties (e.g. float).
+      # A section contains a collection of widgets that are rendered (vertically) in
+      # the order that they are specified. Across all platforms, cards have a narrow
+      # fixed width, so there is currently no need for layout properties (e.g. float).
       class Section
         include Google::Apis::Core::Hashable
       
@@ -916,15 +892,14 @@ module Google
       class Space
         include Google::Apis::Core::Hashable
       
-        # Output only. The display name (only if the space is a room).
-        # Please note that this field might not be populated in direct messages
-        # between humans.
+        # Output only. The display name (only if the space is a room). Please note that
+        # this field might not be populated in direct messages between humans.
         # Corresponds to the JSON property `displayName`
         # @return [String]
         attr_accessor :display_name
       
-        # Resource name of the space, in the form "spaces/*".
-        # Example: spaces/AAAAMpdlehYs
+        # Resource name of the space, in the form "spaces/*". Example: spaces/
+        # AAAAMpdlehYs
         # Corresponds to the JSON property `name`
         # @return [String]
         attr_accessor :name
@@ -941,8 +916,8 @@ module Google
         attr_accessor :threaded
         alias_method :threaded?, :threaded
       
-        # Output only. The type of a space.
-        # This is deprecated. Use `single_user_bot_dm` instead.
+        # Output only. The type of a space. This is deprecated. Use `single_user_bot_dm`
+        # instead.
         # Corresponds to the JSON property `type`
         # @return [String]
         attr_accessor :type
@@ -1009,8 +984,8 @@ module Google
       class Thread
         include Google::Apis::Core::Hashable
       
-        # Resource name, in the form "spaces/*/threads/*".
-        # Example: spaces/AAAAMpdlehY/threads/UMxbHmzDlr4
+        # Resource name, in the form "spaces/*/threads/*". Example: spaces/AAAAMpdlehY/
+        # threads/UMxbHmzDlr4
         # Corresponds to the JSON property `name`
         # @return [String]
         attr_accessor :name
@@ -1091,8 +1066,8 @@ module Google
       class WidgetMarkup
         include Google::Apis::Core::Hashable
       
-        # A list of buttons. Buttons is also oneof data and only one of these
-        # fields should be set.
+        # A list of buttons. Buttons is also oneof data and only one of these fields
+        # should be set.
         # Corresponds to the JSON property `buttons`
         # @return [Array<Google::Apis::ChatV1::Button>]
         attr_accessor :buttons
@@ -1102,8 +1077,8 @@ module Google
         # @return [Google::Apis::ChatV1::Image]
         attr_accessor :image
       
-        # A UI element contains a key (label) and a value (content). And this
-        # element may also contain some actions such as onclick button.
+        # A UI element contains a key (label) and a value (content). And this element
+        # may also contain some actions such as onclick button.
         # Corresponds to the JSON property `keyValue`
         # @return [Google::Apis::ChatV1::KeyValue]
         attr_accessor :key_value