google-apis-pubsub_v1 0.28.0 → 0.53.0

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

@@ -42,13 +42,125 @@ module Google
         end
       end
       
+      # Information about an associated Analytics Hub subscription (https://cloud.
+      # google.com/bigquery/docs/analytics-hub-manage-subscriptions).
+      class AnalyticsHubSubscriptionInfo
+        include Google::Apis::Core::Hashable
+      
+        # Optional. The name of the associated Analytics Hub listing resource. Pattern: "
+        # projects/`project`/locations/`location`/dataExchanges/`data_exchange`/listings/
+        # `listing`"
+        # Corresponds to the JSON property `listing`
+        # @return [String]
+        attr_accessor :listing
+      
+        # Optional. The name of the associated Analytics Hub subscription resource.
+        # Pattern: "projects/`project`/locations/`location`/subscriptions/`subscription`"
+        # Corresponds to the JSON property `subscription`
+        # @return [String]
+        attr_accessor :subscription
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @listing = args[:listing] if args.key?(:listing)
+          @subscription = args[:subscription] if args.key?(:subscription)
+        end
+      end
+      
+      # Configuration for writing message data in Avro format. Message payloads and
+      # metadata will be written to files as an Avro binary.
+      class AvroConfig
+        include Google::Apis::Core::Hashable
+      
+        # Optional. When true, the output Cloud Storage file will be serialized using
+        # the topic schema, if it exists.
+        # Corresponds to the JSON property `useTopicSchema`
+        # @return [Boolean]
+        attr_accessor :use_topic_schema
+        alias_method :use_topic_schema?, :use_topic_schema
+      
+        # Optional. When true, write the subscription name, message_id, publish_time,
+        # attributes, and ordering_key as additional fields in the output. The
+        # subscription name, message_id, and publish_time fields are put in their own
+        # fields while all other message properties other than data (for example, an
+        # ordering_key, if present) are added as entries in the attributes map.
+        # Corresponds to the JSON property `writeMetadata`
+        # @return [Boolean]
+        attr_accessor :write_metadata
+        alias_method :write_metadata?, :write_metadata
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @use_topic_schema = args[:use_topic_schema] if args.key?(:use_topic_schema)
+          @write_metadata = args[:write_metadata] if args.key?(:write_metadata)
+        end
+      end
+      
+      # Ingestion settings for Amazon Kinesis Data Streams.
+      class AwsKinesis
+        include Google::Apis::Core::Hashable
+      
+        # Required. AWS role ARN to be used for Federated Identity authentication with
+        # Kinesis. Check the Pub/Sub docs for how to set up this role and the required
+        # permissions that need to be attached to it.
+        # Corresponds to the JSON property `awsRoleArn`
+        # @return [String]
+        attr_accessor :aws_role_arn
+      
+        # Required. The Kinesis consumer ARN to used for ingestion in Enhanced Fan-Out
+        # mode. The consumer must be already created and ready to be used.
+        # Corresponds to the JSON property `consumerArn`
+        # @return [String]
+        attr_accessor :consumer_arn
+      
+        # Required. The GCP service account to be used for Federated Identity
+        # authentication with Kinesis (via a `AssumeRoleWithWebIdentity` call for the
+        # provided role). The `aws_role_arn` must be set up with `accounts.google.com:
+        # sub` equals to this service account number.
+        # Corresponds to the JSON property `gcpServiceAccount`
+        # @return [String]
+        attr_accessor :gcp_service_account
+      
+        # Output only. An output-only field that indicates the state of the Kinesis
+        # ingestion source.
+        # Corresponds to the JSON property `state`
+        # @return [String]
+        attr_accessor :state
+      
+        # Required. The Kinesis stream ARN to ingest data from.
+        # Corresponds to the JSON property `streamArn`
+        # @return [String]
+        attr_accessor :stream_arn
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @aws_role_arn = args[:aws_role_arn] if args.key?(:aws_role_arn)
+          @consumer_arn = args[:consumer_arn] if args.key?(:consumer_arn)
+          @gcp_service_account = args[:gcp_service_account] if args.key?(:gcp_service_account)
+          @state = args[:state] if args.key?(:state)
+          @stream_arn = args[:stream_arn] if args.key?(:stream_arn)
+        end
+      end
+      
       # Configuration for a BigQuery subscription.
       class BigQueryConfig
         include Google::Apis::Core::Hashable
       
-        # When true and use_topic_schema is true, any fields that are a part of the
-        # topic schema that are not part of the BigQuery table schema are dropped when
-        # writing to BigQuery. Otherwise, the schemas must be kept in sync and any
+        # Optional. When true and use_topic_schema is true, any fields that are a part
+        # of the topic schema that are not part of the BigQuery table schema are dropped
+        # when writing to BigQuery. Otherwise, the schemas must be kept in sync and any
         # messages with extra fields are not written and remain in the subscription's
         # backlog.
         # Corresponds to the JSON property `dropUnknownFields`
@@ -56,30 +168,48 @@ module Google
         attr_accessor :drop_unknown_fields
         alias_method :drop_unknown_fields?, :drop_unknown_fields
       
+        # Optional. The service account to use to write to BigQuery. The subscription
+        # creator or updater that specifies this field must have `iam.serviceAccounts.
+        # actAs` permission on the service account. If not specified, the Pub/Sub [
+        # service agent](https://cloud.google.com/iam/docs/service-agents), service-`
+        # project_number`@gcp-sa-pubsub.iam.gserviceaccount.com, is used.
+        # Corresponds to the JSON property `serviceAccountEmail`
+        # @return [String]
+        attr_accessor :service_account_email
+      
         # Output only. An output-only field that indicates whether or not the
         # subscription can receive messages.
         # Corresponds to the JSON property `state`
         # @return [String]
         attr_accessor :state
       
-        # The name of the table to which to write data, of the form `projectId`.`
-        # datasetId`.`tableId`
+        # Optional. The name of the table to which to write data, of the form `projectId`
+        # .`datasetId`.`tableId`
         # Corresponds to the JSON property `table`
         # @return [String]
         attr_accessor :table
       
-        # When true, use the topic's schema as the columns to write to in BigQuery, if
-        # it exists.
+        # Optional. When true, use the BigQuery table's schema as the columns to write
+        # to in BigQuery. `use_table_schema` and `use_topic_schema` cannot be enabled at
+        # the same time.
+        # Corresponds to the JSON property `useTableSchema`
+        # @return [Boolean]
+        attr_accessor :use_table_schema
+        alias_method :use_table_schema?, :use_table_schema
+      
+        # Optional. When true, use the topic's schema as the columns to write to in
+        # BigQuery, if it exists. `use_topic_schema` and `use_table_schema` cannot be
+        # enabled at the same time.
         # Corresponds to the JSON property `useTopicSchema`
         # @return [Boolean]
         attr_accessor :use_topic_schema
         alias_method :use_topic_schema?, :use_topic_schema
       
-        # When true, write the subscription name, message_id, publish_time, attributes,
-        # and ordering_key to additional columns in the table. The subscription name,
-        # message_id, and publish_time fields are put in their own columns while all
-        # other message properties (other than data) are written to a JSON object in the
-        # attributes column.
+        # Optional. When true, write the subscription name, message_id, publish_time,
+        # attributes, and ordering_key to additional columns in the table. The
+        # subscription name, message_id, and publish_time fields are put in their own
+        # columns while all other message properties (other than data) are written to a
+        # JSON object in the attributes column.
         # Corresponds to the JSON property `writeMetadata`
         # @return [Boolean]
         attr_accessor :write_metadata
@@ -92,8 +222,10 @@ module Google
         # Update properties of this object
         def update!(**args)
           @drop_unknown_fields = args[:drop_unknown_fields] if args.key?(:drop_unknown_fields)
+          @service_account_email = args[:service_account_email] if args.key?(:service_account_email)
           @state = args[:state] if args.key?(:state)
           @table = args[:table] if args.key?(:table)
+          @use_table_schema = args[:use_table_schema] if args.key?(:use_table_schema)
           @use_topic_schema = args[:use_topic_schema] if args.key?(:use_topic_schema)
           @write_metadata = args[:write_metadata] if args.key?(:write_metadata)
         end
@@ -137,7 +269,27 @@ module Google
         # kubernetes-engine/docs/how-to/kubernetes-service-accounts). For example, `my-
         # project.svc.id.goog[my-namespace/my-kubernetes-sa]`. * `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
+        # . * `domain:`domain``: The G Suite domain (primary) that represents all the
+        # users of that domain. For example, `google.com` or `example.com`. * `principal:
+        # //iam.googleapis.com/locations/global/workforcePools/`pool_id`/subject/`
+        # subject_attribute_value``: A single identity in a workforce identity pool. * `
+        # principalSet://iam.googleapis.com/locations/global/workforcePools/`pool_id`/
+        # group/`group_id``: All workforce identities in a group. * `principalSet://iam.
+        # googleapis.com/locations/global/workforcePools/`pool_id`/attribute.`
+        # attribute_name`/`attribute_value``: All workforce identities with a specific
+        # attribute value. * `principalSet://iam.googleapis.com/locations/global/
+        # workforcePools/`pool_id`/*`: All identities in a workforce identity pool. * `
+        # principal://iam.googleapis.com/projects/`project_number`/locations/global/
+        # workloadIdentityPools/`pool_id`/subject/`subject_attribute_value``: A single
+        # identity in a workload identity pool. * `principalSet://iam.googleapis.com/
+        # projects/`project_number`/locations/global/workloadIdentityPools/`pool_id`/
+        # group/`group_id``: A workload identity pool group. * `principalSet://iam.
+        # googleapis.com/projects/`project_number`/locations/global/
+        # workloadIdentityPools/`pool_id`/attribute.`attribute_name`/`attribute_value``:
+        # All identities in a workload identity pool with a certain attribute. * `
+        # principalSet://iam.googleapis.com/projects/`project_number`/locations/global/
+        # workloadIdentityPools/`pool_id`/*`: All identities in a workload identity pool.
+        # * `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
@@ -151,14 +303,19 @@ module Google
         # 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`.
+        # deleted:principal://iam.googleapis.com/locations/global/workforcePools/`
+        # pool_id`/subject/`subject_attribute_value``: Deleted single identity in a
+        # workforce identity pool. For example, `deleted:principal://iam.googleapis.com/
+        # locations/global/workforcePools/my-pool-id/subject/my-subject-attribute-value`.
         # Corresponds to the JSON property `members`
         # @return [Array<String>]
         attr_accessor :members
       
         # Role that is assigned to the list of `members`, or principals. For example, `
-        # roles/viewer`, `roles/editor`, or `roles/owner`.
+        # roles/viewer`, `roles/editor`, or `roles/owner`. For an overview of the IAM
+        # roles and permissions, see the [IAM documentation](https://cloud.google.com/
+        # iam/docs/roles-overview). For a list of the available pre-defined roles, see [
+        # here](https://cloud.google.com/iam/docs/understanding-roles).
         # Corresponds to the JSON property `role`
         # @return [String]
         attr_accessor :role
@@ -175,12 +332,123 @@ module Google
         end
       end
       
+      # Configuration for a Cloud Storage subscription.
+      class CloudStorageConfig
+        include Google::Apis::Core::Hashable
+      
+        # Configuration for writing message data in Avro format. Message payloads and
+        # metadata will be written to files as an Avro binary.
+        # Corresponds to the JSON property `avroConfig`
+        # @return [Google::Apis::PubsubV1::AvroConfig]
+        attr_accessor :avro_config
+      
+        # Required. User-provided name for the Cloud Storage bucket. The bucket must be
+        # created by the user. The bucket name must be without any prefix like "gs://".
+        # See the [bucket naming requirements] (https://cloud.google.com/storage/docs/
+        # buckets#naming).
+        # Corresponds to the JSON property `bucket`
+        # @return [String]
+        attr_accessor :bucket
+      
+        # Optional. User-provided format string specifying how to represent datetimes in
+        # Cloud Storage filenames. See the [datetime format guidance](https://cloud.
+        # google.com/pubsub/docs/create-cloudstorage-subscription#file_names).
+        # Corresponds to the JSON property `filenameDatetimeFormat`
+        # @return [String]
+        attr_accessor :filename_datetime_format
+      
+        # Optional. User-provided prefix for Cloud Storage filename. See the [object
+        # naming requirements](https://cloud.google.com/storage/docs/objects#naming).
+        # Corresponds to the JSON property `filenamePrefix`
+        # @return [String]
+        attr_accessor :filename_prefix
+      
+        # Optional. User-provided suffix for Cloud Storage filename. See the [object
+        # naming requirements](https://cloud.google.com/storage/docs/objects#naming).
+        # Must not end in "/".
+        # Corresponds to the JSON property `filenameSuffix`
+        # @return [String]
+        attr_accessor :filename_suffix
+      
+        # Optional. The maximum bytes that can be written to a Cloud Storage file before
+        # a new file is created. Min 1 KB, max 10 GiB. The max_bytes limit may be
+        # exceeded in cases where messages are larger than the limit.
+        # Corresponds to the JSON property `maxBytes`
+        # @return [Fixnum]
+        attr_accessor :max_bytes
+      
+        # Optional. The maximum duration that can elapse before a new Cloud Storage file
+        # is created. Min 1 minute, max 10 minutes, default 5 minutes. May not exceed
+        # the subscription's acknowledgement deadline.
+        # Corresponds to the JSON property `maxDuration`
+        # @return [String]
+        attr_accessor :max_duration
+      
+        # Optional. The service account to use to write to Cloud Storage. The
+        # subscription creator or updater that specifies this field must have `iam.
+        # serviceAccounts.actAs` permission on the service account. If not specified,
+        # the Pub/Sub [service agent](https://cloud.google.com/iam/docs/service-agents),
+        # service-`project_number`@gcp-sa-pubsub.iam.gserviceaccount.com, is used.
+        # Corresponds to the JSON property `serviceAccountEmail`
+        # @return [String]
+        attr_accessor :service_account_email
+      
+        # Output only. An output-only field that indicates whether or not the
+        # subscription can receive messages.
+        # Corresponds to the JSON property `state`
+        # @return [String]
+        attr_accessor :state
+      
+        # Configuration for writing message data in text format. Message payloads will
+        # be written to files as raw text, separated by a newline.
+        # Corresponds to the JSON property `textConfig`
+        # @return [Google::Apis::PubsubV1::TextConfig]
+        attr_accessor :text_config
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @avro_config = args[:avro_config] if args.key?(:avro_config)
+          @bucket = args[:bucket] if args.key?(:bucket)
+          @filename_datetime_format = args[:filename_datetime_format] if args.key?(:filename_datetime_format)
+          @filename_prefix = args[:filename_prefix] if args.key?(:filename_prefix)
+          @filename_suffix = args[:filename_suffix] if args.key?(:filename_suffix)
+          @max_bytes = args[:max_bytes] if args.key?(:max_bytes)
+          @max_duration = args[:max_duration] if args.key?(:max_duration)
+          @service_account_email = args[:service_account_email] if args.key?(:service_account_email)
+          @state = args[:state] if args.key?(:state)
+          @text_config = args[:text_config] if args.key?(:text_config)
+        end
+      end
+      
+      # Request for CommitSchema method.
+      class CommitSchemaRequest
+        include Google::Apis::Core::Hashable
+      
+        # A schema resource.
+        # Corresponds to the JSON property `schema`
+        # @return [Google::Apis::PubsubV1::Schema]
+        attr_accessor :schema
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @schema = args[:schema] if args.key?(:schema)
+        end
+      end
+      
       # Request for the `CreateSnapshot` method.
       class CreateSnapshotRequest
         include Google::Apis::Core::Hashable
       
-        # See [Creating and managing labels](https://cloud.google.com/pubsub/docs/labels)
-        # .
+        # Optional. 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
@@ -214,8 +482,8 @@ module Google
       class DeadLetterPolicy
         include Google::Apis::Core::Hashable
       
-        # The name of the topic to which dead letter messages should be published.
-        # Format is `projects/`project`/topics/`topic``.The Cloud Pub/Sub service
+        # Optional. The name of the topic to which dead letter messages should be
+        # published. Format is `projects/`project`/topics/`topic``.The 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
@@ -225,13 +493,13 @@ module Google
         # @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.
+        # Optional. 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.
         # Corresponds to the JSON property `maxDeliveryAttempts`
         # @return [Fixnum]
         attr_accessor :max_delivery_attempts
@@ -281,11 +549,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.
+        # Optional. 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
@@ -354,6 +622,51 @@ module Google
         end
       end
       
+      # Settings for an ingestion data source on a topic.
+      class IngestionDataSourceSettings
+        include Google::Apis::Core::Hashable
+      
+        # Ingestion settings for Amazon Kinesis Data Streams.
+        # Corresponds to the JSON property `awsKinesis`
+        # @return [Google::Apis::PubsubV1::AwsKinesis]
+        attr_accessor :aws_kinesis
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @aws_kinesis = args[:aws_kinesis] if args.key?(:aws_kinesis)
+        end
+      end
+      
+      # Response for the `ListSchemaRevisions` method.
+      class ListSchemaRevisionsResponse
+        include Google::Apis::Core::Hashable
+      
+        # A token that can be sent as `page_token` to retrieve the next page. If this
+        # field is empty, there are no subsequent pages.
+        # Corresponds to the JSON property `nextPageToken`
+        # @return [String]
+        attr_accessor :next_page_token
+      
+        # The revisions of the schema.
+        # Corresponds to the JSON property `schemas`
+        # @return [Array<Google::Apis::PubsubV1::Schema>]
+        attr_accessor :schemas
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @next_page_token = args[:next_page_token] if args.key?(:next_page_token)
+          @schemas = args[:schemas] if args.key?(:schemas)
+        end
+      end
+      
       # Response for the `ListSchemas` method.
       class ListSchemasResponse
         include Google::Apis::Core::Hashable
@@ -384,13 +697,13 @@ 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`.
+        # Optional. 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
       
-        # The resulting snapshots.
+        # Optional. The resulting snapshots.
         # Corresponds to the JSON property `snapshots`
         # @return [Array<Google::Apis::PubsubV1::Snapshot>]
         attr_accessor :snapshots
@@ -410,14 +723,14 @@ 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.
+        # Optional. 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
       
-        # The subscriptions that match the request.
+        # Optional. The subscriptions that match the request.
         # Corresponds to the JSON property `subscriptions`
         # @return [Array<Google::Apis::PubsubV1::Subscription>]
         attr_accessor :subscriptions
@@ -437,14 +750,14 @@ 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.
+        # Optional. 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
       
-        # The names of the snapshots that match the request.
+        # Optional. The names of the snapshots that match the request.
         # Corresponds to the JSON property `snapshots`
         # @return [Array<String>]
         attr_accessor :snapshots
@@ -464,14 +777,15 @@ 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.
+        # Optional. 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
       
-        # The names of subscriptions attached to the topic specified in the request.
+        # Optional. The names of subscriptions attached to the topic specified in the
+        # request.
         # Corresponds to the JSON property `subscriptions`
         # @return [Array<String>]
         attr_accessor :subscriptions
@@ -491,13 +805,13 @@ 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`.
+        # Optional. 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
       
-        # The resulting topics.
+        # Optional. The resulting topics.
         # Corresponds to the JSON property `topics`
         # @return [Array<Google::Apis::PubsubV1::Topic>]
         attr_accessor :topics
@@ -517,15 +831,25 @@ module Google
       class MessageStoragePolicy
         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.
+        # Optional. A list of IDs of Google Cloud regions where messages that are
+        # published to the topic may be persisted in storage. Messages published by
+        # publishers running in non-allowed Google Cloud regions (or running outside of
+        # Google Cloud altogether) are 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
       
+        # Optional. If true, `allowed_persistence_regions` is also used to enforce in-
+        # transit guarantees for messages. That is, Pub/Sub will fail Publish operations
+        # on this topic and subscribe operations on any subscription attached to this
+        # topic in any region that is not in `allowed_persistence_regions`.
+        # Corresponds to the JSON property `enforceInTransit`
+        # @return [Boolean]
+        attr_accessor :enforce_in_transit
+        alias_method :enforce_in_transit?, :enforce_in_transit
+      
         def initialize(**args)
            update!(**args)
         end
@@ -533,6 +857,7 @@ module Google
         # Update properties of this object
         def update!(**args)
           @allowed_persistence_regions = args[:allowed_persistence_regions] if args.key?(:allowed_persistence_regions)
+          @enforce_in_transit = args[:enforce_in_transit] if args.key?(:enforce_in_transit)
         end
       end
       
@@ -546,8 +871,8 @@ module Google
         # 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).
+        # specify is 0 seconds. The maximum deadline you can specify in a single request
+        # is 600 seconds (10 minutes).
         # Corresponds to the JSON property `ackDeadlineSeconds`
         # @return [Fixnum]
         attr_accessor :ack_deadline_seconds
@@ -587,25 +912,47 @@ module Google
         end
       end
       
+      # Sets the `data` field as the HTTP body for delivery.
+      class NoWrapper
+        include Google::Apis::Core::Hashable
+      
+        # Optional. When true, writes the Pub/Sub message metadata to `x-goog-pubsub-:`
+        # headers of the HTTP request. Writes the Pub/Sub message attributes to `:`
+        # headers of the HTTP request.
+        # Corresponds to the JSON property `writeMetadata`
+        # @return [Boolean]
+        attr_accessor :write_metadata
+        alias_method :write_metadata?, :write_metadata
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @write_metadata = args[:write_metadata] if args.key?(:write_metadata)
+        end
+      end
+      
       # Contains information needed for generating an [OpenID Connect token](https://
-      # developers.google.com/identity/protocols/OpenIDConnect). [Service account
-      # email](https://cloud.google.com/iam/docs/service-accounts) used for generating
-      # the OIDC token. For more information on setting up authentication, see [Push
-      # subscriptions](https://cloud.google.com/pubsub/docs/push).
+      # 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.
+        # Optional. 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
       
-        # 
+        # Optional. [Service account email](https://cloud.google.com/iam/docs/service-
+        # accounts) used for generating the OIDC token. For more information on setting
+        # up authentication, see [Push subscriptions](https://cloud.google.com/pubsub/
+        # docs/push).
         # Corresponds to the JSON property `serviceAccountEmail`
         # @return [String]
         attr_accessor :service_account_email
@@ -632,22 +979,22 @@ module Google
       # 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:** ` "
+      # 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/).
+      # 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
       
@@ -733,8 +1080,9 @@ 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.
+        # Optional. 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
@@ -759,14 +1107,15 @@ module Google
       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.
+        # Optional. 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.
+        # Optional. 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]
@@ -780,9 +1129,9 @@ module Google
         # @return [String]
         attr_accessor :message_id
       
-        # 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
+        # Optional. 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. For more information, see [ordering
@@ -812,6 +1161,21 @@ module Google
         end
       end
       
+      # The payload to the push endpoint is in the form of the JSON representation of
+      # a PubsubMessage (https://cloud.google.com/pubsub/docs/reference/rpc/google.
+      # pubsub.v1#pubsubmessage).
+      class PubsubWrapper
+        include Google::Apis::Core::Hashable
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+        end
+      end
+      
       # Request for the `Pull` method.
       class PullRequest
         include Google::Apis::Core::Hashable
@@ -850,10 +1214,11 @@ module Google
       class PullResponse
         include Google::Apis::Core::Hashable
       
-        # Received Pub/Sub messages. The list will be empty if there are no more
-        # messages available in the backlog. For JSON, the response can be entirely
-        # empty. The Pub/Sub system may return fewer than the `maxMessages` requested
-        # even if there are more messages available in the backlog.
+        # Optional. Received Pub/Sub messages. The list will be empty if there are no
+        # more messages available in the backlog, or if no messages could be returned
+        # before the request timeout. For JSON, the response can be entirely empty. The
+        # Pub/Sub system may return fewer than the `maxMessages` requested even if there
+        # are more messages available in the backlog.
         # Corresponds to the JSON property `receivedMessages`
         # @return [Array<Google::Apis::PubsubV1::ReceivedMessage>]
         attr_accessor :received_messages
@@ -872,34 +1237,43 @@ module Google
       class PushConfig
         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: `attributes ` "x-goog-version": "v1" ``
+        # Optional. 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: `attributes ` "x-goog-version": "v1" ``
         # Corresponds to the JSON property `attributes`
         # @return [Hash<String,String>]
         attr_accessor :attributes
       
+        # Sets the `data` field as the HTTP body for delivery.
+        # Corresponds to the JSON property `noWrapper`
+        # @return [Google::Apis::PubsubV1::NoWrapper]
+        attr_accessor :no_wrapper
+      
         # Contains information needed for generating an [OpenID Connect token](https://
-        # developers.google.com/identity/protocols/OpenIDConnect). [Service account
-        # email](https://cloud.google.com/iam/docs/service-accounts) used for generating
-        # the OIDC token. For more information on setting up authentication, see [Push
-        # subscriptions](https://cloud.google.com/pubsub/docs/push).
+        # 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`.
+        # The payload to the push endpoint is in the form of the JSON representation of
+        # a PubsubMessage (https://cloud.google.com/pubsub/docs/reference/rpc/google.
+        # pubsub.v1#pubsubmessage).
+        # Corresponds to the JSON property `pubsubWrapper`
+        # @return [Google::Apis::PubsubV1::PubsubWrapper]
+        attr_accessor :pubsub_wrapper
+      
+        # Optional. 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
@@ -911,7 +1285,9 @@ module Google
         # Update properties of this object
         def update!(**args)
           @attributes = args[:attributes] if args.key?(:attributes)
+          @no_wrapper = args[:no_wrapper] if args.key?(:no_wrapper)
           @oidc_token = args[:oidc_token] if args.key?(:oidc_token)
+          @pubsub_wrapper = args[:pubsub_wrapper] if args.key?(:pubsub_wrapper)
           @push_endpoint = args[:push_endpoint] if args.key?(:push_endpoint)
         end
       end
@@ -920,16 +1296,16 @@ module Google
       class ReceivedMessage
         include Google::Apis::Core::Hashable
       
-        # This ID can be used to acknowledge the received message.
+        # Optional. This ID can be used to acknowledge the received message.
         # Corresponds to the JSON property `ackId`
         # @return [String]
         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
+        # Optional. The approximate number of times that 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
@@ -962,24 +1338,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,
-      # delay can be more or less than configured backoff.
+      # A policy that specifies how 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.
+        # Optional. 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.
+        # Optional. 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
@@ -995,6 +1371,26 @@ module Google
         end
       end
       
+      # Request for the `RollbackSchema` method.
+      class RollbackSchemaRequest
+        include Google::Apis::Core::Hashable
+      
+        # Required. The revision ID to roll back to. It must be a revision of the same
+        # schema. Example: c7cfa2a8
+        # Corresponds to the JSON property `revisionId`
+        # @return [String]
+        attr_accessor :revision_id
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @revision_id = args[:revision_id] if args.key?(:revision_id)
+        end
+      end
+      
       # A schema resource.
       class Schema
         include Google::Apis::Core::Hashable
@@ -1044,21 +1440,21 @@ module Google
       class SchemaSettings
         include Google::Apis::Core::Hashable
       
-        # The encoding of messages validated against `schema`.
+        # Optional. The encoding of messages validated against `schema`.
         # Corresponds to the JSON property `encoding`
         # @return [String]
         attr_accessor :encoding
       
-        # The minimum (inclusive) revision allowed for validating messages. If empty or
-        # not present, allow any revision to be validated against last_revision or any
-        # revision created before.
+        # Optional. The minimum (inclusive) revision allowed for validating messages. If
+        # empty or not present, allow any revision to be validated against last_revision
+        # or any revision created before.
         # Corresponds to the JSON property `firstRevisionId`
         # @return [String]
         attr_accessor :first_revision_id
       
-        # The maximum (inclusive) revision allowed for validating messages. If empty or
-        # not present, allow any revision to be validated against first_revision or any
-        # revision created after.
+        # Optional. The maximum (inclusive) revision allowed for validating messages. If
+        # empty or not present, allow any revision to be validated against
+        # first_revision or any revision created after.
         # Corresponds to the JSON property `lastRevisionId`
         # @return [String]
         attr_accessor :last_revision_id
@@ -1087,21 +1483,23 @@ 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``.
+        # Optional. 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.
+        # Optional. 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
@@ -1145,22 +1543,22 @@ module Google
         # 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:** ` "
+        # 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/).
+        # 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
@@ -1182,11 +1580,11 @@ module Google
       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
+        # Optional. 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
@@ -1196,18 +1594,18 @@ module Google
         # @return [String]
         attr_accessor :expire_time
       
-        # See [Creating and managing labels] (https://cloud.google.com/pubsub/docs/
-        # labels).
+        # Optional. 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
       
-        # The name of the snapshot.
+        # Optional. The name of the snapshot.
         # Corresponds to the JSON property `name`
         # @return [String]
         attr_accessor :name
       
-        # The name of the topic from which this snapshot is retaining messages.
+        # Optional. The name of the topic from which this snapshot is retaining messages.
         # Corresponds to the JSON property `topic`
         # @return [String]
         attr_accessor :topic
@@ -1225,20 +1623,20 @@ module Google
         end
       end
       
-      # A subscription resource. If none of `push_config` or `bigquery_config` is set,
-      # then the subscriber will pull and ack messages using API methods. At most one
-      # of these fields may be set.
+      # A subscription resource. If none of `push_config`, `bigquery_config`, or `
+      # cloud_storage_config` is set, then the subscriber will pull and ack messages
+      # using API methods. At most one of these fields may be set.
       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 _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 `
+        # Optional. 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
@@ -1250,11 +1648,22 @@ module Google
         # @return [Fixnum]
         attr_accessor :ack_deadline_seconds
       
+        # Information about an associated Analytics Hub subscription (https://cloud.
+        # google.com/bigquery/docs/analytics-hub-manage-subscriptions).
+        # Corresponds to the JSON property `analyticsHubSubscriptionInfo`
+        # @return [Google::Apis::PubsubV1::AnalyticsHubSubscriptionInfo]
+        attr_accessor :analytics_hub_subscription_info
+      
         # Configuration for a BigQuery subscription.
         # Corresponds to the JSON property `bigqueryConfig`
         # @return [Google::Apis::PubsubV1::BigQueryConfig]
         attr_accessor :bigquery_config
       
+        # Configuration for a Cloud Storage subscription.
+        # Corresponds to the JSON property `cloudStorageConfig`
+        # @return [Google::Apis::PubsubV1::CloudStorageConfig]
+        attr_accessor :cloud_storage_config
+      
         # 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
@@ -1263,32 +1672,33 @@ module Google
         # @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.
+        # Optional. 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, Pub/Sub provides the following guarantees for the delivery of a
-        # message with a given value of `message_id` on this subscription: * The message
-        # sent to a subscriber is guaranteed not to be resent before the message's
-        # acknowledgement deadline expires. * An acknowledged message will not be resent
-        # to a subscriber. Note that subscribers may still receive multiple copies of a
-        # message when `enable_exactly_once_delivery` is true if the message was
-        # published multiple times by a publisher client. These copies are considered
-        # distinct by Pub/Sub and have distinct `message_id` values.
+        # Optional. If true, Pub/Sub provides the following guarantees for the delivery
+        # of a message with a given value of `message_id` on this subscription: * The
+        # message sent to a subscriber is guaranteed not to be resent before the message'
+        # s acknowledgement deadline expires. * An acknowledged message will not be
+        # resent to a subscriber. Note that subscribers may still receive multiple
+        # copies of a message when `enable_exactly_once_delivery` is true if the message
+        # was published multiple times by a publisher client. These copies are
+        # considered distinct by Pub/Sub and have distinct `message_id` values.
         # Corresponds to the JSON property `enableExactlyOnceDelivery`
         # @return [Boolean]
         attr_accessor :enable_exactly_once_delivery
         alias_method :enable_exactly_once_delivery?, :enable_exactly_once_delivery
       
-        # 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.
+        # Optional. 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.
         # Corresponds to the JSON property `enableMessageOrdering`
         # @return [Boolean]
         attr_accessor :enable_message_ordering
@@ -1300,24 +1710,24 @@ 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.
+        # Optional. 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 [Creating and managing labels](https://cloud.google.com/pubsub/docs/labels)
-        # .
+        # Optional. 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
       
-        # 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.
+        # Optional. 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]
@@ -1338,24 +1748,24 @@ 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) in the past to replay previously-
-        # acknowledged messages.
+        # Optional. 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) in the past to replay
+        # previously-acknowledged messages.
         # 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,
-        # delay can be more or less than configured backoff.
+        # A policy that specifies how 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
@@ -1390,7 +1800,9 @@ module Google
         # Update properties of this object
         def update!(**args)
           @ack_deadline_seconds = args[:ack_deadline_seconds] if args.key?(:ack_deadline_seconds)
+          @analytics_hub_subscription_info = args[:analytics_hub_subscription_info] if args.key?(:analytics_hub_subscription_info)
           @bigquery_config = args[:bigquery_config] if args.key?(:bigquery_config)
+          @cloud_storage_config = args[:cloud_storage_config] if args.key?(:cloud_storage_config)
           @dead_letter_policy = args[:dead_letter_policy] if args.key?(:dead_letter_policy)
           @detached = args[:detached] if args.key?(:detached)
           @enable_exactly_once_delivery = args[:enable_exactly_once_delivery] if args.key?(:enable_exactly_once_delivery)
@@ -1449,31 +1861,50 @@ module Google
         end
       end
       
+      # Configuration for writing message data in text format. Message payloads will
+      # be written to files as raw text, separated by a newline.
+      class TextConfig
+        include Google::Apis::Core::Hashable
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+        end
+      end
+      
       # A topic resource.
       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/*`.
+        # Settings for an ingestion data source on a topic.
+        # Corresponds to the JSON property `ingestionDataSourceSettings`
+        # @return [Google::Apis::PubsubV1::IngestionDataSourceSettings]
+        attr_accessor :ingestion_data_source_settings
+      
+        # Optional. 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).
+        # Optional. 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
       
-        # Indicates the minimum duration to retain a message after it is published to
-        # the topic. If this field is set, messages published to the topic in the last `
-        # message_retention_duration` are always available to subscribers. For instance,
-        # it allows any attached subscription to [seek to a timestamp](https://cloud.
-        # google.com/pubsub/docs/replay-overview#seek_to_a_time) that is up to `
-        # message_retention_duration` in the past. If this field is not set, message
-        # retention is controlled by settings on individual subscriptions. Cannot be
-        # more than 31 days or less than 10 minutes.
+        # Optional. Indicates the minimum duration to retain a message after it is
+        # published to the topic. If this field is set, messages published to the topic
+        # in the last `message_retention_duration` are always available to subscribers.
+        # For instance, it allows any attached subscription to [seek to a timestamp](
+        # https://cloud.google.com/pubsub/docs/replay-overview#seek_to_a_time) that is
+        # up to `message_retention_duration` in the past. If this field is not set,
+        # message retention is controlled by settings on individual subscriptions.
+        # Cannot be more than 31 days or less than 10 minutes.
         # Corresponds to the JSON property `messageRetentionDuration`
         # @return [String]
         attr_accessor :message_retention_duration
@@ -1492,8 +1923,8 @@ module Google
         # @return [String]
         attr_accessor :name
       
-        # Reserved for future use. This field is set only in responses from the server;
-        # it is ignored if it is set in any requests.
+        # Optional. Reserved for future use. This field is set only in responses from
+        # the server; it is ignored if it is set in any requests.
         # Corresponds to the JSON property `satisfiesPzs`
         # @return [Boolean]
         attr_accessor :satisfies_pzs
@@ -1504,12 +1935,18 @@ module Google
         # @return [Google::Apis::PubsubV1::SchemaSettings]
         attr_accessor :schema_settings
       
+        # Output only. An output-only field indicating the state of the topic.
+        # Corresponds to the JSON property `state`
+        # @return [String]
+        attr_accessor :state
+      
         def initialize(**args)
            update!(**args)
         end
       
         # Update properties of this object
         def update!(**args)
+          @ingestion_data_source_settings = args[:ingestion_data_source_settings] if args.key?(:ingestion_data_source_settings)
           @kms_key_name = args[:kms_key_name] if args.key?(:kms_key_name)
           @labels = args[:labels] if args.key?(:labels)
           @message_retention_duration = args[:message_retention_duration] if args.key?(:message_retention_duration)
@@ -1517,6 +1954,7 @@ module Google
           @name = args[:name] if args.key?(:name)
           @satisfies_pzs = args[:satisfies_pzs] if args.key?(:satisfies_pzs)
           @schema_settings = args[:schema_settings] if args.key?(:schema_settings)
+          @state = args[:state] if args.key?(:state)
         end
       end
       
@@ -1553,9 +1991,9 @@ module Google
       class UpdateSubscriptionRequest
         include Google::Apis::Core::Hashable
       
-        # A subscription resource. If none of `push_config` or `bigquery_config` is set,
-        # then the subscriber will pull and ack messages using API methods. At most one
-        # of these fields may be set.
+        # A subscription resource. If none of `push_config`, `bigquery_config`, or `
+        # cloud_storage_config` is set, then the subscriber will pull and ack messages
+        # using API methods. At most one of these fields may be set.
         # Corresponds to the JSON property `subscription`
         # @return [Google::Apis::PubsubV1::Subscription]
         attr_accessor :subscription