google-api-client 0.42.0 → 0.44.1

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

@@ -411,6 +411,7 @@ module Google
           hash :attributes, as: 'attributes'
           property :data, :base64 => true, as: 'data'
           property :message_id, as: 'messageId'
+          property :ordering_key, as: 'orderingKey'
           property :publish_time, as: 'publishTime'
         end
       end
@@ -497,6 +498,8 @@ module Google
           property :ack_deadline_seconds, as: 'ackDeadlineSeconds'
           property :dead_letter_policy, as: 'deadLetterPolicy', class: Google::Apis::PubsubV1::DeadLetterPolicy, decorator: Google::Apis::PubsubV1::DeadLetterPolicy::Representation
       
+          property :detached, as: 'detached'
+          property :enable_message_ordering, as: 'enableMessageOrdering'
           property :expiration_policy, as: 'expirationPolicy', class: Google::Apis::PubsubV1::ExpirationPolicy, decorator: Google::Apis::PubsubV1::ExpirationPolicy::Representation
       
           property :filter, as: 'filter'

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

@@ -47,30 +47,26 @@ module Google
           @batch_path = 'batch'
         end
         
-        # Creates a snapshot from the requested subscription. 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.
-        # If the snapshot already exists, returns `ALREADY_EXISTS`.
-        # If the requested subscription doesn't exist, returns `NOT_FOUND`.
-        # If the backlog in the subscription is too old -- and the resulting snapshot
-        # would expire in less than 1 hour -- then `FAILED_PRECONDITION` is returned.
-        # See also the `Snapshot.expire_time` field. If the name is not provided in
-        # the request, the server will assign a random
-        # name for this snapshot on the same project as the subscription, conforming
-        # to the [resource name format]
-        # (https://cloud.google.com/pubsub/docs/admin#resource_names). The
+        # Creates a snapshot from the requested subscription. 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. If the snapshot already exists, returns `
+        # ALREADY_EXISTS`. If the requested subscription doesn't exist, returns `
+        # NOT_FOUND`. If the backlog in the subscription is too old -- and the resulting
+        # snapshot would expire in less than 1 hour -- then `FAILED_PRECONDITION` is
+        # returned. See also the `Snapshot.expire_time` field. If the name is not
+        # provided in the request, the server will assign a random name for this
+        # snapshot on the same project as the subscription, conforming to the [resource
+        # name format] (https://cloud.google.com/pubsub/docs/admin#resource_names). The
         # generated name is populated in the returned Snapshot object. Note that for
         # REST API requests, you must specify a name in the request.
         # @param [String] name
         #   Required. User-provided name for this snapshot. If the name is not provided in
-        #   the
-        #   request, the server will assign a random name for this snapshot on the same
-        #   project as the subscription. Note that for REST API requests, you must
-        #   specify a name.  See the <a
-        #   href="https://cloud.google.com/pubsub/docs/admin#resource_names"> resource
-        #   name rules</a>. Format is `projects/`project`/snapshots/`snap``.
+        #   the request, the server will assign a random name for this snapshot on the
+        #   same project as the subscription. Note that for REST API requests, you must
+        #   specify a name. See the resource name rules. Format is `projects/`project`/
+        #   snapshots/`snap``.
         # @param [Google::Apis::PubsubV1::CreateSnapshotRequest] create_snapshot_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -101,18 +97,17 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Removes an existing snapshot. 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.
-        # When the snapshot is deleted, all messages retained in the snapshot
-        # are immediately dropped. After a snapshot is deleted, a new one may be
-        # created with the same name, but the new one has no association with the old
-        # snapshot or its subscription, unless the same subscription is specified.
+        # Removes an existing snapshot. 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.
+        # When the snapshot is deleted, all messages retained in the snapshot are
+        # immediately dropped. After a snapshot is deleted, a new one may be created
+        # with the same name, but the new one has no association with the old snapshot
+        # or its subscription, unless the same subscription is specified.
         # @param [String] snapshot
-        #   Required. The name of the snapshot to delete.
-        #   Format is `projects/`project`/snapshots/`snap``.
+        #   Required. The name of the snapshot to delete. Format is `projects/`project`/
+        #   snapshots/`snap``.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -140,14 +135,13 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Gets the configuration details of a snapshot. Snapshots are used in
-        # <a href="https://cloud.google.com/pubsub/docs/replay-overview">Seek</a>
-        # 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.
+        # Gets the configuration details of a snapshot. Snapshots are used in Seek
+        # 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.
         # @param [String] snapshot
-        #   Required. The name of the snapshot to get.
-        #   Format is `projects/`project`/snapshots/`snap``.
+        #   Required. The name of the snapshot to get. Format is `projects/`project`/
+        #   snapshots/`snap``.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -175,22 +169,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
@@ -219,20 +210,19 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Lists the existing snapshots. 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.
+        # Lists the existing snapshots. 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.
         # @param [String] project
-        #   Required. The name of the project in which to list snapshots.
-        #   Format is `projects/`project-id``.
+        #   Required. The name of the project in which to list snapshots. Format is `
+        #   projects/`project-id``.
         # @param [Fixnum] page_size
         #   Maximum number of snapshots to return.
         # @param [String] page_token
-        #   The value returned by the last `ListSnapshotsResponse`; indicates that this
-        #   is a continuation of a prior `ListSnapshots` call, and that the system
-        #   should return the next page of data.
+        #   The value returned by the last `ListSnapshotsResponse`; indicates that this is
+        #   a continuation of a prior `ListSnapshots` call, and that the system should
+        #   return the next page of data.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -262,10 +252,8 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Updates an existing snapshot. Snapshots are used in
-        # <a href="https://cloud.google.com/pubsub/docs/replay-overview">Seek</a>
-        # operations, which allow
-        # you to manage message acknowledgments in bulk. That is, you can set the
+        # Updates an existing snapshot. Snapshots are used in Seek 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.
         # @param [String] name
@@ -301,11 +289,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::PubsubV1::SetIamPolicyRequest] set_iam_policy_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -336,15 +324,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::PubsubV1::TestIamPermissionsRequest] test_iam_permissions_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -375,15 +362,14 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Acknowledges the messages associated with the `ack_ids` in the
-        # `AcknowledgeRequest`. The Pub/Sub system can remove the relevant messages
-        # from the subscription.
-        # Acknowledging a message whose ack deadline has expired may succeed,
-        # but such a message may be redelivered later. Acknowledging a message more
-        # than once will not result in an error.
+        # Acknowledges the messages associated with the `ack_ids` in the `
+        # AcknowledgeRequest`. The Pub/Sub system can remove the relevant messages from
+        # the subscription. Acknowledging a message whose ack deadline has expired may
+        # succeed, but such a message may be redelivered later. Acknowledging a message
+        # more than once will not result in an error.
         # @param [String] subscription
-        #   Required. The subscription whose message is being acknowledged.
-        #   Format is `projects/`project`/subscriptions/`sub``.
+        #   Required. The subscription whose message is being acknowledged. Format is `
+        #   projects/`project`/subscriptions/`sub``.
         # @param [Google::Apis::PubsubV1::AcknowledgeRequest] acknowledge_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -414,23 +400,22 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Creates a subscription to a given topic. See the [resource name rules]
-        # (https://cloud.google.com/pubsub/docs/admin#resource_names).
-        # If the subscription already exists, returns `ALREADY_EXISTS`.
-        # If the corresponding topic doesn't exist, returns `NOT_FOUND`.
-        # If the name is not provided in the request, the server will assign a random
-        # name for this subscription on the same project as the topic, conforming
-        # to the [resource name format]
-        # (https://cloud.google.com/pubsub/docs/admin#resource_names). The generated
-        # name is populated in the returned Subscription object. Note that for REST
-        # API requests, you must specify a name in the request.
+        # Creates a subscription to a given topic. See the [resource name rules] (https:/
+        # /cloud.google.com/pubsub/docs/admin#resource_names). If the subscription
+        # already exists, returns `ALREADY_EXISTS`. If the corresponding topic doesn't
+        # exist, returns `NOT_FOUND`. If the name is not provided in the request, the
+        # server will assign a random name for this subscription on the same project as
+        # the topic, conforming to the [resource name format] (https://cloud.google.com/
+        # pubsub/docs/admin#resource_names). The generated name is populated in the
+        # returned Subscription object. Note that for REST API requests, you must
+        # specify a name in the request.
         # @param [String] name
-        #   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"`.
         # @param [Google::Apis::PubsubV1::Subscription] subscription_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -462,13 +447,13 @@ module Google
         end
         
         # Deletes an existing subscription. All messages retained in the subscription
-        # are immediately dropped. Calls to `Pull` after deletion will return
-        # `NOT_FOUND`. After a subscription is deleted, a new one may be created with
-        # the same name, but the new one has no association with the old
-        # subscription or its topic unless the same topic is specified.
+        # are immediately dropped. Calls to `Pull` after deletion will return `NOT_FOUND`
+        # . After a subscription is deleted, a new one may be created with the same name,
+        # but the new one has no association with the old subscription or its topic
+        # unless the same topic is specified.
         # @param [String] subscription
-        #   Required. The subscription to delete.
-        #   Format is `projects/`project`/subscriptions/`sub``.
+        #   Required. The subscription to delete. Format is `projects/`project`/
+        #   subscriptions/`sub``.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -497,12 +482,12 @@ module Google
         end
         
         # Detaches a subscription from this topic. All messages retained in the
-        # subscription are dropped. Subsequent `Pull` and `StreamingPull` requests
-        # will return FAILED_PRECONDITION. If the subscription is a push
-        # subscription, pushes to the endpoint will stop.
+        # subscription are dropped. Subsequent `Pull` and `StreamingPull` requests will
+        # return FAILED_PRECONDITION. If the subscription is a push subscription, pushes
+        # to the endpoint will stop.
         # @param [String] subscription
-        #   Required. The subscription to detach.
-        #   Format is `projects/`project`/subscriptions/`subscription``.
+        #   Required. The subscription to detach. Format is `projects/`project`/
+        #   subscriptions/`subscription``.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -532,8 +517,8 @@ module Google
         
         # Gets the configuration details of a subscription.
         # @param [String] subscription
-        #   Required. The name of the subscription to get.
-        #   Format is `projects/`project`/subscriptions/`sub``.
+        #   Required. The name of the subscription to get. Format is `projects/`project`/
+        #   subscriptions/`sub``.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -561,22 +546,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
@@ -607,8 +589,8 @@ module Google
         
         # Lists matching subscriptions.
         # @param [String] project
-        #   Required. The name of the project in which to list subscriptions.
-        #   Format is `projects/`project-id``.
+        #   Required. The name of the project in which to list subscriptions. Format is `
+        #   projects/`project-id``.
         # @param [Fixnum] page_size
         #   Maximum number of subscriptions to return.
         # @param [String] page_token
@@ -644,14 +626,14 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Modifies the ack deadline for a specific message. This method is useful
-        # to indicate that more time is needed to process a message by the
-        # subscriber, or to make the message available for redelivery if the
-        # processing was interrupted. Note that this does not modify the
-        # subscription-level `ackDeadlineSeconds` used for subsequent messages.
+        # Modifies the ack deadline for a specific message. This method is useful to
+        # indicate that more time is needed to process a message by the subscriber, or
+        # to make the message available for redelivery if the processing was interrupted.
+        # Note that this does not modify the subscription-level `ackDeadlineSeconds`
+        # used for subsequent messages.
         # @param [String] subscription
-        #   Required. The name of the subscription.
-        #   Format is `projects/`project`/subscriptions/`sub``.
+        #   Required. The name of the subscription. Format is `projects/`project`/
+        #   subscriptions/`sub``.
         # @param [Google::Apis::PubsubV1::ModifyAckDeadlineRequest] modify_ack_deadline_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -682,14 +664,14 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Modifies the `PushConfig` for a specified subscription.
-        # This may be used to change a push subscription to a pull one (signified by
-        # an empty `PushConfig`) or vice versa, or change the endpoint URL and other
-        # attributes of a push subscription. Messages will accumulate for delivery
-        # continuously through the call regardless of changes to the `PushConfig`.
+        # Modifies the `PushConfig` for a specified subscription. This may be used to
+        # change a push subscription to a pull one (signified by an empty `PushConfig`)
+        # or vice versa, or change the endpoint URL and other attributes of a push
+        # subscription. Messages will accumulate for delivery continuously through the
+        # call regardless of changes to the `PushConfig`.
         # @param [String] subscription
-        #   Required. The name of the subscription.
-        #   Format is `projects/`project`/subscriptions/`sub``.
+        #   Required. The name of the subscription. Format is `projects/`project`/
+        #   subscriptions/`sub``.
         # @param [Google::Apis::PubsubV1::ModifyPushConfigRequest] modify_push_config_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -723,12 +705,12 @@ module Google
         # Updates an existing subscription. Note that certain properties of a
         # subscription, such as its topic, are not modifiable.
         # @param [String] name
-        #   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"`.
         # @param [Google::Apis::PubsubV1::UpdateSubscriptionRequest] update_subscription_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -759,12 +741,11 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Pulls messages from the server. The server may return `UNAVAILABLE` if
-        # there are too many concurrent pull requests pending for the given
-        # subscription.
+        # Pulls messages from the server. The server may return `UNAVAILABLE` if there
+        # are too many concurrent pull requests pending for the given subscription.
         # @param [String] subscription
-        #   Required. The subscription from which messages should be pulled.
-        #   Format is `projects/`project`/subscriptions/`sub``.
+        #   Required. The subscription from which messages should be pulled. Format is `
+        #   projects/`project`/subscriptions/`sub``.
         # @param [Google::Apis::PubsubV1::PullRequest] pull_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -796,12 +777,12 @@ module Google
         end
         
         # Seeks an existing subscription to a point in time or to a given snapshot,
-        # whichever is provided in the request. 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. Note that both the subscription and the
-        # snapshot must be on the same topic.
+        # whichever is provided in the request. 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. Note that both the subscription and the snapshot must
+        # be on the same topic.
         # @param [String] subscription
         #   Required. The subscription to affect.
         # @param [Google::Apis::PubsubV1::SeekRequest] seek_request_object
@@ -835,11 +816,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::PubsubV1::SetIamPolicyRequest] set_iam_policy_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -870,15 +851,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::PubsubV1::TestIamPermissionsRequest] test_iam_permissions_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -912,12 +892,11 @@ module Google
         # Creates the given topic with the given name. See the [resource name rules](
         # https://cloud.google.com/pubsub/docs/admin#resource_names).
         # @param [String] name
-        #   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"`.
         # @param [Google::Apis::PubsubV1::Topic] topic_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -948,14 +927,14 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Deletes the topic with the given name. Returns `NOT_FOUND` if the topic
-        # does not exist. After a topic is deleted, a new topic may be created with
-        # the same name; this is an entirely new topic with none of the old
-        # configuration or subscriptions. Existing subscriptions to this topic are
-        # not deleted, but their `topic` field is set to `_deleted-topic_`.
+        # Deletes the topic with the given name. Returns `NOT_FOUND` if the topic does
+        # not exist. After a topic is deleted, a new topic may be created with the same
+        # name; this is an entirely new topic with none of the old configuration or
+        # subscriptions. Existing subscriptions to this topic are not deleted, but their
+        # `topic` field is set to `_deleted-topic_`.
         # @param [String] topic
-        #   Required. Name of the topic to delete.
-        #   Format is `projects/`project`/topics/`topic``.
+        #   Required. Name of the topic to delete. Format is `projects/`project`/topics/`
+        #   topic``.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -985,8 +964,8 @@ module Google
         
         # Gets the configuration of a topic.
         # @param [String] topic
-        #   Required. The name of the topic to get.
-        #   Format is `projects/`project`/topics/`topic``.
+        #   Required. The name of the topic to get. Format is `projects/`project`/topics/`
+        #   topic``.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -1014,22 +993,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
@@ -1060,14 +1036,14 @@ module Google
         
         # Lists matching topics.
         # @param [String] project
-        #   Required. The name of the project in which to list topics.
-        #   Format is `projects/`project-id``.
+        #   Required. The name of the project in which to list topics. Format is `projects/
+        #   `project-id``.
         # @param [Fixnum] page_size
         #   Maximum number of topics to return.
         # @param [String] page_token
-        #   The value returned by the last `ListTopicsResponse`; indicates that this is
-        #   a continuation of a prior `ListTopics` call, and that the system should
-        #   return the next page of data.
+        #   The value returned by the last `ListTopicsResponse`; indicates that this is a
+        #   continuation of a prior `ListTopics` call, and that the system should return
+        #   the next page of data.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -1097,15 +1073,14 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Updates an existing topic. Note that certain properties of a
-        # topic are not modifiable.
+        # Updates an existing topic. Note that certain properties of a topic are not
+        # modifiable.
         # @param [String] name
-        #   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"`.
         # @param [Google::Apis::PubsubV1::UpdateTopicRequest] update_topic_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -1136,11 +1111,11 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Adds one or more messages to the topic. Returns `NOT_FOUND` if the topic
-        # does not exist.
+        # Adds one or more messages to the topic. Returns `NOT_FOUND` if the topic does
+        # not exist.
         # @param [String] topic
-        #   Required. The messages in the request will be published on this topic.
-        #   Format is `projects/`project`/topics/`topic``.
+        #   Required. The messages in the request will be published on this topic. Format
+        #   is `projects/`project`/topics/`topic``.
         # @param [Google::Apis::PubsubV1::PublishRequest] publish_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -1172,11 +1147,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::PubsubV1::SetIamPolicyRequest] set_iam_policy_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -1207,15 +1182,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::PubsubV1::TestIamPermissionsRequest] test_iam_permissions_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
@@ -1246,20 +1220,20 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Lists the names of the snapshots on this topic. 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.
+        # Lists the names of the snapshots on this topic. 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.
         # @param [String] topic
-        #   Required. The name of the topic that snapshots are attached to.
-        #   Format is `projects/`project`/topics/`topic``.
+        #   Required. The name of the topic that snapshots are attached to. Format is `
+        #   projects/`project`/topics/`topic``.
         # @param [Fixnum] page_size
         #   Maximum number of snapshot names to return.
         # @param [String] page_token
-        #   The value returned by the last `ListTopicSnapshotsResponse`; indicates
-        #   that this is a continuation of a prior `ListTopicSnapshots` call, and
-        #   that the system should return the next page of data.
+        #   The value returned by the last `ListTopicSnapshotsResponse`; indicates that
+        #   this is a continuation of a prior `ListTopicSnapshots` call, and that the
+        #   system should return the next page of data.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -1291,14 +1265,14 @@ module Google
         
         # Lists the names of the attached subscriptions on this topic.
         # @param [String] topic
-        #   Required. The name of the topic that subscriptions are attached to.
-        #   Format is `projects/`project`/topics/`topic``.
+        #   Required. The name of the topic that subscriptions are attached to. Format is `
+        #   projects/`project`/topics/`topic``.
         # @param [Fixnum] page_size
         #   Maximum number of subscription names to return.
         # @param [String] page_token
         #   The value returned by the last `ListTopicSubscriptionsResponse`; indicates
-        #   that this is a continuation of a prior `ListTopicSubscriptions` call, and
-        #   that the system should return the next page of data.
+        #   that this is a continuation of a prior `ListTopicSubscriptions` call, and that
+        #   the system should return the next page of data.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user