google-cloud-pubsub-v1 0.23.0 → 1.4.0

data/proto_docs/google/api/client.rb

@@ -28,6 +28,9 @@ module Google
     # @!attribute [rw] destinations
     #   @return [::Array<::Google::Api::ClientLibraryDestination>]
     #     The destination where API teams want this client library to be published.
+    # @!attribute [rw] selective_gapic_generation
+    #   @return [::Google::Api::SelectiveGapicGeneration]
+    #     Configuration for which RPCs should be generated in the GAPIC client.
     class CommonLanguageSettings
       include ::Google::Protobuf::MessageExts
       extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -196,9 +199,32 @@ module Google
     # @!attribute [rw] common
     #   @return [::Google::Api::CommonLanguageSettings]
     #     Some settings.
+    # @!attribute [rw] experimental_features
+    #   @return [::Google::Api::PythonSettings::ExperimentalFeatures]
+    #     Experimental features to be included during client library generation.
     class PythonSettings
       include ::Google::Protobuf::MessageExts
       extend ::Google::Protobuf::MessageExts::ClassMethods
+
+      # Experimental features to be included during client library generation.
+      # These fields will be deprecated once the feature graduates and is enabled
+      # by default.
+      # @!attribute [rw] rest_async_io_enabled
+      #   @return [::Boolean]
+      #     Enables generation of asynchronous REST clients if `rest` transport is
+      #     enabled. By default, asynchronous REST clients will not be generated.
+      #     This feature will be enabled by default 1 month after launching the
+      #     feature in preview packages.
+      # @!attribute [rw] protobuf_pythonic_types_enabled
+      #   @return [::Boolean]
+      #     Enables generation of protobuf code using new types that are more
+      #     Pythonic which are included in `protobuf>=5.29.x`. This feature will be
+      #     enabled by default 1 month after launching the feature in preview
+      #     packages.
+      class ExperimentalFeatures
+        include ::Google::Protobuf::MessageExts
+        extend ::Google::Protobuf::MessageExts::ClassMethods
+      end
     end
 
     # Settings for Node client libraries.
@@ -280,9 +306,28 @@ module Google
     # @!attribute [rw] common
     #   @return [::Google::Api::CommonLanguageSettings]
     #     Some settings.
+    # @!attribute [rw] renamed_services
+    #   @return [::Google::Protobuf::Map{::String => ::String}]
+    #     Map of service names to renamed services. Keys are the package relative
+    #     service names and values are the name to be used for the service client
+    #     and call options.
+    #
+    #     publishing:
+    #       go_settings:
+    #         renamed_services:
+    #           Publisher: TopicAdmin
     class GoSettings
       include ::Google::Protobuf::MessageExts
       extend ::Google::Protobuf::MessageExts::ClassMethods
+
+      # @!attribute [rw] key
+      #   @return [::String]
+      # @!attribute [rw] value
+      #   @return [::String]
+      class RenamedServicesEntry
+        include ::Google::Protobuf::MessageExts
+        extend ::Google::Protobuf::MessageExts::ClassMethods
+      end
     end
 
     # Describes the generator configuration for a method.
@@ -290,6 +335,13 @@ module Google
     #   @return [::String]
     #     The fully qualified name of the method, for which the options below apply.
     #     This is used to find the method to apply the options.
+    #
+    #     Example:
+    #
+    #        publishing:
+    #          method_settings:
+    #          - selector: google.storage.control.v2.StorageControl.CreateFolder
+    #            # method settings for CreateFolder...
     # @!attribute [rw] long_running
     #   @return [::Google::Api::MethodSettings::LongRunning]
     #     Describes settings to use for long-running operations when generating
@@ -298,17 +350,14 @@ module Google
     #
     #     Example of a YAML configuration::
     #
-    #      publishing:
-    #        method_settings:
+    #        publishing:
+    #          method_settings:
     #          - selector: google.cloud.speech.v2.Speech.BatchRecognize
     #            long_running:
-    #              initial_poll_delay:
-    #                seconds: 60 # 1 minute
+    #              initial_poll_delay: 60s # 1 minute
     #              poll_delay_multiplier: 1.5
-    #              max_poll_delay:
-    #                seconds: 360 # 6 minutes
-    #              total_poll_timeout:
-    #                 seconds: 54000 # 90 minutes
+    #              max_poll_delay: 360s # 6 minutes
+    #              total_poll_timeout: 54000s # 90 minutes
     # @!attribute [rw] auto_populated_fields
     #   @return [::Array<::String>]
     #     List of top-level fields of the request message, that should be
@@ -317,8 +366,8 @@ module Google
     #
     #     Example of a YAML configuration:
     #
-    #      publishing:
-    #        method_settings:
+    #        publishing:
+    #          method_settings:
     #          - selector: google.example.v1.ExampleService.CreateExample
     #            auto_populated_fields:
     #            - request_id
@@ -354,6 +403,17 @@ module Google
       end
     end
 
+    # This message is used to configure the generation of a subset of the RPCs in
+    # a service for client libraries.
+    # @!attribute [rw] methods
+    #   @return [::Array<::String>]
+    #     An allowlist of the fully qualified names of RPCs that should be included
+    #     on public client surfaces.
+    class SelectiveGapicGeneration
+      include ::Google::Protobuf::MessageExts
+      extend ::Google::Protobuf::MessageExts::ClassMethods
+    end
+
     # The organization for which the client libraries are being published.
     # Affects the url where generated docs are published, etc.
     module ClientLibraryOrganization

data/proto_docs/google/api/resource.rb

@@ -124,8 +124,13 @@ module Google
     #   @return [::String]
     #     The plural name used in the resource name and permission names, such as
     #     'projects' for the resource name of 'projects/\\{project}' and the permission
-    #     name of 'cloudresourcemanager.googleapis.com/projects.get'. It is the same
-    #     concept of the `plural` field in k8s CRD spec
+    #     name of 'cloudresourcemanager.googleapis.com/projects.get'. One exception
+    #     to this is for Nested Collections that have stuttering names, as defined
+    #     in [AIP-122](https://google.aip.dev/122#nested-collections), where the
+    #     collection ID in the resource name pattern does not necessarily directly
+    #     match the `plural` value.
+    #
+    #     It is the same concept of the `plural` field in k8s CRD spec
     #     https://kubernetes.io/docs/tasks/access-kubernetes-api/custom-resources/custom-resource-definitions/
     #
     #     Note: The plural form is required even for singleton resources. See

data/proto_docs/google/pubsub/v1/pubsub.rb

@@ -71,6 +71,13 @@ module Google
         # @!attribute [rw] aws_kinesis
         #   @return [::Google::Cloud::PubSub::V1::IngestionDataSourceSettings::AwsKinesis]
         #     Optional. Amazon Kinesis Data Streams.
+        # @!attribute [rw] cloud_storage
+        #   @return [::Google::Cloud::PubSub::V1::IngestionDataSourceSettings::CloudStorage]
+        #     Optional. Cloud Storage.
+        # @!attribute [rw] platform_logs_settings
+        #   @return [::Google::Cloud::PubSub::V1::PlatformLogsSettings]
+        #     Optional. Platform Logs settings. If unset, no Platform Logs will be
+        #     generated.
         class IngestionDataSourceSettings
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -133,6 +140,190 @@ module Google
               CONSUMER_NOT_FOUND = 5
             end
           end
+
+          # Ingestion settings for Cloud Storage.
+          # @!attribute [r] state
+          #   @return [::Google::Cloud::PubSub::V1::IngestionDataSourceSettings::CloudStorage::State]
+          #     Output only. An output-only field that indicates the state of the Cloud
+          #     Storage ingestion source.
+          # @!attribute [rw] bucket
+          #   @return [::String]
+          #     Optional. Cloud Storage bucket. The bucket name must be without any
+          #     prefix like "gs://". See the [bucket naming requirements]
+          #     (https://cloud.google.com/storage/docs/buckets#naming).
+          # @!attribute [rw] text_format
+          #   @return [::Google::Cloud::PubSub::V1::IngestionDataSourceSettings::CloudStorage::TextFormat]
+          #     Optional. Data from Cloud Storage will be interpreted as text.
+          # @!attribute [rw] avro_format
+          #   @return [::Google::Cloud::PubSub::V1::IngestionDataSourceSettings::CloudStorage::AvroFormat]
+          #     Optional. Data from Cloud Storage will be interpreted in Avro format.
+          # @!attribute [rw] pubsub_avro_format
+          #   @return [::Google::Cloud::PubSub::V1::IngestionDataSourceSettings::CloudStorage::PubSubAvroFormat]
+          #     Optional. It will be assumed data from Cloud Storage was written via
+          #     [Cloud Storage
+          #     subscriptions](https://cloud.google.com/pubsub/docs/cloudstorage).
+          # @!attribute [rw] minimum_object_create_time
+          #   @return [::Google::Protobuf::Timestamp]
+          #     Optional. Only objects with a larger or equal creation timestamp will be
+          #     ingested.
+          # @!attribute [rw] match_glob
+          #   @return [::String]
+          #     Optional. Glob pattern used to match objects that will be ingested. If
+          #     unset, all objects will be ingested. See the [supported
+          #     patterns](https://cloud.google.com/storage/docs/json_api/v1/objects/list#list-objects-and-prefixes-using-glob).
+          class CloudStorage
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+
+            # Configuration for reading Cloud Storage data in text format. Each line of
+            # text as specified by the delimiter will be set to the `data` field of a
+            # Pub/Sub message.
+            # @!attribute [rw] delimiter
+            #   @return [::String]
+            #     Optional. When unset, '\n' is used.
+            class TextFormat
+              include ::Google::Protobuf::MessageExts
+              extend ::Google::Protobuf::MessageExts::ClassMethods
+            end
+
+            # Configuration for reading Cloud Storage data in Avro binary format. The
+            # bytes of each object will be set to the `data` field of a Pub/Sub
+            # message.
+            class AvroFormat
+              include ::Google::Protobuf::MessageExts
+              extend ::Google::Protobuf::MessageExts::ClassMethods
+            end
+
+            # Configuration for reading Cloud Storage data written via [Cloud Storage
+            # subscriptions](https://cloud.google.com/pubsub/docs/cloudstorage). The
+            # data and attributes fields of the originally exported Pub/Sub message
+            # will be restored when publishing.
+            class PubSubAvroFormat
+              include ::Google::Protobuf::MessageExts
+              extend ::Google::Protobuf::MessageExts::ClassMethods
+            end
+
+            # Possible states for ingestion from Cloud Storage.
+            module State
+              # Default value. This value is unused.
+              STATE_UNSPECIFIED = 0
+
+              # Ingestion is active.
+              ACTIVE = 1
+
+              # Permission denied encountered while calling the Cloud Storage API. This
+              # can happen if the Pub/Sub SA has not been granted the
+              # [appropriate
+              # permissions](https://cloud.google.com/storage/docs/access-control/iam-permissions):
+              # - storage.objects.list: to list the objects in a bucket.
+              # - storage.objects.get: to read the objects in a bucket.
+              # - storage.buckets.get: to verify the bucket exists.
+              CLOUD_STORAGE_PERMISSION_DENIED = 2
+
+              # Permission denied encountered while publishing to the topic. This can
+              # happen if the Pub/Sub SA has not been granted the [appropriate publish
+              # permissions](https://cloud.google.com/pubsub/docs/access-control#pubsub.publisher)
+              PUBLISH_PERMISSION_DENIED = 3
+
+              # The provided Cloud Storage bucket doesn't exist.
+              BUCKET_NOT_FOUND = 4
+
+              # The Cloud Storage bucket has too many objects, ingestion will be
+              # paused.
+              TOO_MANY_OBJECTS = 5
+            end
+          end
+        end
+
+        # Settings for Platform Logs produced by Pub/Sub.
+        # @!attribute [rw] severity
+        #   @return [::Google::Cloud::PubSub::V1::PlatformLogsSettings::Severity]
+        #     Optional. The minimum severity level of Platform Logs that will be written.
+        class PlatformLogsSettings
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+
+          # Severity levels of Platform Logs.
+          module Severity
+            # Default value. Logs level is unspecified. Logs will be disabled.
+            SEVERITY_UNSPECIFIED = 0
+
+            # Logs will be disabled.
+            DISABLED = 1
+
+            # Debug logs and higher-severity logs will be written.
+            DEBUG = 2
+
+            # Info logs and higher-severity logs will be written.
+            INFO = 3
+
+            # Warning logs and higher-severity logs will be written.
+            WARNING = 4
+
+            # Only error logs will be written.
+            ERROR = 5
+          end
+        end
+
+        # Payload of the Platform Log entry sent when a failure is encountered while
+        # ingesting.
+        # @!attribute [rw] topic
+        #   @return [::String]
+        #     Required. Name of the import topic. Format is:
+        #     projects/\\{project_name}/topics/\\{topic_name}.
+        # @!attribute [rw] error_message
+        #   @return [::String]
+        #     Required. Error details explaining why ingestion to Pub/Sub has failed.
+        # @!attribute [rw] cloud_storage_failure
+        #   @return [::Google::Cloud::PubSub::V1::IngestionFailureEvent::CloudStorageFailure]
+        #     Optional. Failure when ingesting from Cloud Storage.
+        class IngestionFailureEvent
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+
+          # Specifies the reason why some data may have been left out of
+          # the desired Pub/Sub message due to the API message limits
+          # (https://cloud.google.com/pubsub/quotas#resource_limits). For example,
+          # when the number of attributes is larger than 100, the number of
+          # attributes is truncated to 100 to respect the limit on the attribute count.
+          # Other attribute limits are treated similarly. When the size of the desired
+          # message would've been larger than 10MB, the message won't be published at
+          # all, and ingestion of the subsequent messages will proceed as normal.
+          class ApiViolationReason
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+          end
+
+          # Set when an Avro file is unsupported or its format is not valid. When this
+          # occurs, one or more Avro objects won't be ingested.
+          class AvroFailureReason
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+          end
+
+          # Failure when ingesting from a Cloud Storage source.
+          # @!attribute [rw] bucket
+          #   @return [::String]
+          #     Optional. Name of the Cloud Storage bucket used for ingestion.
+          # @!attribute [rw] object_name
+          #   @return [::String]
+          #     Optional. Name of the Cloud Storage object which contained the section
+          #     that couldn't be ingested.
+          # @!attribute [rw] object_generation
+          #   @return [::Integer]
+          #     Optional. Generation of the Cloud Storage object which contained the
+          #     section that couldn't be ingested.
+          # @!attribute [rw] avro_failure_reason
+          #   @return [::Google::Cloud::PubSub::V1::IngestionFailureEvent::AvroFailureReason]
+          #     Optional. Failure encountered when parsing an Avro file.
+          # @!attribute [rw] api_violation_reason
+          #   @return [::Google::Cloud::PubSub::V1::IngestionFailureEvent::ApiViolationReason]
+          #     Optional. The Pub/Sub API limits prevented the desired message from
+          #     being published.
+          class CloudStorageFailure
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+          end
         end
 
         # A topic resource.
@@ -500,7 +691,7 @@ module Google
         #     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.
+        #     7 days. Cannot be more than 31 days or less than 10 minutes.
         # @!attribute [rw] labels
         #   @return [::Google::Protobuf::Map{::String => ::String}]
         #     Optional. See [Creating and managing
@@ -579,10 +770,31 @@ module Google
         #   @return [::Google::Cloud::PubSub::V1::Subscription::State]
         #     Output only. An output-only field indicating whether or not the
         #     subscription can receive messages.
+        # @!attribute [r] analytics_hub_subscription_info
+        #   @return [::Google::Cloud::PubSub::V1::Subscription::AnalyticsHubSubscriptionInfo]
+        #     Output only. Information about the associated Analytics Hub subscription.
+        #     Only set if the subscritpion is created by Analytics Hub.
         class Subscription
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
 
+          # Information about an associated Analytics Hub subscription
+          # (https://cloud.google.com/bigquery/docs/analytics-hub-manage-subscriptions).
+          # @!attribute [rw] listing
+          #   @return [::String]
+          #     Optional. The name of the associated Analytics Hub listing resource.
+          #     Pattern:
+          #     "projects/\\{project}/locations/\\{location}/dataExchanges/\\{data_exchange}/listings/\\{listing}"
+          # @!attribute [rw] subscription
+          #   @return [::String]
+          #     Optional. The name of the associated Analytics Hub subscription resource.
+          #     Pattern:
+          #     "projects/\\{project}/locations/\\{location}/subscriptions/\\{subscription}"
+          class AnalyticsHubSubscriptionInfo
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+          end
+
           # @!attribute [rw] key
           #   @return [::String]
           # @!attribute [rw] value
@@ -814,6 +1026,14 @@ module Google
         #     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.
+        # @!attribute [rw] service_account_email
+        #   @return [::String]
+        #     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.
         class BigQueryConfig
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -885,10 +1105,22 @@ module Google
         #     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.
+        # @!attribute [rw] max_messages
+        #   @return [::Integer]
+        #     Optional. The maximum number of messages that can be written to a Cloud
+        #     Storage file before a new file is created. Min 1000 messages.
         # @!attribute [r] state
         #   @return [::Google::Cloud::PubSub::V1::CloudStorageConfig::State]
         #     Output only. An output-only field that indicates whether or not the
         #     subscription can receive messages.
+        # @!attribute [rw] service_account_email
+        #   @return [::String]
+        #     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.
         class CloudStorageConfig
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -911,6 +1143,10 @@ module Google
           #     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.
+          # @!attribute [rw] use_topic_schema
+          #   @return [::Boolean]
+          #     Optional. When true, the output Cloud Storage file will be serialized
+          #     using the topic schema, if it exists.
           class AvroConfig
             include ::Google::Protobuf::MessageExts
             extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -934,6 +1170,10 @@ module Google
             # Cannot write to the destination because enforce_in_transit is set to true
             # and the destination locations are not in the allowed regions.
             IN_TRANSIT_LOCATION_RESTRICTION = 4
+
+            # Cannot write to the Cloud Storage bucket due to an incompatibility
+            # between the topic schema and subscription settings.
+            SCHEMA_MISMATCH = 5
           end
         end
 

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: google-cloud-pubsub-v1
 version: !ruby/object:Gem::Version
-  version: 0.23.0
+  version: 1.4.0
 platform: ruby
 authors:
 - Google LLC
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2024-04-15 00:00:00.000000000 Z
+date: 2024-12-10 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: gapic-common
@@ -16,7 +16,7 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 0.21.1
+        version: 0.24.0
     - - "<"
       - !ruby/object:Gem::Version
         version: 2.a
@@ -26,7 +26,7 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 0.21.1
+        version: 0.24.0
     - - "<"
       - !ruby/object:Gem::Version
         version: 2.a
@@ -133,7 +133,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.5.6
+rubygems_version: 3.5.23
 signing_key: 
 specification_version: 4
 summary: Provides reliable, many-to-many, asynchronous messaging between applications.