google-apis-pubsub_v1 0.16.0 → 0.19.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 637b217580bc9aa8b80cedc2da65cdf5c04c1d8e46703dc1afcbc954135a4b80
-  data.tar.gz: f3fc1e5fb5a18eb7b15153078086bd9a26c7824b61e2ffc2abf6e646c70d23d2
+  metadata.gz: 23f1ec9518a2e8e9b5d900304cc97175d8e3879e88aec02551bb50c115c695c5
+  data.tar.gz: 303a2602a3f65670800a13c288763fbe67d7d18edff897883b899a87da69f0a0
 SHA512:
-  metadata.gz: 33de37a8c68f03efa2b8f5a51daf65f3e993de862460395857ad4c9fb04ce289e1ad47001c7962d4ed5223b250950222f3d830d972468a1b00f57431b32211a4
-  data.tar.gz: 2ac94d0f265cea872a9213005e3b4b70bb205bd239d03a24ecebfcdf058c55426362777c60da58624f6aa0377239bb150cf9bcad770f5273e7912ae713d2c2af
+  metadata.gz: 071467d0cacf01d646f64c50132aaf5138fb2f55674733f386ef1ebaa938e6dd70c33535aa2c5640d1cdd4837029deed4a5c370727d26a5736cd5aea669cd915
+  data.tar.gz: 978c4981f1890739aa3f3e41537ccd3550946d5208c888430c681ec7138b96512d2cb1947780d91f59799b68a5f60278134bf9809655cc407b770d408c47d445

data/CHANGELOG.md

@@ -1,5 +1,17 @@
 # Release history for google-apis-pubsub_v1
 
+### v0.19.0 (2022-05-20)
+
+* Regenerated from discovery document revision 20220510
+
+### v0.18.0 (2022-05-13)
+
+* Regenerated from discovery document revision 20220502
+
+### v0.17.0 (2022-05-01)
+
+* Regenerated from discovery document revision 20220421
+
 ### v0.16.0 (2022-04-17)
 
 * Regenerated from discovery document revision 20220404

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

@@ -42,6 +42,63 @@ module Google
         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
+        # messages with extra fields are not written and remain in the subscription's
+        # backlog.
+        # Corresponds to the JSON property `dropUnknownFields`
+        # @return [Boolean]
+        attr_accessor :drop_unknown_fields
+        alias_method :drop_unknown_fields?, :drop_unknown_fields
+      
+        # 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`
+        # 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.
+        # 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.
+        # 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)
+          @drop_unknown_fields = args[:drop_unknown_fields] if args.key?(:drop_unknown_fields)
+          @state = args[:state] if args.key?(:state)
+          @table = args[:table] if args.key?(:table)
+          @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
+      
       # Associates `members`, or principals, with a `role`.
       class Binding
         include Google::Apis::Core::Hashable
@@ -525,7 +582,10 @@ module Google
       end
       
       # Contains information needed for generating an [OpenID Connect token](https://
-      # developers.google.com/identity/protocols/OpenIDConnect).
+      # 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).
       class OidcToken
         include Google::Apis::Core::Hashable
       
@@ -539,9 +599,7 @@ module Google
         # @return [String]
         attr_accessor :audience
       
-        # [Service account email](https://cloud.google.com/iam/docs/service-accounts) to
-        # be used for generating the OIDC token. See [Setting up push authentication](/
-        # pubsub/docs/push#setting_up_for_push_authentication) for more details.
+        # 
         # Corresponds to the JSON property `serviceAccountEmail`
         # @return [String]
         attr_accessor :service_account_email
@@ -721,7 +779,8 @@ module Google
         # 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.
+        # specify the same `ordering_key` value. For more information, see [ordering
+        # messages](https://cloud.google.com/pubsub/docs/ordering).
         # Corresponds to the JSON property `orderingKey`
         # @return [String]
         attr_accessor :ordering_key
@@ -825,7 +884,10 @@ module Google
         attr_accessor :attributes
       
         # Contains information needed for generating an [OpenID Connect token](https://
-        # developers.google.com/identity/protocols/OpenIDConnect).
+        # 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).
         # Corresponds to the JSON property `oidcToken`
         # @return [Google::Apis::PubsubV1::OidcToken]
         attr_accessor :oidc_token
@@ -1164,6 +1226,11 @@ module Google
         # @return [Fixnum]
         attr_accessor :ack_deadline_seconds
       
+        # Configuration for a BigQuery subscription.
+        # Corresponds to the JSON property `bigqueryConfig`
+        # @return [Google::Apis::PubsubV1::BigQueryConfig]
+        attr_accessor :bigquery_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
@@ -1298,6 +1365,7 @@ module Google
         # Update properties of this object
         def update!(**args)
           @ack_deadline_seconds = args[:ack_deadline_seconds] if args.key?(:ack_deadline_seconds)
+          @bigquery_config = args[:bigquery_config] if args.key?(:bigquery_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)

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

@@ -16,13 +16,13 @@ module Google
   module Apis
     module PubsubV1
       # Version of the google-apis-pubsub_v1 gem
-      GEM_VERSION = "0.16.0"
+      GEM_VERSION = "0.19.0"
 
       # Version of the code generator used to generate this client
       GENERATOR_VERSION = "0.4.1"
 
       # Revision of the discovery document this client was generated from
-      REVISION = "20220404"
+      REVISION = "20220510"
     end
   end
 end

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

@@ -28,6 +28,12 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class BigQueryConfig
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class Binding
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -293,6 +299,17 @@ module Google
         end
       end
       
+      class BigQueryConfig
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :drop_unknown_fields, as: 'dropUnknownFields'
+          property :state, as: 'state'
+          property :table, as: 'table'
+          property :use_topic_schema, as: 'useTopicSchema'
+          property :write_metadata, as: 'writeMetadata'
+        end
+      end
+      
       class Binding
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
@@ -566,6 +583,8 @@ module Google
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
           property :ack_deadline_seconds, as: 'ackDeadlineSeconds'
+          property :bigquery_config, as: 'bigqueryConfig', class: Google::Apis::PubsubV1::BigQueryConfig, decorator: Google::Apis::PubsubV1::BigQueryConfig::Representation
+      
           property :dead_letter_policy, as: 'deadLetterPolicy', class: Google::Apis::PubsubV1::DeadLetterPolicy, decorator: Google::Apis::PubsubV1::DeadLetterPolicy::Representation
       
           property :detached, as: 'detached'

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

@@ -157,8 +157,9 @@ module Google
         # 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 [Resource
+        #   names](https://cloud.google.com/apis/design/resource_names) for the
+        #   appropriate value for this field.
         # @param [Fixnum] options_requested_policy_version
         #   Optional. The maximum policy version that will be used to format the policy.
         #   Valid values are 0, 1, and 3. Requests specifying an invalid value will be
@@ -246,8 +247,9 @@ module Google
         # 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 [Resource
+        #   names](https://cloud.google.com/apis/design/resource_names) 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.
@@ -284,8 +286,9 @@ module Google
         # 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 [
+        #   Resource names](https://cloud.google.com/apis/design/resource_names) 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.
@@ -472,10 +475,11 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # 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.
+        # Gets the configuration details of a 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.
         # @param [String] snapshot
         #   Required. The name of the snapshot to get. Format is `projects/`project`/
         #   snapshots/`snap``.
@@ -509,8 +513,9 @@ module Google
         # 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 [Resource
+        #   names](https://cloud.google.com/apis/design/resource_names) for the
+        #   appropriate value for this field.
         # @param [Fixnum] options_requested_policy_version
         #   Optional. The maximum policy version that will be used to format the policy.
         #   Valid values are 0, 1, and 3. Requests specifying an invalid value will be
@@ -592,10 +597,10 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # 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.
+        # Updates 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.
         # @param [String] name
         #   The name of the snapshot.
         # @param [Google::Apis::PubsubV1::UpdateSnapshotRequest] update_snapshot_request_object
@@ -632,8 +637,9 @@ module Google
         # 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 [Resource
+        #   names](https://cloud.google.com/apis/design/resource_names) 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.
@@ -670,8 +676,9 @@ module Google
         # 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 [
+        #   Resource names](https://cloud.google.com/apis/design/resource_names) 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.
@@ -889,8 +896,9 @@ module Google
         # 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 [Resource
+        #   names](https://cloud.google.com/apis/design/resource_names) for the
+        #   appropriate value for this field.
         # @param [Fixnum] options_requested_policy_version
         #   Optional. The maximum policy version that will be used to format the policy.
         #   Valid values are 0, 1, and 3. Requests specifying an invalid value will be
@@ -1162,8 +1170,9 @@ module Google
         # 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 [Resource
+        #   names](https://cloud.google.com/apis/design/resource_names) 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.
@@ -1200,8 +1209,9 @@ module Google
         # 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 [
+        #   Resource names](https://cloud.google.com/apis/design/resource_names) 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.
@@ -1339,8 +1349,9 @@ module Google
         # 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 [Resource
+        #   names](https://cloud.google.com/apis/design/resource_names) for the
+        #   appropriate value for this field.
         # @param [Fixnum] options_requested_policy_version
         #   Optional. The maximum policy version that will be used to format the policy.
         #   Valid values are 0, 1, and 3. Requests specifying an invalid value will be
@@ -1496,8 +1507,9 @@ module Google
         # 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 [Resource
+        #   names](https://cloud.google.com/apis/design/resource_names) 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.
@@ -1534,8 +1546,9 @@ module Google
         # 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 [
+        #   Resource names](https://cloud.google.com/apis/design/resource_names) 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.

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: google-apis-pubsub_v1
 version: !ruby/object:Gem::Version
-  version: 0.16.0
+  version: 0.19.0
 platform: ruby
 authors:
 - Google LLC
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2022-04-18 00:00:00.000000000 Z
+date: 2022-05-23 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: google-apis-core
@@ -58,7 +58,7 @@ licenses:
 metadata:
   bug_tracker_uri: https://github.com/googleapis/google-api-ruby-client/issues
   changelog_uri: https://github.com/googleapis/google-api-ruby-client/tree/main/generated/google-apis-pubsub_v1/CHANGELOG.md
-  documentation_uri: https://googleapis.dev/ruby/google-apis-pubsub_v1/v0.16.0
+  documentation_uri: https://googleapis.dev/ruby/google-apis-pubsub_v1/v0.19.0
   source_code_uri: https://github.com/googleapis/google-api-ruby-client/tree/main/generated/google-apis-pubsub_v1
 post_install_message: 
 rdoc_options: []