google-cloud-pubsub-v1 1.16.0 → 1.17.0

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

@@ -1,6 +1,6 @@
 # frozen_string_literal: true
 
-# Copyright 2020 Google LLC
+# Copyright 2026 Google LLC
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.
@@ -157,6 +157,12 @@ module Google
 
               # The Kinesis consumer does not exist.
               CONSUMER_NOT_FOUND = 5
+
+              # Indicates an error state where the ingestion source cannot be
+              # processed because the selected ingestion region is not permitted
+              # by the Regional Access Boundary (RAB) restrictions on the project's
+              # service account.
+              CONFLICTING_REGION_CONSTRAINTS = 6
             end
           end
 
@@ -256,6 +262,12 @@ module Google
               # The Cloud Storage bucket has too many objects, ingestion will be
               # paused.
               TOO_MANY_OBJECTS = 5
+
+              # Indicates an error state where the ingestion source cannot be
+              # processed because the selected ingestion region is not permitted
+              # by the Regional Access Boundary (RAB) restrictions on the project's
+              # service account.
+              CONFLICTING_REGION_CONSTRAINTS = 8
             end
           end
 
@@ -319,6 +331,12 @@ module Google
 
               # The provided Event Hubs resource group couldn't be found.
               RESOURCE_GROUP_NOT_FOUND = 7
+
+              # Indicates an error state where the ingestion source cannot be
+              # processed because the selected ingestion region is not permitted
+              # by the Regional Access Boundary (RAB) restrictions on the project's
+              # service account.
+              CONFLICTING_REGION_CONSTRAINTS = 8
             end
           end
 
@@ -369,6 +387,12 @@ module Google
 
               # The provided topic wasn't found.
               TOPIC_NOT_FOUND = 5
+
+              # Indicates an error state where the ingestion source cannot be
+              # processed because the selected ingestion region is not permitted
+              # by the Regional Access Boundary (RAB) restrictions on the project's
+              # service account.
+              CONFLICTING_REGION_CONSTRAINTS = 6
             end
           end
 
@@ -423,6 +447,12 @@ module Google
 
               # The provided topic wasn't found.
               TOPIC_NOT_FOUND = 6
+
+              # Indicates an error state where the ingestion source cannot be
+              # processed because the selected ingestion region is not permitted
+              # by the Regional Access Boundary (RAB) restrictions on the project's
+              # service account.
+              CONFLICTING_REGION_CONSTRAINTS = 7
             end
           end
         end
@@ -753,6 +783,40 @@ module Google
           extend ::Google::Protobuf::MessageExts::ClassMethods
         end
 
+        # Configuration for compressing/decompressing message data using a
+        # user-specified compression algorithm.
+        # @!attribute [rw] compression_algorithm
+        #   @return [::Google::Cloud::PubSub::V1::Compression::CompressionAlgorithm]
+        #     Required. Specifies the compression algorithm to use.
+        # @!attribute [rw] compression_mode
+        #   @return [::Google::Cloud::PubSub::V1::Compression::CompressionMode]
+        #     Required. Specifies whether to compress or decompress the message.
+        class Compression
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+
+          # The compression algorithm to use.
+          module CompressionAlgorithm
+            # Unspecified algorithm.
+            COMPRESSION_ALGORITHM_UNSPECIFIED = 0
+
+            # ZLIB compression.
+            ZLIB = 1
+          end
+
+          # The mode of the compression SMT.
+          module CompressionMode
+            # Unspecified mode.
+            COMPRESSION_MODE_UNSPECIFIED = 0
+
+            # Compress.
+            COMPRESS = 1
+
+            # Decompress.
+            DECOMPRESS = 2
+          end
+        end
+
         # Configuration for making inference requests against Vertex AI models.
         # @!attribute [rw] endpoint
         #   @return [::String]
@@ -793,14 +857,19 @@ module Google
         #     Optional. JavaScript User Defined Function. If multiple JavaScriptUDF's
         #     are specified on a resource, each must have a unique `function_name`.
         #
-        #     Note: The following fields are mutually exclusive: `javascript_udf`, `ai_inference`. If a field in that set is populated, all other fields in the set will automatically be cleared.
+        #     Note: The following fields are mutually exclusive: `javascript_udf`, `compression`, `ai_inference`. If a field in that set is populated, all other fields in the set will automatically be cleared.
+        # @!attribute [rw] compression
+        #   @return [::Google::Cloud::PubSub::V1::Compression]
+        #     Optional. Compression/Decompression.
+        #
+        #     Note: The following fields are mutually exclusive: `compression`, `javascript_udf`, `ai_inference`. If a field in that set is populated, all other fields in the set will automatically be cleared.
         # @!attribute [rw] ai_inference
         #   @return [::Google::Cloud::PubSub::V1::AIInference]
         #     Optional. AI Inference. Specifies the Vertex AI endpoint that inference
         #     requests built from the Pub/Sub message data and provided parameters will
         #     be sent to.
         #
-        #     Note: The following fields are mutually exclusive: `ai_inference`, `javascript_udf`. If a field in that set is populated, all other fields in the set will automatically be cleared.
+        #     Note: The following fields are mutually exclusive: `ai_inference`, `javascript_udf`, `compression`. If a field in that set is populated, all other fields in the set will automatically be cleared.
         # @!attribute [rw] enabled
         #   @deprecated This field is deprecated and may be removed in the next major version update.
         #   @return [::Boolean]
@@ -873,8 +942,9 @@ module Google
         #     resource. For example:
         #       "123/environment": "production",
         #       "123/costCenter": "marketing"
-        #     See https://docs.cloud.google.com/pubsub/docs/tags for more information on
-        #     using tags with Pub/Sub resources.
+        #     See
+        #     https://\\{$universe.dns_names.final_documentation_domain}/pubsub/docs/tags
+        #     for more information on using tags with Pub/Sub resources.
         class Topic
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -1137,9 +1207,10 @@ module Google
           extend ::Google::Protobuf::MessageExts::ClassMethods
         end
 
-        # 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.
+        # A subscription resource. If none of `push_config`, `bigquery_config`,
+        # `cloud_storage_config`, or `bigtable_config` is set, then the subscriber will
+        # pull and ack messages using API methods. At most one of these fields may be
+        # set.
         # @!attribute [rw] name
         #   @return [::String]
         #     Required. Identifier. The name of the subscription. It must have the format
@@ -1298,8 +1369,9 @@ module Google
         #     resource. For example:
         #       "123/environment": "production",
         #       "123/costCenter": "marketing"
-        #     See https://docs.cloud.google.com/pubsub/docs/tags for more information on
-        #     using tags with Pub/Sub resources.
+        #     See
+        #     https://\\{$universe.dns_names.final_documentation_domain}/pubsub/docs/tags
+        #     for more information on using tags with Pub/Sub resources.
         class Subscription
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -1551,11 +1623,13 @@ module Google
         #     a JSON object in the attributes column.
         # @!attribute [rw] drop_unknown_fields
         #   @return [::Boolean]
-        #     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.
+        #     Optional. If true and `use_topic_schema` is true, drops any fields that are
+        #     part of the topic schema that are not part of the BigQuery table schema
+        #     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. If true and `use_table_schema` is true, drops any
+        #     fields in the message that are not part of the BigQuery table schema when
+        #     writing to BigQuery. Otherwise, the write to BigQuery will fail.
         # @!attribute [r] state
         #   @return [::Google::Cloud::PubSub::V1::BigQueryConfig::State]
         #     Output only. An output-only field that indicates whether or not the
@@ -1612,8 +1686,9 @@ module Google
 
         # Configuration for a Bigtable subscription. The Pub/Sub message will be
         # written to a Bigtable row as follows:
-        # - row key: subscription name and message ID delimited by #.
-        # - columns: message bytes written to a single column family "data" with an
+        # - row key: subscription name, message ID hash, and message ID delimited by
+        #   `#`.
+        # - columns: message bytes written to a single column family `data` with an
         #   empty-string column qualifier.
         # - cell timestamp: the message publish timestamp.
         # @!attribute [rw] table
@@ -1660,16 +1735,15 @@ module Google
             # The subscription can actively send messages to Bigtable.
             ACTIVE = 1
 
-            # Cannot write to Bigtable because the instance, table, or app profile
-            # does not exist.
+            # Unused in the current implementation. Placeholder for future use.
             NOT_FOUND = 2
 
-            # Cannot write to Bigtable because the app profile is not configured for
-            # single-cluster routing.
+            # Unused in the current implementation. Placeholder for future use.
             APP_PROFILE_MISCONFIGURED = 3
 
             # Cannot write to Bigtable because of permission denied errors.
             # This can happen if:
+            # - The Bigtable instance, table, or app profile does not exist.
             # - The Pub/Sub service agent has not been granted the
             #   [appropriate Bigtable IAM permission
             #   bigtable.tables.mutateRows](\\{$universe.dns_names.final_documentation_domain}/bigtable/docs/access-control#permissions)
@@ -1677,8 +1751,9 @@ module Google
             #   ([instructions](\\{$universe.dns_names.final_documentation_domain}/service-usage/docs/enable-disable))
             PERMISSION_DENIED = 4
 
-            # Cannot write to Bigtable because of a missing column family ("data") or
-            # if there is no structured row key for the subscription name + message ID.
+            # Cannot write to Bigtable because of a missing column family (`data`), or
+            # if there is no structured row key for the subscription name + message ID,
+            # if because the app profile is not configured for single-cluster routing.
             SCHEMA_MISMATCH = 5
 
             # Cannot write to the destination because enforce_in_transit is set to true
@@ -2186,8 +2261,9 @@ module Google
         #     resource. For example:
         #       "123/environment": "production",
         #       "123/costCenter": "marketing"
-        #     See https://docs.cloud.google.com/pubsub/docs/tags for more information on
-        #     using tags with Pub/Sub resources.
+        #     See
+        #     https://\\{$universe.dns_names.final_documentation_domain}/pubsub/docs/tags
+        #     for more information on using tags with Pub/Sub resources.
         class CreateSnapshotRequest
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods

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

@@ -1,6 +1,6 @@
 # frozen_string_literal: true
 
-# Copyright 2020 Google LLC
+# Copyright 2026 Google LLC
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.
@@ -34,6 +34,11 @@ module Google
         #     The definition of the schema. This should contain a string representing
         #     the full definition of the schema that is a valid schema definition of
         #     the type specified in `type`.
+        # @!attribute [rw] compiled_proto_schema
+        #   @return [::Google::Cloud::PubSub::V1::CompiledProtoSchema]
+        #     Optional. Configuration for a schema provided as a pre-compiled Protocol
+        #     Buffer FileDescriptorSet. The `type` field above must be set to
+        #     PROTOCOL_BUFFER.
         # @!attribute [r] revision_id
         #   @return [::String]
         #     Output only. Immutable. The revision ID of the schema.
@@ -276,6 +281,18 @@ module Google
           extend ::Google::Protobuf::MessageExts::ClassMethods
         end
 
+        # Configuration specific to compiled Protocol Buffer schemas.
+        # @!attribute [rw] root_message
+        #   @return [::String]
+        #     Required. The name of the root message type in the schema.
+        # @!attribute [rw] compiled_bytes
+        #   @return [::String]
+        #     Required. The compiled FileDescriptorSet binary.
+        class CompiledProtoSchema
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
         # View of Schema object fields to be returned by GetSchema and ListSchemas.
         module SchemaView
           # The default / unset value.

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: google-cloud-pubsub-v1
 version: !ruby/object:Gem::Version
-  version: 1.16.0
+  version: 1.17.0
 platform: ruby
 authors:
 - Google LLC
@@ -51,10 +51,10 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '1.3'
-description: Cloud Pub/Sub is a fully-managed real-time messaging service that allows
-  you to send and receive messages between independent applications. Note that google-cloud-pubsub-v1
-  is a version-specific client library. For most uses, we recommend installing the
-  main client library google-cloud-pubsub instead. See the readme for more details.
+description: Provides reliable, many-to-many, asynchronous messaging between applications.
+  Note that google-cloud-pubsub-v1 is a version-specific client library. For most
+  uses, we recommend installing the main client library google-cloud-pubsub instead.
+  See the readme for more details.
 email: googleapis-packages@google.com
 executables: []
 extensions: []
@@ -67,15 +67,20 @@ files:
 - lib/google-cloud-pubsub-v1.rb
 - lib/google/cloud/pubsub/v1.rb
 - lib/google/cloud/pubsub/v1/_helpers.rb
+- lib/google/cloud/pubsub/v1/bindings_override.rb
 - lib/google/cloud/pubsub/v1/iam_policy.rb
 - lib/google/cloud/pubsub/v1/iam_policy/client.rb
 - lib/google/cloud/pubsub/v1/iam_policy/credentials.rb
 - lib/google/cloud/pubsub/v1/publisher.rb
 - lib/google/cloud/pubsub/v1/publisher/credentials.rb
+- lib/google/cloud/pubsub/v1/rest.rb
 - lib/google/cloud/pubsub/v1/schema_service.rb
 - lib/google/cloud/pubsub/v1/schema_service/client.rb
 - lib/google/cloud/pubsub/v1/schema_service/credentials.rb
 - lib/google/cloud/pubsub/v1/schema_service/paths.rb
+- lib/google/cloud/pubsub/v1/schema_service/rest.rb
+- lib/google/cloud/pubsub/v1/schema_service/rest/client.rb
+- lib/google/cloud/pubsub/v1/schema_service/rest/service_stub.rb
 - lib/google/cloud/pubsub/v1/subscriber.rb
 - lib/google/cloud/pubsub/v1/subscriber/credentials.rb
 - lib/google/cloud/pubsub/v1/subscription_admin.rb
@@ -83,11 +88,17 @@ files:
 - lib/google/cloud/pubsub/v1/subscription_admin/credentials.rb
 - lib/google/cloud/pubsub/v1/subscription_admin/helpers.rb
 - lib/google/cloud/pubsub/v1/subscription_admin/paths.rb
+- lib/google/cloud/pubsub/v1/subscription_admin/rest.rb
+- lib/google/cloud/pubsub/v1/subscription_admin/rest/client.rb
+- lib/google/cloud/pubsub/v1/subscription_admin/rest/service_stub.rb
 - lib/google/cloud/pubsub/v1/topic_admin.rb
 - lib/google/cloud/pubsub/v1/topic_admin/client.rb
 - lib/google/cloud/pubsub/v1/topic_admin/credentials.rb
 - lib/google/cloud/pubsub/v1/topic_admin/helpers.rb
 - lib/google/cloud/pubsub/v1/topic_admin/paths.rb
+- lib/google/cloud/pubsub/v1/topic_admin/rest.rb
+- lib/google/cloud/pubsub/v1/topic_admin/rest/client.rb
+- lib/google/cloud/pubsub/v1/topic_admin/rest/service_stub.rb
 - lib/google/cloud/pubsub/v1/version.rb
 - lib/google/pubsub/v1/pubsub_pb.rb
 - lib/google/pubsub/v1/pubsub_services_pb.rb
@@ -105,7 +116,6 @@ files:
 - proto_docs/google/protobuf/timestamp.rb
 - proto_docs/google/pubsub/v1/pubsub.rb
 - proto_docs/google/pubsub/v1/schema.rb
-- proto_docs/google/type/expr.rb
 homepage: https://github.com/googleapis/google-cloud-ruby
 licenses:
 - Apache-2.0

data/proto_docs/google/type/expr.rb

@@ -1,75 +0,0 @@
-# frozen_string_literal: true
-
-# Copyright 2020 Google LLC
-#
-# Licensed under the Apache License, Version 2.0 (the "License");
-# you may not use this file except in compliance with the License.
-# You may obtain a copy of the License at
-#
-#     https://www.apache.org/licenses/LICENSE-2.0
-#
-# Unless required by applicable law or agreed to in writing, software
-# distributed under the License is distributed on an "AS IS" BASIS,
-# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-# See the License for the specific language governing permissions and
-# limitations under the License.
-
-# Auto-generated by gapic-generator-ruby. DO NOT EDIT!
-
-
-module Google
-  module Type
-    # Represents a textual expression in the Common Expression Language (CEL)
-    # syntax. CEL is a C-like expression language. The syntax and semantics of CEL
-    # are documented at https://github.com/google/cel-spec.
-    #
-    # Example (Comparison):
-    #
-    #     title: "Summary size limit"
-    #     description: "Determines if a summary is less than 100 chars"
-    #     expression: "document.summary.size() < 100"
-    #
-    # Example (Equality):
-    #
-    #     title: "Requestor is owner"
-    #     description: "Determines if requestor is the document owner"
-    #     expression: "document.owner == request.auth.claims.email"
-    #
-    # Example (Logic):
-    #
-    #     title: "Public documents"
-    #     description: "Determine whether the document should be publicly visible"
-    #     expression: "document.type != 'private' && document.type != 'internal'"
-    #
-    # Example (Data Manipulation):
-    #
-    #     title: "Notification string"
-    #     description: "Create a notification string with a timestamp."
-    #     expression: "'New message received at ' + string(document.create_time)"
-    #
-    # The exact variables and functions that may be referenced within an expression
-    # are determined by the service that evaluates it. See the service
-    # documentation for additional information.
-    # @!attribute [rw] expression
-    #   @return [::String]
-    #     Textual representation of an expression in Common Expression Language
-    #     syntax.
-    # @!attribute [rw] title
-    #   @return [::String]
-    #     Optional. Title for the expression, i.e. a short string describing
-    #     its purpose. This can be used e.g. in UIs which allow to enter the
-    #     expression.
-    # @!attribute [rw] description
-    #   @return [::String]
-    #     Optional. Description of the expression. This is a longer text which
-    #     describes the expression, e.g. when hovered over it in a UI.
-    # @!attribute [rw] location
-    #   @return [::String]
-    #     Optional. String indicating the location of the expression for error
-    #     reporting, e.g. a file name and a position in the file.
-    class Expr
-      include ::Google::Protobuf::MessageExts
-      extend ::Google::Protobuf::MessageExts::ClassMethods
-    end
-  end
-end