google-api-client 0.43.0 → 0.48.0

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

@@ -27,8 +27,7 @@ module Google
         include Google::Apis::Core::Hashable
       
         # Required. The acknowledgment ID for the messages being acknowledged that was
-        # returned
-        # by the Pub/Sub system in the `Pull` response. Must not be empty.
+        # returned by the Pub/Sub system in the `Pull` response. Must not be empty.
         # Corresponds to the JSON property `ackIds`
         # @return [Array<String>]
         attr_accessor :ack_ids
@@ -47,69 +46,63 @@ module Google
       class Binding
         include Google::Apis::Core::Hashable
       
-        # Represents a textual expression in the Common Expression Language (CEL)
-        # syntax. CEL is a C-like expression language. The syntax and semantics of CEL
-        # are documented at https://github.com/google/cel-spec.
-        # Example (Comparison):
-        # title: "Summary size limit"
-        # description: "Determines if a summary is less than 100 chars"
-        # expression: "document.summary.size() < 100"
-        # Example (Equality):
-        # title: "Requestor is owner"
-        # description: "Determines if requestor is the document owner"
-        # expression: "document.owner == request.auth.claims.email"
-        # Example (Logic):
-        # title: "Public documents"
-        # description: "Determine whether the document should be publicly visible"
-        # expression: "document.type != 'private' && document.type != 'internal'"
-        # Example (Data Manipulation):
-        # title: "Notification string"
-        # description: "Create a notification string with a timestamp."
-        # expression: "'New message received at ' + string(document.create_time)"
-        # The exact variables and functions that may be referenced within an expression
-        # are determined by the service that evaluates it. See the service
-        # documentation for additional information.
+        # A client-specified ID for this binding. Expected to be globally unique to
+        # support the internal bindings-by-ID API.
+        # Corresponds to the JSON property `bindingId`
+        # @return [String]
+        attr_accessor :binding_id
+      
+        # Represents a textual expression in the Common Expression Language (CEL) syntax.
+        # CEL is a C-like expression language. The syntax and semantics of CEL are
+        # documented at https://github.com/google/cel-spec. Example (Comparison): title:
+        # "Summary size limit" description: "Determines if a summary is less than 100
+        # chars" expression: "document.summary.size() < 100" Example (Equality): title: "
+        # Requestor is owner" description: "Determines if requestor is the document
+        # owner" expression: "document.owner == request.auth.claims.email" Example (
+        # Logic): title: "Public documents" description: "Determine whether the document
+        # should be publicly visible" expression: "document.type != 'private' &&
+        # document.type != 'internal'" Example (Data Manipulation): title: "Notification
+        # string" description: "Create a notification string with a timestamp."
+        # expression: "'New message received at ' + string(document.create_time)" The
+        # exact variables and functions that may be referenced within an expression are
+        # determined by the service that evaluates it. See the service documentation for
+        # additional information.
         # Corresponds to the JSON property `condition`
         # @return [Google::Apis::PubsubV1::Expr]
         attr_accessor :condition
       
-        # Specifies the identities requesting access for a Cloud Platform resource.
-        # `members` can have the following values:
-        # * `allUsers`: A special identifier that represents anyone who is
-        # on the internet; with or without a Google account.
-        # * `allAuthenticatedUsers`: A special identifier that represents anyone
-        # who is authenticated with a Google account or a service account.
-        # * `user:`emailid``: An email address that represents a specific Google
-        # account. For example, `alice@example.com` .
-        # * `serviceAccount:`emailid``: An email address that represents a service
-        # account. For example, `my-other-app@appspot.gserviceaccount.com`.
-        # * `group:`emailid``: An email address that represents a Google group.
-        # For example, `admins@example.com`.
-        # * `deleted:user:`emailid`?uid=`uniqueid``: An email address (plus unique
-        # identifier) representing a user that has been recently deleted. For
-        # example, `alice@example.com?uid=123456789012345678901`. If the user is
-        # recovered, this value reverts to `user:`emailid`` and the recovered user
-        # retains the role in the binding.
-        # * `deleted:serviceAccount:`emailid`?uid=`uniqueid``: An email address (plus
-        # unique identifier) representing a service account that has been recently
-        # deleted. For example,
-        # `my-other-app@appspot.gserviceaccount.com?uid=123456789012345678901`.
-        # If the service account is undeleted, this value reverts to
-        # `serviceAccount:`emailid`` and the undeleted service account retains the
-        # role in the binding.
-        # * `deleted:group:`emailid`?uid=`uniqueid``: An email address (plus unique
-        # identifier) representing a Google group that has been recently
-        # deleted. For example, `admins@example.com?uid=123456789012345678901`. If
-        # the group is recovered, this value reverts to `group:`emailid`` and the
-        # recovered group retains the role in the binding.
-        # * `domain:`domain``: The G Suite domain (primary) that represents all the
-        # users of that domain. For example, `google.com` or `example.com`.
+        # Specifies the identities requesting access for a Cloud Platform resource. `
+        # members` can have the following values: * `allUsers`: A special identifier
+        # that represents anyone who is on the internet; with or without a Google
+        # account. * `allAuthenticatedUsers`: A special identifier that represents
+        # anyone who is authenticated with a Google account or a service account. * `
+        # user:`emailid``: An email address that represents a specific Google account.
+        # For example, `alice@example.com` . * `serviceAccount:`emailid``: An email
+        # address that represents a service account. For example, `my-other-app@appspot.
+        # gserviceaccount.com`. * `group:`emailid``: An email address that represents a
+        # Google group. For example, `admins@example.com`. * `deleted:user:`emailid`?uid=
+        # `uniqueid``: An email address (plus unique identifier) representing a user
+        # that has been recently deleted. For example, `alice@example.com?uid=
+        # 123456789012345678901`. If the user is recovered, this value reverts to `user:`
+        # emailid`` and the recovered user retains the role in the binding. * `deleted:
+        # serviceAccount:`emailid`?uid=`uniqueid``: An email address (plus unique
+        # identifier) representing a service account that has been recently deleted. For
+        # example, `my-other-app@appspot.gserviceaccount.com?uid=123456789012345678901`.
+        # If the service account is undeleted, this value reverts to `serviceAccount:`
+        # emailid`` and the undeleted service account retains the role in the binding. *
+        # `deleted:group:`emailid`?uid=`uniqueid``: An email address (plus unique
+        # identifier) representing a Google group that has been recently deleted. For
+        # example, `admins@example.com?uid=123456789012345678901`. If the group is
+        # recovered, this value reverts to `group:`emailid`` and the recovered group
+        # retains the role in the binding. * `domain:`domain``: The G Suite domain (
+        # primary) that represents all the users of that domain. For example, `google.
+        # com` or `example.com`.
         # Corresponds to the JSON property `members`
         # @return [Array<String>]
         attr_accessor :members
       
-        # Role that is assigned to `members`.
-        # For example, `roles/viewer`, `roles/editor`, or `roles/owner`.
+        # Role that is assigned to `members`. For example, `roles/viewer`, `roles/editor`
+        # , or `roles/owner`.
         # Corresponds to the JSON property `role`
         # @return [String]
         attr_accessor :role
@@ -120,6 +113,7 @@ module Google
       
         # Update properties of this object
         def update!(**args)
+          @binding_id = args[:binding_id] if args.key?(:binding_id)
           @condition = args[:condition] if args.key?(:condition)
           @members = args[:members] if args.key?(:members)
           @role = args[:role] if args.key?(:role)
@@ -130,21 +124,18 @@ module Google
       class CreateSnapshotRequest
         include Google::Apis::Core::Hashable
       
-        # See <a href="https://cloud.google.com/pubsub/docs/labels"> Creating and
-        # managing labels</a>.
+        # See Creating and managing labels.
         # Corresponds to the JSON property `labels`
         # @return [Hash<String,String>]
         attr_accessor :labels
       
-        # Required. The subscription whose backlog the snapshot retains.
-        # Specifically, the created snapshot is guaranteed to retain:
-        # (a) The existing backlog on the subscription. More precisely, this is
-        # defined as the messages in the subscription's backlog that are
-        # unacknowledged upon the successful completion of the
-        # `CreateSnapshot` request; as well as:
-        # (b) Any messages published to the subscription's topic following the
-        # successful completion of the CreateSnapshot request.
-        # Format is `projects/`project`/subscriptions/`sub``.
+        # Required. The subscription whose backlog the snapshot retains. Specifically,
+        # the created snapshot is guaranteed to retain: (a) The existing backlog on the
+        # subscription. More precisely, this is defined as the messages in the
+        # subscription's backlog that are unacknowledged upon the successful completion
+        # of the `CreateSnapshot` request; as well as: (b) Any messages published to the
+        # subscription's topic following the successful completion of the CreateSnapshot
+        # request. Format is `projects/`project`/subscriptions/`sub``.
         # Corresponds to the JSON property `subscription`
         # @return [String]
         attr_accessor :subscription
@@ -160,10 +151,10 @@ module Google
         end
       end
       
-      # Dead lettering is done on a best effort basis. The same message might be
-      # dead lettered multiple times.
-      # If validation on any of the fields fails at subscription creation/updation,
-      # the create/update subscription request will fail.
+      # Dead lettering is done on a best effort basis. The same message might be dead
+      # lettered multiple times. If validation on any of the fields fails at
+      # subscription creation/updation, the create/update subscription request will
+      # fail.
       class DeadLetterPolicy
         include Google::Apis::Core::Hashable
       
@@ -171,23 +162,20 @@ module Google
         # Format is `projects/`project`/topics/`topic``.The Cloud Pub/Sub service
         # account associated with the enclosing subscription's parent project (i.e.,
         # service-`project_number`@gcp-sa-pubsub.iam.gserviceaccount.com) must have
-        # permission to Publish() to this topic.
-        # The operation will fail if the topic does not exist.
-        # Users should ensure that there is a subscription attached to this topic
-        # since messages published to a topic with no subscriptions are lost.
+        # permission to Publish() to this topic. The operation will fail if the topic
+        # does not exist. Users should ensure that there is a subscription attached to
+        # this topic since messages published to a topic with no subscriptions are lost.
         # Corresponds to the JSON property `deadLetterTopic`
         # @return [String]
         attr_accessor :dead_letter_topic
       
         # The maximum number of delivery attempts for any message. The value must be
-        # between 5 and 100.
-        # The number of delivery attempts is defined as 1 + (the sum of number of
-        # NACKs and number of times the acknowledgement deadline has been exceeded
-        # for the message).
-        # A NACK is any call to ModifyAckDeadline with a 0 deadline. Note that
-        # client libraries may automatically extend ack_deadlines.
-        # This field will be honored on a best effort basis.
-        # If this parameter is 0, a default value of 5 is used.
+        # between 5 and 100. The number of delivery attempts is defined as 1 + (the sum
+        # of number of NACKs and number of times the acknowledgement deadline has been
+        # exceeded for the message). A NACK is any call to ModifyAckDeadline with a 0
+        # deadline. Note that client libraries may automatically extend ack_deadlines.
+        # This field will be honored on a best effort basis. If this parameter is 0, a
+        # default value of 5 is used.
         # Corresponds to the JSON property `maxDeliveryAttempts`
         # @return [Fixnum]
         attr_accessor :max_delivery_attempts
@@ -203,8 +191,7 @@ module Google
         end
       end
       
-      # Response for the DetachSubscription method.
-      # Reserved for future use.
+      # Response for the DetachSubscription method. Reserved for future use.
       class DetachSubscriptionResponse
         include Google::Apis::Core::Hashable
       
@@ -217,13 +204,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
       
@@ -241,12 +226,11 @@ module Google
       class ExpirationPolicy
         include Google::Apis::Core::Hashable
       
-        # Specifies the "time-to-live" duration for an associated resource. The
-        # resource expires if it is not active for a period of `ttl`. The definition
-        # of "activity" depends on the type of the associated resource. The minimum
-        # and maximum allowed values for `ttl` depend on the type of the associated
-        # resource, as well. If `ttl` is not set, the associated resource never
-        # expires.
+        # Specifies the "time-to-live" duration for an associated resource. The resource
+        # expires if it is not active for a period of `ttl`. The definition of "activity"
+        # depends on the type of the associated resource. The minimum and maximum
+        # allowed values for `ttl` depend on the type of the associated resource, as
+        # well. If `ttl` is not set, the associated resource never expires.
         # Corresponds to the JSON property `ttl`
         # @return [String]
         attr_accessor :ttl
@@ -261,52 +245,43 @@ module Google
         end
       end
       
-      # Represents a textual expression in the Common Expression Language (CEL)
-      # syntax. CEL is a C-like expression language. The syntax and semantics of CEL
-      # are documented at https://github.com/google/cel-spec.
-      # Example (Comparison):
-      # title: "Summary size limit"
-      # description: "Determines if a summary is less than 100 chars"
-      # expression: "document.summary.size() < 100"
-      # Example (Equality):
-      # title: "Requestor is owner"
-      # description: "Determines if requestor is the document owner"
-      # expression: "document.owner == request.auth.claims.email"
-      # Example (Logic):
-      # title: "Public documents"
-      # description: "Determine whether the document should be publicly visible"
-      # expression: "document.type != 'private' && document.type != 'internal'"
-      # Example (Data Manipulation):
-      # title: "Notification string"
-      # description: "Create a notification string with a timestamp."
-      # expression: "'New message received at ' + string(document.create_time)"
-      # The exact variables and functions that may be referenced within an expression
-      # are determined by the service that evaluates it. See the service
-      # documentation for additional information.
+      # Represents a textual expression in the Common Expression Language (CEL) syntax.
+      # CEL is a C-like expression language. The syntax and semantics of CEL are
+      # documented at https://github.com/google/cel-spec. Example (Comparison): title:
+      # "Summary size limit" description: "Determines if a summary is less than 100
+      # chars" expression: "document.summary.size() < 100" Example (Equality): title: "
+      # Requestor is owner" description: "Determines if requestor is the document
+      # owner" expression: "document.owner == request.auth.claims.email" Example (
+      # Logic): title: "Public documents" description: "Determine whether the document
+      # should be publicly visible" expression: "document.type != 'private' &&
+      # document.type != 'internal'" Example (Data Manipulation): title: "Notification
+      # string" description: "Create a notification string with a timestamp."
+      # expression: "'New message received at ' + string(document.create_time)" The
+      # exact variables and functions that may be referenced within an expression are
+      # determined by the service that evaluates it. See the service documentation for
+      # additional information.
       class Expr
         include Google::Apis::Core::Hashable
       
-        # Optional. Description of the expression. This is a longer text which
-        # describes the expression, e.g. when hovered over it in a UI.
+        # Optional. Description of the expression. This is a longer text which describes
+        # the expression, e.g. when hovered over it in a UI.
         # Corresponds to the JSON property `description`
         # @return [String]
         attr_accessor :description
       
-        # Textual representation of an expression in Common Expression Language
-        # syntax.
+        # Textual representation of an expression in Common Expression Language syntax.
         # Corresponds to the JSON property `expression`
         # @return [String]
         attr_accessor :expression
       
-        # Optional. String indicating the location of the expression for error
-        # reporting, e.g. a file name and a position in the file.
+        # Optional. String indicating the location of the expression for error reporting,
+        # e.g. a file name and a position in the file.
         # Corresponds to the JSON property `location`
         # @return [String]
         attr_accessor :location
       
-        # Optional. Title for the expression, i.e. a short string describing
-        # its purpose. This can be used e.g. in UIs which allow to enter the
-        # expression.
+        # Optional. Title for the expression, i.e. a short string describing its purpose.
+        # This can be used e.g. in UIs which allow to enter the expression.
         # Corresponds to the JSON property `title`
         # @return [String]
         attr_accessor :title
@@ -328,8 +303,8 @@ module Google
       class ListSnapshotsResponse
         include Google::Apis::Core::Hashable
       
-        # If not empty, indicates that there may be more snapshot that match the
-        # request; this value should be passed in a new `ListSnapshotsRequest`.
+        # If not empty, indicates that there may be more snapshot that match the request;
+        # this value should be passed in a new `ListSnapshotsRequest`.
         # Corresponds to the JSON property `nextPageToken`
         # @return [String]
         attr_accessor :next_page_token
@@ -354,9 +329,9 @@ module Google
       class ListSubscriptionsResponse
         include Google::Apis::Core::Hashable
       
-        # If not empty, indicates that there may be more subscriptions that match
-        # the request; this value should be passed in a new
-        # `ListSubscriptionsRequest` to get more subscriptions.
+        # If not empty, indicates that there may be more subscriptions that match the
+        # request; this value should be passed in a new `ListSubscriptionsRequest` to
+        # get more subscriptions.
         # Corresponds to the JSON property `nextPageToken`
         # @return [String]
         attr_accessor :next_page_token
@@ -381,9 +356,9 @@ module Google
       class ListTopicSnapshotsResponse
         include Google::Apis::Core::Hashable
       
-        # If not empty, indicates that there may be more snapshots that match
-        # the request; this value should be passed in a new
-        # `ListTopicSnapshotsRequest` to get more snapshots.
+        # If not empty, indicates that there may be more snapshots that match the
+        # request; this value should be passed in a new `ListTopicSnapshotsRequest` to
+        # get more snapshots.
         # Corresponds to the JSON property `nextPageToken`
         # @return [String]
         attr_accessor :next_page_token
@@ -408,9 +383,9 @@ module Google
       class ListTopicSubscriptionsResponse
         include Google::Apis::Core::Hashable
       
-        # If not empty, indicates that there may be more subscriptions that match
-        # the request; this value should be passed in a new
-        # `ListTopicSubscriptionsRequest` to get more subscriptions.
+        # If not empty, indicates that there may be more subscriptions that match the
+        # request; this value should be passed in a new `ListTopicSubscriptionsRequest`
+        # to get more subscriptions.
         # Corresponds to the JSON property `nextPageToken`
         # @return [String]
         attr_accessor :next_page_token
@@ -435,8 +410,8 @@ module Google
       class ListTopicsResponse
         include Google::Apis::Core::Hashable
       
-        # If not empty, indicates that there may be more topics that match the
-        # request; this value should be passed in a new `ListTopicsRequest`.
+        # If not empty, indicates that there may be more topics that match the request;
+        # this value should be passed in a new `ListTopicsRequest`.
         # Corresponds to the JSON property `nextPageToken`
         # @return [String]
         attr_accessor :next_page_token
@@ -462,10 +437,10 @@ module Google
         include Google::Apis::Core::Hashable
       
         # A list of IDs of GCP regions where messages that are published to the topic
-        # may be persisted in storage. Messages published by publishers running in
-        # non-allowed GCP regions (or running outside of GCP altogether) will be
-        # routed for storage in one of the allowed regions. An empty list means that
-        # no regions are allowed, and is not a valid configuration.
+        # may be persisted in storage. Messages published by publishers running in non-
+        # allowed GCP regions (or running outside of GCP altogether) will be routed for
+        # storage in one of the allowed regions. An empty list means that no regions are
+        # allowed, and is not a valid configuration.
         # Corresponds to the JSON property `allowedPersistenceRegions`
         # @return [Array<String>]
         attr_accessor :allowed_persistence_regions
@@ -485,14 +460,13 @@ module Google
         include Google::Apis::Core::Hashable
       
         # Required. The new ack deadline with respect to the time this request was sent
-        # to
-        # the Pub/Sub system. For example, if the value is 10, the new
-        # ack deadline will expire 10 seconds after the `ModifyAckDeadline` call
-        # was made. Specifying zero might immediately make the message available for
-        # delivery to another subscriber client. This typically results in an
-        # increase in the rate of message redeliveries (that is, duplicates).
-        # The minimum deadline you can specify is 0 seconds.
-        # The maximum deadline you can specify is 600 seconds (10 minutes).
+        # to the Pub/Sub system. For example, if the value is 10, the new ack deadline
+        # will expire 10 seconds after the `ModifyAckDeadline` call was made. Specifying
+        # zero might immediately make the message available for delivery to another
+        # subscriber client. This typically results in an increase in the rate of
+        # message redeliveries (that is, duplicates). The minimum deadline you can
+        # specify is 0 seconds. The maximum deadline you can specify is 600 seconds (10
+        # minutes).
         # Corresponds to the JSON property `ackDeadlineSeconds`
         # @return [Fixnum]
         attr_accessor :ack_deadline_seconds
@@ -532,27 +506,25 @@ module Google
         end
       end
       
-      # Contains information needed for generating an
-      # [OpenID Connect
-      # token](https://developers.google.com/identity/protocols/OpenIDConnect).
+      # Contains information needed for generating an [OpenID Connect token](https://
+      # developers.google.com/identity/protocols/OpenIDConnect).
       class OidcToken
         include Google::Apis::Core::Hashable
       
-        # Audience to be used when generating OIDC token. The audience claim
-        # identifies the recipients that the JWT is intended for. The audience
-        # value is a single case-sensitive string. Having multiple values (array)
-        # for the audience field is not supported. More info about the OIDC JWT
-        # token audience here: https://tools.ietf.org/html/rfc7519#section-4.1.3
-        # Note: if not specified, the Push endpoint URL will be used.
+        # Audience to be used when generating OIDC token. The audience claim identifies
+        # the recipients that the JWT is intended for. The audience value is a single
+        # case-sensitive string. Having multiple values (array) for the audience field
+        # is not supported. More info about the OIDC JWT token audience here: https://
+        # tools.ietf.org/html/rfc7519#section-4.1.3 Note: if not specified, the Push
+        # endpoint URL will be used.
         # Corresponds to the JSON property `audience`
         # @return [String]
         attr_accessor :audience
       
-        # [Service account
-        # email](https://cloud.google.com/iam/docs/service-accounts)
-        # to be used for generating the OIDC token. The caller (for
-        # CreateSubscription, UpdateSubscription, and ModifyPushConfig RPCs) must
-        # have the iam.serviceAccounts.actAs permission for the service account.
+        # [Service account email](https://cloud.google.com/iam/docs/service-accounts) to
+        # be used for generating the OIDC token. The caller (for CreateSubscription,
+        # UpdateSubscription, and ModifyPushConfig RPCs) must have the iam.
+        # serviceAccounts.actAs permission for the service account.
         # Corresponds to the JSON property `serviceAccountEmail`
         # @return [String]
         attr_accessor :service_account_email
@@ -569,111 +541,73 @@ module Google
       end
       
       # An Identity and Access Management (IAM) policy, which specifies access
-      # controls for Google Cloud resources.
-      # A `Policy` is a collection of `bindings`. A `binding` binds one or more
-      # `members` to a single `role`. Members can be user accounts, service accounts,
-      # Google groups, and domains (such as G Suite). A `role` is a named list of
-      # permissions; each `role` can be an IAM predefined role or a user-created
-      # custom role.
-      # For some types of Google Cloud resources, a `binding` can also specify a
-      # `condition`, which is a logical expression that allows access to a resource
-      # only if the expression evaluates to `true`. A condition can add constraints
-      # based on attributes of the request, the resource, or both. To learn which
-      # resources support conditions in their IAM policies, see the
-      # [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-
-      # policies).
-      # **JSON example:**
-      # `
-      # "bindings": [
-      # `
-      # "role": "roles/resourcemanager.organizationAdmin",
-      # "members": [
-      # "user:mike@example.com",
-      # "group:admins@example.com",
-      # "domain:google.com",
-      # "serviceAccount:my-project-id@appspot.gserviceaccount.com"
-      # ]
-      # `,
-      # `
-      # "role": "roles/resourcemanager.organizationViewer",
-      # "members": [
-      # "user:eve@example.com"
-      # ],
-      # "condition": `
-      # "title": "expirable access",
-      # "description": "Does not grant access after Sep 2020",
-      # "expression": "request.time < timestamp('2020-10-01T00:00:00.000Z')
-      # ",
-      # `
-      # `
-      # ],
-      # "etag": "BwWWja0YfJA=",
-      # "version": 3
-      # `
-      # **YAML example:**
-      # bindings:
-      # - members:
-      # - user:mike@example.com
-      # - group:admins@example.com
-      # - domain:google.com
-      # - serviceAccount:my-project-id@appspot.gserviceaccount.com
-      # role: roles/resourcemanager.organizationAdmin
-      # - members:
-      # - user:eve@example.com
-      # role: roles/resourcemanager.organizationViewer
-      # condition:
-      # title: expirable access
-      # description: Does not grant access after Sep 2020
-      # expression: request.time < timestamp('2020-10-01T00:00:00.000Z')
-      # - etag: BwWWja0YfJA=
-      # - version: 3
-      # For a description of IAM and its features, see the
-      # [IAM documentation](https://cloud.google.com/iam/docs/).
+      # controls for Google Cloud resources. A `Policy` is a collection of `bindings`.
+      # A `binding` binds one or more `members` to a single `role`. Members can be
+      # user accounts, service accounts, Google groups, and domains (such as G Suite).
+      # A `role` is a named list of permissions; each `role` can be an IAM predefined
+      # role or a user-created custom role. For some types of Google Cloud resources,
+      # a `binding` can also specify a `condition`, which is a logical expression that
+      # allows access to a resource only if the expression evaluates to `true`. A
+      # condition can add constraints based on attributes of the request, the resource,
+      # or both. To learn which resources support conditions in their IAM policies,
+      # see the [IAM documentation](https://cloud.google.com/iam/help/conditions/
+      # resource-policies). **JSON example:** ` "bindings": [ ` "role": "roles/
+      # resourcemanager.organizationAdmin", "members": [ "user:mike@example.com", "
+      # group:admins@example.com", "domain:google.com", "serviceAccount:my-project-id@
+      # appspot.gserviceaccount.com" ] `, ` "role": "roles/resourcemanager.
+      # organizationViewer", "members": [ "user:eve@example.com" ], "condition": ` "
+      # title": "expirable access", "description": "Does not grant access after Sep
+      # 2020", "expression": "request.time < timestamp('2020-10-01T00:00:00.000Z')", `
+      # ` ], "etag": "BwWWja0YfJA=", "version": 3 ` **YAML example:** bindings: -
+      # members: - user:mike@example.com - group:admins@example.com - domain:google.
+      # com - serviceAccount:my-project-id@appspot.gserviceaccount.com role: roles/
+      # resourcemanager.organizationAdmin - members: - user:eve@example.com role:
+      # roles/resourcemanager.organizationViewer condition: title: expirable access
+      # description: Does not grant access after Sep 2020 expression: request.time <
+      # timestamp('2020-10-01T00:00:00.000Z') - etag: BwWWja0YfJA= - version: 3 For a
+      # description of IAM and its features, see the [IAM documentation](https://cloud.
+      # google.com/iam/docs/).
       class Policy
         include Google::Apis::Core::Hashable
       
-        # Associates a list of `members` to a `role`. Optionally, may specify a
-        # `condition` that determines how and when the `bindings` are applied. Each
-        # of the `bindings` must contain at least one member.
+        # Associates a list of `members` to a `role`. Optionally, may specify a `
+        # condition` that determines how and when the `bindings` are applied. Each of
+        # the `bindings` must contain at least one member.
         # Corresponds to the JSON property `bindings`
         # @return [Array<Google::Apis::PubsubV1::Binding>]
         attr_accessor :bindings
       
-        # `etag` is used for optimistic concurrency control as a way to help
-        # prevent simultaneous updates of a policy from overwriting each other.
-        # It is strongly suggested that systems make use of the `etag` in the
-        # read-modify-write cycle to perform policy updates in order to avoid race
-        # conditions: An `etag` is returned in the response to `getIamPolicy`, and
-        # systems are expected to put that etag in the request to `setIamPolicy` to
-        # ensure that their change will be applied to the same version of the policy.
-        # **Important:** If you use IAM Conditions, you must include the `etag` field
-        # whenever you call `setIamPolicy`. If you omit this field, then IAM allows
-        # you to overwrite a version `3` policy with a version `1` policy, and all of
-        # the conditions in the version `3` policy are lost.
+        # `etag` is used for optimistic concurrency control as a way to help prevent
+        # simultaneous updates of a policy from overwriting each other. It is strongly
+        # suggested that systems make use of the `etag` in the read-modify-write cycle
+        # to perform policy updates in order to avoid race conditions: An `etag` is
+        # returned in the response to `getIamPolicy`, and systems are expected to put
+        # that etag in the request to `setIamPolicy` to ensure that their change will be
+        # applied to the same version of the policy. **Important:** If you use IAM
+        # Conditions, you must include the `etag` field whenever you call `setIamPolicy`.
+        # If you omit this field, then IAM allows you to overwrite a version `3` policy
+        # with a version `1` policy, and all of the conditions in the version `3` policy
+        # are lost.
         # Corresponds to the JSON property `etag`
         # NOTE: Values are automatically base64 encoded/decoded in the client library.
         # @return [String]
         attr_accessor :etag
       
-        # Specifies the format of the policy.
-        # Valid values are `0`, `1`, and `3`. Requests that specify an invalid value
-        # are rejected.
-        # Any operation that affects conditional role bindings must specify version
-        # `3`. This requirement applies to the following operations:
-        # * Getting a policy that includes a conditional role binding
-        # * Adding a conditional role binding to a policy
-        # * Changing a conditional role binding in a policy
-        # * Removing any role binding, with or without a condition, from a policy
-        # that includes conditions
-        # **Important:** If you use IAM Conditions, you must include the `etag` field
-        # whenever you call `setIamPolicy`. If you omit this field, then IAM allows
-        # you to overwrite a version `3` policy with a version `1` policy, and all of
-        # the conditions in the version `3` policy are lost.
-        # If a policy does not include any conditions, operations on that policy may
-        # specify any valid version 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).
+        # Specifies the format of the policy. Valid values are `0`, `1`, and `3`.
+        # Requests that specify an invalid value are rejected. Any operation that
+        # affects conditional role bindings must specify version `3`. This requirement
+        # applies to the following operations: * Getting a policy that includes a
+        # conditional role binding * Adding a conditional role binding to a policy *
+        # Changing a conditional role binding in a policy * Removing any role binding,
+        # with or without a condition, from a policy that includes conditions **
+        # Important:** If you use IAM Conditions, you must include the `etag` field
+        # whenever you call `setIamPolicy`. If you omit this field, then IAM allows you
+        # to overwrite a version `3` policy with a version `1` policy, and all of the
+        # conditions in the version `3` policy are lost. If a policy does not include
+        # any conditions, operations on that policy may specify any valid version 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).
         # Corresponds to the JSON property `version`
         # @return [Fixnum]
         attr_accessor :version
@@ -713,9 +647,8 @@ module Google
       class PublishResponse
         include Google::Apis::Core::Hashable
       
-        # The server-assigned ID of each published message, in the same order as
-        # the messages in the request. IDs are guaranteed to be unique within
-        # the topic.
+        # The server-assigned ID of each published message, in the same order as the
+        # messages in the request. IDs are guaranteed to be unique within the topic.
         # Corresponds to the JSON property `messageIds`
         # @return [Array<String>]
         attr_accessor :message_ids
@@ -732,24 +665,22 @@ module Google
       
       # A message that is published by publishers and consumed by subscribers. The
       # message must contain either a non-empty data field or at least one attribute.
-      # Note that client libraries represent this object differently
-      # depending on the language. See the corresponding [client library
-      # documentation](https://cloud.google.com/pubsub/docs/reference/libraries) for
-      # more information. See [quotas and limits]
-      # (https://cloud.google.com/pubsub/quotas) for more information about message
-      # limits.
+      # Note that client libraries represent this object differently depending on the
+      # language. See the corresponding [client library documentation](https://cloud.
+      # google.com/pubsub/docs/reference/libraries) for more information. See [quotas
+      # and limits] (https://cloud.google.com/pubsub/quotas) for more information
+      # about message limits.
       class Message
         include Google::Apis::Core::Hashable
       
-        # Attributes for this message. If this field is empty, the message must
-        # contain non-empty data. This can be used to filter messages on the
-        # subscription.
+        # Attributes for this message. If this field is empty, the message must contain
+        # non-empty data. This can be used to filter messages on the subscription.
         # Corresponds to the JSON property `attributes`
         # @return [Hash<String,String>]
         attr_accessor :attributes
       
-        # The message data field. If this field is empty, the message must contain
-        # at least one attribute.
+        # The message data field. If this field is empty, the message must contain at
+        # least one attribute.
         # Corresponds to the JSON property `data`
         # NOTE: Values are automatically base64 encoded/decoded in the client library.
         # @return [String]
@@ -766,16 +697,16 @@ module Google
         # If non-empty, identifies related messages for which publish order should be
         # respected. If a `Subscription` has `enable_message_ordering` set to `true`,
         # messages published with the same non-empty `ordering_key` value will be
-        # delivered to subscribers in the order in which they are received by the
-        # Pub/Sub system. All `PubsubMessage`s published in a given `PublishRequest`
-        # must specify the same `ordering_key` value.
+        # delivered to subscribers in the order in which they are received by the Pub/
+        # Sub system. All `PubsubMessage`s published in a given `PublishRequest` must
+        # specify the same `ordering_key` value.
         # Corresponds to the JSON property `orderingKey`
         # @return [String]
         attr_accessor :ordering_key
       
-        # The time at which the message was published, populated by the server when
-        # it receives the `Publish` call. It must not be populated by the
-        # publisher in a `Publish` call.
+        # The time at which the message was published, populated by the server when it
+        # receives the `Publish` call. It must not be populated by the publisher in a `
+        # Publish` call.
         # Corresponds to the JSON property `publishTime`
         # @return [String]
         attr_accessor :publish_time
@@ -806,13 +737,12 @@ module Google
         attr_accessor :max_messages
       
         # Optional. If this field set to true, the system will respond immediately even
-        # if
-        # it there are no messages available to return in the `Pull` response.
-        # Otherwise, the system may wait (for a bounded amount of time) until at
-        # least one message is available, rather than returning no messages. Warning:
-        # setting this field to `true` is discouraged because it adversely impacts
-        # the performance of `Pull` operations. We recommend that users do not set
-        # this field.
+        # if it there are no messages available to return in the `Pull` response.
+        # Otherwise, the system may wait (for a bounded amount of time) until at least
+        # one message is available, rather than returning no messages. Warning: setting
+        # this field to `true` is discouraged because it adversely impacts the
+        # performance of `Pull` operations. We recommend that users do not set this
+        # field.
         # Corresponds to the JSON property `returnImmediately`
         # @return [Boolean]
         attr_accessor :return_immediately
@@ -856,34 +786,30 @@ module Google
         include Google::Apis::Core::Hashable
       
         # Endpoint configuration attributes that can be used to control different
-        # aspects of the message delivery.
-        # The only currently supported attribute is `x-goog-version`, which you can
-        # use to change the format of the pushed message. This attribute
-        # indicates the version of the data expected by the endpoint. This
-        # controls the shape of the pushed message (i.e., its fields and metadata).
-        # If not present during the `CreateSubscription` call, it will default to
-        # the version of the Pub/Sub API used to make such call. If not present in a
-        # `ModifyPushConfig` call, its value will not be changed. `GetSubscription`
-        # calls will always return a valid version, even if the subscription was
-        # created without this attribute.
-        # The only supported values for the `x-goog-version` attribute are:
-        # * `v1beta1`: uses the push format defined in the v1beta1 Pub/Sub API.
-        # * `v1` or `v1beta2`: uses the push format defined in the v1 Pub/Sub API.
-        # For example:
-        # <pre><code>attributes ` "x-goog-version": "v1" ` </code></pre>
+        # aspects of the message delivery. The only currently supported attribute is `x-
+        # goog-version`, which you can use to change the format of the pushed message.
+        # This attribute indicates the version of the data expected by the endpoint.
+        # This controls the shape of the pushed message (i.e., its fields and metadata).
+        # If not present during the `CreateSubscription` call, it will default to the
+        # version of the Pub/Sub API used to make such call. If not present in a `
+        # ModifyPushConfig` call, its value will not be changed. `GetSubscription` calls
+        # will always return a valid version, even if the subscription was created
+        # without this attribute. The only supported values for the `x-goog-version`
+        # attribute are: * `v1beta1`: uses the push format defined in the v1beta1 Pub/
+        # Sub API. * `v1` or `v1beta2`: uses the push format defined in the v1 Pub/Sub
+        # API. For example: attributes ` "x-goog-version": "v1" `
         # Corresponds to the JSON property `attributes`
         # @return [Hash<String,String>]
         attr_accessor :attributes
       
-        # Contains information needed for generating an
-        # [OpenID Connect
-        # token](https://developers.google.com/identity/protocols/OpenIDConnect).
+        # Contains information needed for generating an [OpenID Connect token](https://
+        # developers.google.com/identity/protocols/OpenIDConnect).
         # Corresponds to the JSON property `oidcToken`
         # @return [Google::Apis::PubsubV1::OidcToken]
         attr_accessor :oidc_token
       
-        # A URL locating the endpoint to which messages should be pushed.
-        # For example, a Webhook endpoint might use `https://example.com/push`.
+        # A URL locating the endpoint to which messages should be pushed. For example, a
+        # Webhook endpoint might use `https://example.com/push`.
         # Corresponds to the JSON property `pushEndpoint`
         # @return [String]
         attr_accessor :push_endpoint
@@ -910,29 +836,26 @@ module Google
         attr_accessor :ack_id
       
         # The approximate number of times that Cloud Pub/Sub has attempted to deliver
-        # the associated message to a subscriber.
-        # More precisely, this is 1 + (number of NACKs) +
-        # (number of ack_deadline exceeds) for this message.
-        # A NACK is any call to ModifyAckDeadline with a 0 deadline. An ack_deadline
-        # exceeds event is whenever a message is not acknowledged within
-        # ack_deadline. Note that ack_deadline is initially
-        # Subscription.ackDeadlineSeconds, but may get extended automatically by
-        # the client library.
-        # Upon the first delivery of a given message, `delivery_attempt` will have a
-        # value of 1. The value is calculated at best effort and is approximate.
-        # If a DeadLetterPolicy is not set on the subscription, this will be 0.
+        # the associated message to a subscriber. More precisely, this is 1 + (number of
+        # NACKs) + (number of ack_deadline exceeds) for this message. A NACK is any call
+        # to ModifyAckDeadline with a 0 deadline. An ack_deadline exceeds event is
+        # whenever a message is not acknowledged within ack_deadline. Note that
+        # ack_deadline is initially Subscription.ackDeadlineSeconds, but may get
+        # extended automatically by the client library. Upon the first delivery of a
+        # given message, `delivery_attempt` will have a value of 1. The value is
+        # calculated at best effort and is approximate. If a DeadLetterPolicy is not set
+        # on the subscription, this will be 0.
         # Corresponds to the JSON property `deliveryAttempt`
         # @return [Fixnum]
         attr_accessor :delivery_attempt
       
         # A message that is published by publishers and consumed by subscribers. The
         # message must contain either a non-empty data field or at least one attribute.
-        # Note that client libraries represent this object differently
-        # depending on the language. See the corresponding [client library
-        # documentation](https://cloud.google.com/pubsub/docs/reference/libraries) for
-        # more information. See [quotas and limits]
-        # (https://cloud.google.com/pubsub/quotas) for more information about message
-        # limits.
+        # Note that client libraries represent this object differently depending on the
+        # language. See the corresponding [client library documentation](https://cloud.
+        # google.com/pubsub/docs/reference/libraries) for more information. See [quotas
+        # and limits] (https://cloud.google.com/pubsub/quotas) for more information
+        # about message limits.
         # Corresponds to the JSON property `message`
         # @return [Google::Apis::PubsubV1::Message]
         attr_accessor :message
@@ -949,25 +872,24 @@ module Google
         end
       end
       
-      # A policy that specifies how Cloud Pub/Sub retries message delivery.
-      # Retry delay will be exponential based on provided minimum and maximum
-      # backoffs. https://en.wikipedia.org/wiki/Exponential_backoff.
-      # RetryPolicy will be triggered on NACKs or acknowledgement deadline exceeded
-      # events for a given message.
-      # Retry Policy is implemented on a best effort basis. At times, the delay
-      # between consecutive deliveries may not match the configuration. That is,
+      # A policy that specifies how Cloud Pub/Sub retries message delivery. Retry
+      # delay will be exponential based on provided minimum and maximum backoffs.
+      # https://en.wikipedia.org/wiki/Exponential_backoff. RetryPolicy will be
+      # triggered on NACKs or acknowledgement deadline exceeded events for a given
+      # message. Retry Policy is implemented on a best effort basis. At times, the
+      # delay between consecutive deliveries may not match the configuration. That is,
       # delay can be more or less than configured backoff.
       class RetryPolicy
         include Google::Apis::Core::Hashable
       
-        # The maximum delay between consecutive deliveries of a given message.
-        # Value should be between 0 and 600 seconds. Defaults to 600 seconds.
+        # The maximum delay between consecutive deliveries of a given message. Value
+        # should be between 0 and 600 seconds. Defaults to 600 seconds.
         # Corresponds to the JSON property `maximumBackoff`
         # @return [String]
         attr_accessor :maximum_backoff
       
-        # The minimum delay between consecutive deliveries of a given message.
-        # Value should be between 0 and 600 seconds. Defaults to 10 seconds.
+        # The minimum delay between consecutive deliveries of a given message. Value
+        # should be between 0 and 600 seconds. Defaults to 10 seconds.
         # Corresponds to the JSON property `minimumBackoff`
         # @return [String]
         attr_accessor :minimum_backoff
@@ -987,24 +909,21 @@ module Google
       class SeekRequest
         include Google::Apis::Core::Hashable
       
-        # The snapshot to seek to. The snapshot's topic must be the same as that of
-        # the provided subscription.
-        # Format is `projects/`project`/snapshots/`snap``.
+        # The snapshot to seek to. The snapshot's topic must be the same as that of the
+        # provided subscription. Format is `projects/`project`/snapshots/`snap``.
         # Corresponds to the JSON property `snapshot`
         # @return [String]
         attr_accessor :snapshot
       
-        # The time to seek to.
-        # Messages retained in the subscription that were published before this
-        # time are marked as acknowledged, and messages retained in the
-        # subscription that were published after this time are marked as
-        # unacknowledged. Note that this operation affects only those messages
-        # retained in the subscription (configured by the combination of
-        # `message_retention_duration` and `retain_acked_messages`). For example,
-        # if `time` corresponds to a point before the message retention
-        # window (or to a point before the system's notion of the subscription
-        # creation time), only retained messages will be marked as unacknowledged,
-        # and already-expunged messages will not be restored.
+        # The time to seek to. Messages retained in the subscription that were published
+        # before this time are marked as acknowledged, and messages retained in the
+        # subscription that were published after this time are marked as unacknowledged.
+        # Note that this operation affects only those messages retained in the
+        # subscription (configured by the combination of `message_retention_duration`
+        # and `retain_acked_messages`). For example, if `time` corresponds to a point
+        # before the message retention window (or to a point before the system's notion
+        # of the subscription creation time), only retained messages will be marked as
+        # unacknowledged, and already-expunged messages will not be restored.
         # Corresponds to the JSON property `time`
         # @return [String]
         attr_accessor :time
@@ -1038,66 +957,32 @@ module Google
         include Google::Apis::Core::Hashable
       
         # An Identity and Access Management (IAM) policy, which specifies access
-        # controls for Google Cloud resources.
-        # A `Policy` is a collection of `bindings`. A `binding` binds one or more
-        # `members` to a single `role`. Members can be user accounts, service accounts,
-        # Google groups, and domains (such as G Suite). A `role` is a named list of
-        # permissions; each `role` can be an IAM predefined role or a user-created
-        # custom role.
-        # For some types of Google Cloud resources, a `binding` can also specify a
-        # `condition`, which is a logical expression that allows access to a resource
-        # only if the expression evaluates to `true`. A condition can add constraints
-        # based on attributes of the request, the resource, or both. To learn which
-        # resources support conditions in their IAM policies, see the
-        # [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-
-        # policies).
-        # **JSON example:**
-        # `
-        # "bindings": [
-        # `
-        # "role": "roles/resourcemanager.organizationAdmin",
-        # "members": [
-        # "user:mike@example.com",
-        # "group:admins@example.com",
-        # "domain:google.com",
-        # "serviceAccount:my-project-id@appspot.gserviceaccount.com"
-        # ]
-        # `,
-        # `
-        # "role": "roles/resourcemanager.organizationViewer",
-        # "members": [
-        # "user:eve@example.com"
-        # ],
-        # "condition": `
-        # "title": "expirable access",
-        # "description": "Does not grant access after Sep 2020",
-        # "expression": "request.time < timestamp('2020-10-01T00:00:00.000Z')
-        # ",
-        # `
-        # `
-        # ],
-        # "etag": "BwWWja0YfJA=",
-        # "version": 3
-        # `
-        # **YAML example:**
-        # bindings:
-        # - members:
-        # - user:mike@example.com
-        # - group:admins@example.com
-        # - domain:google.com
-        # - serviceAccount:my-project-id@appspot.gserviceaccount.com
-        # role: roles/resourcemanager.organizationAdmin
-        # - members:
-        # - user:eve@example.com
-        # role: roles/resourcemanager.organizationViewer
-        # condition:
-        # title: expirable access
-        # description: Does not grant access after Sep 2020
-        # expression: request.time < timestamp('2020-10-01T00:00:00.000Z')
-        # - etag: BwWWja0YfJA=
-        # - version: 3
-        # For a description of IAM and its features, see the
-        # [IAM documentation](https://cloud.google.com/iam/docs/).
+        # controls for Google Cloud resources. A `Policy` is a collection of `bindings`.
+        # A `binding` binds one or more `members` to a single `role`. Members can be
+        # user accounts, service accounts, Google groups, and domains (such as G Suite).
+        # A `role` is a named list of permissions; each `role` can be an IAM predefined
+        # role or a user-created custom role. For some types of Google Cloud resources,
+        # a `binding` can also specify a `condition`, which is a logical expression that
+        # allows access to a resource only if the expression evaluates to `true`. A
+        # condition can add constraints based on attributes of the request, the resource,
+        # or both. To learn which resources support conditions in their IAM policies,
+        # see the [IAM documentation](https://cloud.google.com/iam/help/conditions/
+        # resource-policies). **JSON example:** ` "bindings": [ ` "role": "roles/
+        # resourcemanager.organizationAdmin", "members": [ "user:mike@example.com", "
+        # group:admins@example.com", "domain:google.com", "serviceAccount:my-project-id@
+        # appspot.gserviceaccount.com" ] `, ` "role": "roles/resourcemanager.
+        # organizationViewer", "members": [ "user:eve@example.com" ], "condition": ` "
+        # title": "expirable access", "description": "Does not grant access after Sep
+        # 2020", "expression": "request.time < timestamp('2020-10-01T00:00:00.000Z')", `
+        # ` ], "etag": "BwWWja0YfJA=", "version": 3 ` **YAML example:** bindings: -
+        # members: - user:mike@example.com - group:admins@example.com - domain:google.
+        # com - serviceAccount:my-project-id@appspot.gserviceaccount.com role: roles/
+        # resourcemanager.organizationAdmin - members: - user:eve@example.com role:
+        # roles/resourcemanager.organizationViewer condition: title: expirable access
+        # description: Does not grant access after Sep 2020 expression: request.time <
+        # timestamp('2020-10-01T00:00:00.000Z') - etag: BwWWja0YfJA= - version: 3 For a
+        # description of IAM and its features, see the [IAM documentation](https://cloud.
+        # google.com/iam/docs/).
         # Corresponds to the JSON property `policy`
         # @return [Google::Apis::PubsubV1::Policy]
         attr_accessor :policy
@@ -1112,30 +997,29 @@ module Google
         end
       end
       
-      # A snapshot resource. Snapshots are used in
-      # [Seek](https://cloud.google.com/pubsub/docs/replay-overview)
-      # operations, which allow you to manage message acknowledgments in bulk. That
-      # is, you can set the acknowledgment state of messages in an existing
-      # subscription to the state captured by a snapshot.
+      # A snapshot resource. Snapshots are used in [Seek](https://cloud.google.com/
+      # pubsub/docs/replay-overview) operations, which allow you to manage message
+      # acknowledgments in bulk. That is, you can set the acknowledgment state of
+      # messages in an existing subscription to the state captured by a snapshot.
       class Snapshot
         include Google::Apis::Core::Hashable
       
-        # The snapshot is guaranteed to exist up until this time.
-        # A newly-created snapshot expires no later than 7 days from the time of its
-        # creation. Its exact lifetime is determined at creation by the existing
-        # backlog in the source subscription. Specifically, the lifetime of the
-        # snapshot is `7 days - (age of oldest unacked message in the subscription)`.
-        # For example, consider a subscription whose oldest unacked message is 3 days
-        # old. If a snapshot is created from this subscription, the snapshot -- which
-        # will always capture this 3-day-old backlog as long as the snapshot
-        # exists -- will expire in 4 days. The service will refuse to create a
-        # snapshot that would expire in less than 1 hour after creation.
+        # The snapshot is guaranteed to exist up until this time. A newly-created
+        # snapshot expires no later than 7 days from the time of its creation. Its exact
+        # lifetime is determined at creation by the existing backlog in the source
+        # subscription. Specifically, the lifetime of the snapshot is `7 days - (age of
+        # oldest unacked message in the subscription)`. For example, consider a
+        # subscription whose oldest unacked message is 3 days old. If a snapshot is
+        # created from this subscription, the snapshot -- which will always capture this
+        # 3-day-old backlog as long as the snapshot exists -- will expire in 4 days. The
+        # service will refuse to create a snapshot that would expire in less than 1 hour
+        # after creation.
         # Corresponds to the JSON property `expireTime`
         # @return [String]
         attr_accessor :expire_time
       
-        # See [Creating and managing labels]
-        # (https://cloud.google.com/pubsub/docs/labels).
+        # See [Creating and managing labels] (https://cloud.google.com/pubsub/docs/
+        # labels).
         # Corresponds to the JSON property `labels`
         # @return [Hash<String,String>]
         attr_accessor :labels
@@ -1167,39 +1051,46 @@ module Google
       class Subscription
         include Google::Apis::Core::Hashable
       
-        # The approximate amount of time (on a best-effort basis) Pub/Sub waits for
-        # the subscriber to acknowledge receipt before resending the message. In the
-        # interval after the message is delivered and before it is acknowledged, it
-        # is considered to be <i>outstanding</i>. During that time period, the
-        # message will not be redelivered (on a best-effort basis).
-        # For pull subscriptions, this value is used as the initial value for the ack
-        # deadline. To override this value for a given message, call
-        # `ModifyAckDeadline` with the corresponding `ack_id` if using
-        # non-streaming pull or send the `ack_id` in a
-        # `StreamingModifyAckDeadlineRequest` if using streaming pull.
-        # The minimum custom deadline you can specify is 10 seconds.
-        # The maximum custom deadline you can specify is 600 seconds (10 minutes).
-        # If this parameter is 0, a default value of 10 seconds is used.
-        # For push delivery, this value is also used to set the request timeout for
-        # the call to the push endpoint.
-        # If the subscriber never acknowledges the message, the Pub/Sub
-        # system will eventually redeliver the message.
+        # The approximate amount of time (on a best-effort basis) Pub/Sub waits for the
+        # subscriber to acknowledge receipt before resending the message. In the
+        # interval after the message is delivered and before it is acknowledged, it is
+        # considered to be *outstanding*. During that time period, the message will not
+        # be redelivered (on a best-effort basis). For pull subscriptions, this value is
+        # used as the initial value for the ack deadline. To override this value for a
+        # given message, call `ModifyAckDeadline` with the corresponding `ack_id` if
+        # using non-streaming pull or send the `ack_id` in a `
+        # StreamingModifyAckDeadlineRequest` if using streaming pull. The minimum custom
+        # deadline you can specify is 10 seconds. The maximum custom deadline you can
+        # specify is 600 seconds (10 minutes). If this parameter is 0, a default value
+        # of 10 seconds is used. For push delivery, this value is also used to set the
+        # request timeout for the call to the push endpoint. If the subscriber never
+        # acknowledges the message, the Pub/Sub system will eventually redeliver the
+        # message.
         # Corresponds to the JSON property `ackDeadlineSeconds`
         # @return [Fixnum]
         attr_accessor :ack_deadline_seconds
       
-        # Dead lettering is done on a best effort basis. The same message might be
-        # dead lettered multiple times.
-        # If validation on any of the fields fails at subscription creation/updation,
-        # the create/update subscription request will fail.
+        # Dead lettering is done on a best effort basis. The same message might be dead
+        # lettered multiple times. If validation on any of the fields fails at
+        # subscription creation/updation, the create/update subscription request will
+        # fail.
         # Corresponds to the JSON property `deadLetterPolicy`
         # @return [Google::Apis::PubsubV1::DeadLetterPolicy]
         attr_accessor :dead_letter_policy
       
+        # Indicates whether the subscription is detached from its topic. Detached
+        # subscriptions don't receive messages from their topic and don't retain any
+        # backlog. `Pull` and `StreamingPull` requests will return FAILED_PRECONDITION.
+        # If the subscription is a push subscription, pushes to the endpoint will not be
+        # made.
+        # Corresponds to the JSON property `detached`
+        # @return [Boolean]
+        attr_accessor :detached
+        alias_method :detached?, :detached
+      
         # If true, messages published with the same `ordering_key` in `PubsubMessage`
-        # will be delivered to the subscribers in the order in which they
-        # are received by the Pub/Sub system. Otherwise, they may be delivered in
-        # any order.
+        # will be delivered to the subscribers in the order in which they are received
+        # by the Pub/Sub system. Otherwise, they may be delivered in any order.
         # Corresponds to the JSON property `enableMessageOrdering`
         # @return [Boolean]
         attr_accessor :enable_message_ordering
@@ -1211,37 +1102,34 @@ module Google
         # @return [Google::Apis::PubsubV1::ExpirationPolicy]
         attr_accessor :expiration_policy
       
-        # An expression written in the Pub/Sub [filter
-        # language](https://cloud.google.com/pubsub/docs/filtering). If non-empty,
-        # then only `PubsubMessage`s whose `attributes` field matches the filter are
-        # delivered on this subscription. If empty, then no messages are filtered
-        # out.
+        # An expression written in the Pub/Sub [filter language](https://cloud.google.
+        # com/pubsub/docs/filtering). If non-empty, then only `PubsubMessage`s whose `
+        # attributes` field matches the filter are delivered on this subscription. If
+        # empty, then no messages are filtered out.
         # Corresponds to the JSON property `filter`
         # @return [String]
         attr_accessor :filter
       
-        # See <a href="https://cloud.google.com/pubsub/docs/labels"> Creating and
-        # managing labels</a>.
+        # See Creating and managing labels.
         # Corresponds to the JSON property `labels`
         # @return [Hash<String,String>]
         attr_accessor :labels
       
-        # How long to retain unacknowledged messages in the subscription's backlog,
-        # from the moment a message is published.
-        # If `retain_acked_messages` is true, then this also configures the retention
-        # of acknowledged messages, and thus configures how far back in time a `Seek`
-        # can be done. Defaults to 7 days. Cannot be more than 7 days or less than 10
-        # minutes.
+        # How long to retain unacknowledged messages in the subscription's backlog, from
+        # the moment a message is published. If `retain_acked_messages` is true, then
+        # this also configures the retention of acknowledged messages, and thus
+        # configures how far back in time a `Seek` can be done. Defaults to 7 days.
+        # Cannot be more than 7 days or less than 10 minutes.
         # Corresponds to the JSON property `messageRetentionDuration`
         # @return [String]
         attr_accessor :message_retention_duration
       
-        # Required. The name of the subscription. It must have the format
-        # `"projects/`project`/subscriptions/`subscription`"`. ``subscription`` must
-        # start with a letter, and contain only letters (`[A-Za-z]`), numbers
-        # (`[0-9]`), dashes (`-`), underscores (`_`), periods (`.`), tildes (`~`),
-        # plus (`+`) or percent signs (`%`). It must be between 3 and 255 characters
-        # in length, and it must not start with `"goog"`.
+        # Required. The name of the subscription. It must have the format `"projects/`
+        # project`/subscriptions/`subscription`"`. ``subscription`` must start with a
+        # letter, and contain only letters (`[A-Za-z]`), numbers (`[0-9]`), dashes (`-`),
+        # underscores (`_`), periods (`.`), tildes (`~`), plus (`+`) or percent signs (`
+        # %`). It must be between 3 and 255 characters in length, and it must not start
+        # with `"goog"`.
         # Corresponds to the JSON property `name`
         # @return [String]
         attr_accessor :name
@@ -1251,33 +1139,30 @@ module Google
         # @return [Google::Apis::PubsubV1::PushConfig]
         attr_accessor :push_config
       
-        # Indicates whether to retain acknowledged messages. If true, then
-        # messages are not expunged from the subscription's backlog, even if they are
-        # acknowledged, until they fall out of the `message_retention_duration`
-        # window. This must be true if you would like to [Seek to a timestamp]
-        # (https://cloud.google.com/pubsub/docs/replay-overview#seek_to_a_time).
+        # Indicates whether to retain acknowledged messages. If true, then messages are
+        # not expunged from the subscription's backlog, even if they are acknowledged,
+        # until they fall out of the `message_retention_duration` window. This must be
+        # true if you would like to [Seek to a timestamp] (https://cloud.google.com/
+        # pubsub/docs/replay-overview#seek_to_a_time).
         # Corresponds to the JSON property `retainAckedMessages`
         # @return [Boolean]
         attr_accessor :retain_acked_messages
         alias_method :retain_acked_messages?, :retain_acked_messages
       
-        # A policy that specifies how Cloud Pub/Sub retries message delivery.
-        # Retry delay will be exponential based on provided minimum and maximum
-        # backoffs. https://en.wikipedia.org/wiki/Exponential_backoff.
-        # RetryPolicy will be triggered on NACKs or acknowledgement deadline exceeded
-        # events for a given message.
-        # Retry Policy is implemented on a best effort basis. At times, the delay
-        # between consecutive deliveries may not match the configuration. That is,
+        # A policy that specifies how Cloud Pub/Sub retries message delivery. Retry
+        # delay will be exponential based on provided minimum and maximum backoffs.
+        # https://en.wikipedia.org/wiki/Exponential_backoff. RetryPolicy will be
+        # triggered on NACKs or acknowledgement deadline exceeded events for a given
+        # message. Retry Policy is implemented on a best effort basis. At times, the
+        # delay between consecutive deliveries may not match the configuration. That is,
         # delay can be more or less than configured backoff.
         # Corresponds to the JSON property `retryPolicy`
         # @return [Google::Apis::PubsubV1::RetryPolicy]
         attr_accessor :retry_policy
       
         # Required. The name of the topic from which this subscription is receiving
-        # messages.
-        # Format is `projects/`project`/topics/`topic``.
-        # The value of this field will be `_deleted-topic_` if the topic has been
-        # deleted.
+        # messages. Format is `projects/`project`/topics/`topic``. The value of this
+        # field will be `_deleted-topic_` if the topic has been deleted.
         # Corresponds to the JSON property `topic`
         # @return [String]
         attr_accessor :topic
@@ -1290,6 +1175,7 @@ module Google
         def update!(**args)
           @ack_deadline_seconds = args[:ack_deadline_seconds] if args.key?(:ack_deadline_seconds)
           @dead_letter_policy = args[:dead_letter_policy] if args.key?(:dead_letter_policy)
+          @detached = args[:detached] if args.key?(:detached)
           @enable_message_ordering = args[:enable_message_ordering] if args.key?(:enable_message_ordering)
           @expiration_policy = args[:expiration_policy] if args.key?(:expiration_policy)
           @filter = args[:filter] if args.key?(:filter)
@@ -1307,10 +1193,9 @@ module Google
       class TestIamPermissionsRequest
         include Google::Apis::Core::Hashable
       
-        # The set of permissions to check for the `resource`. Permissions with
-        # wildcards (such as '*' or 'storage.*') are not allowed. For more
-        # information see
-        # [IAM Overview](https://cloud.google.com/iam/docs/overview#permissions).
+        # The set of permissions to check for the `resource`. Permissions with wildcards
+        # (such as '*' or 'storage.*') are not allowed. For more information see [IAM
+        # Overview](https://cloud.google.com/iam/docs/overview#permissions).
         # Corresponds to the JSON property `permissions`
         # @return [Array<String>]
         attr_accessor :permissions
@@ -1329,8 +1214,7 @@ module Google
       class TestIamPermissionsResponse
         include Google::Apis::Core::Hashable
       
-        # A subset of `TestPermissionsRequest.permissions` that the caller is
-        # allowed.
+        # A subset of `TestPermissionsRequest.permissions` that the caller is allowed.
         # Corresponds to the JSON property `permissions`
         # @return [Array<String>]
         attr_accessor :permissions
@@ -1349,15 +1233,15 @@ module Google
       class Topic
         include Google::Apis::Core::Hashable
       
-        # The resource name of the Cloud KMS CryptoKey to be used to protect access
-        # to messages published on this topic.
-        # The expected format is `projects/*/locations/*/keyRings/*/cryptoKeys/*`.
+        # The resource name of the Cloud KMS CryptoKey to be used to protect access to
+        # messages published on this topic. The expected format is `projects/*/locations/
+        # */keyRings/*/cryptoKeys/*`.
         # Corresponds to the JSON property `kmsKeyName`
         # @return [String]
         attr_accessor :kms_key_name
       
-        # See [Creating and managing labels]
-        # (https://cloud.google.com/pubsub/docs/labels).
+        # See [Creating and managing labels] (https://cloud.google.com/pubsub/docs/
+        # labels).
         # Corresponds to the JSON property `labels`
         # @return [Hash<String,String>]
         attr_accessor :labels
@@ -1367,12 +1251,11 @@ module Google
         # @return [Google::Apis::PubsubV1::MessageStoragePolicy]
         attr_accessor :message_storage_policy
       
-        # Required. The name of the topic. It must have the format
-        # `"projects/`project`/topics/`topic`"`. ``topic`` must start with a letter,
-        # and contain only letters (`[A-Za-z]`), numbers (`[0-9]`), dashes (`-`),
-        # underscores (`_`), periods (`.`), tildes (`~`), plus (`+`) or percent
-        # signs (`%`). It must be between 3 and 255 characters in length, and it
-        # must not start with `"goog"`.
+        # Required. The name of the topic. It must have the format `"projects/`project`/
+        # topics/`topic`"`. ``topic`` must start with a letter, and contain only letters
+        # (`[A-Za-z]`), numbers (`[0-9]`), dashes (`-`), underscores (`_`), periods (`.`)
+        # , tildes (`~`), plus (`+`) or percent signs (`%`). It must be between 3 and
+        # 255 characters in length, and it must not start with `"goog"`.
         # Corresponds to the JSON property `name`
         # @return [String]
         attr_accessor :name
@@ -1394,17 +1277,16 @@ module Google
       class UpdateSnapshotRequest
         include Google::Apis::Core::Hashable
       
-        # A snapshot resource. Snapshots are used in
-        # [Seek](https://cloud.google.com/pubsub/docs/replay-overview)
-        # operations, which allow you to manage message acknowledgments in bulk. That
-        # is, you can set the acknowledgment state of messages in an existing
-        # subscription to the state captured by a snapshot.
+        # A snapshot resource. Snapshots are used in [Seek](https://cloud.google.com/
+        # pubsub/docs/replay-overview) operations, which allow you to manage message
+        # acknowledgments in bulk. That is, you can set the acknowledgment state of
+        # messages in an existing subscription to the state captured by a snapshot.
         # Corresponds to the JSON property `snapshot`
         # @return [Google::Apis::PubsubV1::Snapshot]
         attr_accessor :snapshot
       
-        # Required. Indicates which fields in the provided snapshot to update.
-        # Must be specified and non-empty.
+        # Required. Indicates which fields in the provided snapshot to update. Must be
+        # specified and non-empty.
         # Corresponds to the JSON property `updateMask`
         # @return [String]
         attr_accessor :update_mask
@@ -1429,8 +1311,8 @@ module Google
         # @return [Google::Apis::PubsubV1::Subscription]
         attr_accessor :subscription
       
-        # Required. Indicates which fields in the provided subscription to update.
-        # Must be specified and non-empty.
+        # Required. Indicates which fields in the provided subscription to update. Must
+        # be specified and non-empty.
         # Corresponds to the JSON property `updateMask`
         # @return [String]
         attr_accessor :update_mask
@@ -1456,11 +1338,10 @@ module Google
         attr_accessor :topic
       
         # Required. Indicates which fields in the provided topic to update. Must be
-        # specified
-        # and non-empty. Note that if `update_mask` contains
-        # "message_storage_policy" but the `message_storage_policy` is not set in
-        # the `topic` provided above, then the updated value is determined by the
-        # policy configured at the project or organization level.
+        # specified and non-empty. Note that if `update_mask` contains "
+        # message_storage_policy" but the `message_storage_policy` is not set in the `
+        # topic` provided above, then the updated value is determined by the policy
+        # configured at the project or organization level.
         # Corresponds to the JSON property `updateMask`
         # @return [String]
         attr_accessor :update_mask