google-apis-pubsub_v1 0.46.0 → 0.48.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f8aa4135ad74708c551374687ee080c06986ec534d1585004ef0679b732c38cf
-  data.tar.gz: 01f211cba9125dfc86c5e366f9e6cc1595c0ce6be81c26a4fa732f8161321a12
+  metadata.gz: 2c7ce610a64e2aa1325673f40746e173c01ffb05c46c275bd811ba7806438493
+  data.tar.gz: 563a6a949933ed6ee1179f2613179c0b4359a7e2534ff46af14497cef0166945
 SHA512:
-  metadata.gz: 6394ae827e9e1cbf2f74f18cbc41d4faed45d5e348b0ddab3d6200958b890063325399b390de2b11a5a424d155e53c65d0b1126e12d80d5f0daf258b0bee1d73
-  data.tar.gz: abc4d07cf456a1434849135adb73f78c0b3a3d7715d0076956eab932dd2b81ad6e6535f3308e46edaa595a530f702b180e211b029ebf72c88fb4a813192d7e6b
+  metadata.gz: 0b336fa85243903b8ad536805f7f89ee4ffcb7c52aab8df9c22d16234381b5c1a740610b6850709499e60a46a87ef7b6f5010be9bcbc83c69450470ac9651877
+  data.tar.gz: 4f1d5231a4a244101580857627dd12f10df82f2afc1fd278b083a6edfadbca3406edf6b770b0a5deda989940715958181129823e03a6d445e4fd421467853d19

data/CHANGELOG.md

@@ -1,5 +1,14 @@
 # Release history for google-apis-pubsub_v1
 
+### v0.48.0 (2024-02-11)
+
+* Regenerated from discovery document revision 20240201
+
+### v0.47.0 (2024-02-04)
+
+* Regenerated from discovery document revision 20240126
+* Regenerated using generator version 0.13.1
+
 ### v0.46.0 (2024-01-23)
 
 * Regenerated using generator version 0.13.0

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

@@ -67,6 +67,56 @@ module Google
         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
@@ -81,6 +131,15 @@ 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`
@@ -126,6 +185,7 @@ 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)
@@ -215,7 +275,10 @@ module Google
         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
@@ -277,6 +340,15 @@ module Google
         # @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`
@@ -301,6 +373,7 @@ module Google
           @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
@@ -504,6 +577,25 @@ 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
@@ -734,8 +826,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
@@ -984,9 +1076,9 @@ module Google
         # @return [String]
         attr_accessor :data
       
-        # Optional. ID of this message, assigned by the server when the message is
-        # published. Guaranteed to be unique within the topic. This value may be read by
-        # a subscriber that receives a `PubsubMessage` via a `Pull` call or a push
+        # ID of this message, assigned by the server when the message is published.
+        # Guaranteed to be unique within the topic. This value may be read by a
+        # subscriber that receives a `PubsubMessage` via a `Pull` call or a push
         # delivery. It must not be populated by the publisher in a `Publish` call.
         # Corresponds to the JSON property `messageId`
         # @return [String]
@@ -1003,9 +1095,9 @@ module Google
         # @return [String]
         attr_accessor :ordering_key
       
-        # Optional. The time at which the message was published, populated by the server
-        # when it receives the `Publish` call. It must not be populated by the publisher
-        # in a `Publish` call.
+        # The time at which the message was published, populated by the server when it
+        # receives the `Publish` call. It must not be populated by the publisher in a `
+        # Publish` call.
         # Corresponds to the JSON property `publishTime`
         # @return [String]
         attr_accessor :publish_time
@@ -1735,6 +1827,11 @@ module Google
       class Topic
         include Google::Apis::Core::Hashable
       
+        # 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/*`.
@@ -1786,12 +1883,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)
@@ -1799,6 +1902,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
       

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.46.0"
+      GEM_VERSION = "0.48.0"
 
       # Version of the code generator used to generate this client
-      GENERATOR_VERSION = "0.13.0"
+      GENERATOR_VERSION = "0.13.1"
 
       # Revision of the discovery document this client was generated from
-      REVISION = "20231212"
+      REVISION = "20240201"
     end
   end
 end

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

@@ -34,6 +34,12 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class AwsKinesis
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class BigQueryConfig
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -94,6 +100,12 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class IngestionDataSourceSettings
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class ListSchemaRevisionsResponse
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -354,10 +366,22 @@ module Google
         end
       end
       
+      class AwsKinesis
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :aws_role_arn, as: 'awsRoleArn'
+          property :consumer_arn, as: 'consumerArn'
+          property :gcp_service_account, as: 'gcpServiceAccount'
+          property :state, as: 'state'
+          property :stream_arn, as: 'streamArn'
+        end
+      end
+      
       class BigQueryConfig
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
           property :drop_unknown_fields, as: 'dropUnknownFields'
+          property :service_account_email, as: 'serviceAccountEmail'
           property :state, as: 'state'
           property :table, as: 'table'
           property :use_table_schema, as: 'useTableSchema'
@@ -386,6 +410,7 @@ module Google
           property :filename_suffix, as: 'filenameSuffix'
           property :max_bytes, :numeric_string => true, as: 'maxBytes'
           property :max_duration, as: 'maxDuration'
+          property :service_account_email, as: 'serviceAccountEmail'
           property :state, as: 'state'
           property :text_config, as: 'textConfig', class: Google::Apis::PubsubV1::TextConfig, decorator: Google::Apis::PubsubV1::TextConfig::Representation
       
@@ -445,6 +470,14 @@ module Google
         end
       end
       
+      class IngestionDataSourceSettings
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :aws_kinesis, as: 'awsKinesis', class: Google::Apis::PubsubV1::AwsKinesis, decorator: Google::Apis::PubsubV1::AwsKinesis::Representation
+      
+        end
+      end
+      
       class ListSchemaRevisionsResponse
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
@@ -748,6 +781,8 @@ module Google
       class Topic
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
+          property :ingestion_data_source_settings, as: 'ingestionDataSourceSettings', class: Google::Apis::PubsubV1::IngestionDataSourceSettings, decorator: Google::Apis::PubsubV1::IngestionDataSourceSettings::Representation
+      
           property :kms_key_name, as: 'kmsKeyName'
           hash :labels, as: 'labels'
           property :message_retention_duration, as: 'messageRetentionDuration'
@@ -757,6 +792,7 @@ module Google
           property :satisfies_pzs, as: 'satisfiesPzs'
           property :schema_settings, as: 'schemaSettings', class: Google::Apis::PubsubV1::SchemaSettings, decorator: Google::Apis::PubsubV1::SchemaSettings::Representation
       
+          property :state, as: 'state'
         end
       end
       

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

@@ -745,10 +745,11 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # 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.
+        # Updates an existing snapshot by updating the fields specified in the update
+        # mask. 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
         #   Optional. The name of the snapshot.
         # @param [Google::Apis::PubsubV1::UpdateSnapshotRequest] update_snapshot_request_object
@@ -1201,8 +1202,9 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Updates an existing subscription. Note that certain properties of a
-        # subscription, such as its topic, are not modifiable.
+        # Updates an existing subscription by updating the fields specified in the
+        # update mask. Note that certain properties of a subscription, such as its topic,
+        # are not modifiable.
         # @param [String] name
         #   Required. The name of the subscription. It must have the format `"projects/`
         #   project`/subscriptions/`subscription`"`. ``subscription`` must start with a
@@ -1577,8 +1579,8 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Updates an existing topic. Note that certain properties of a topic are not
-        # modifiable.
+        # Updates an existing topic by updating the fields specified in the update mask.
+        # Note that certain properties of a topic are not modifiable.
         # @param [String] name
         #   Required. The name of the topic. It must have the format `"projects/`project`/
         #   topics/`topic`"`. ``topic`` must start with a letter, and contain only letters

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: google-apis-pubsub_v1
 version: !ruby/object:Gem::Version
-  version: 0.46.0
+  version: 0.48.0
 platform: ruby
 authors:
 - Google LLC
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2024-01-23 00:00:00.000000000 Z
+date: 2024-02-11 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.46.0
+  documentation_uri: https://googleapis.dev/ruby/google-apis-pubsub_v1/v0.48.0
   source_code_uri: https://github.com/googleapis/google-api-ruby-client/tree/main/generated/google-apis-pubsub_v1
 post_install_message: 
 rdoc_options: []