google-cloud-pubsub 2.31.0__tar.gz → 2.32.0__tar.gz

{google_cloud_pubsub-2.31.0/google_cloud_pubsub.egg-info → google_cloud_pubsub-2.32.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: google-cloud-pubsub
-Version: 2.31.0
+Version: 2.32.0
 Summary: Google Cloud Pub/Sub API client library
 Home-page: https://github.com/googleapis/python-pubsub
 Author: Google LLC
@@ -19,11 +19,13 @@ Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
 Classifier: Operating System :: OS Independent
 Classifier: Topic :: Internet
 Requires-Python: >=3.7
 License-File: LICENSE
-Requires-Dist: grpcio<2.0.0,>=1.51.3
+Requires-Dist: grpcio<2.0.0,>=1.51.3; python_version < "3.14"
+Requires-Dist: grpcio<2.0.0,>=1.75.1; python_version >= "3.14"
 Requires-Dist: google-auth<3.0.0,>=2.14.1
 Requires-Dist: google-api-core[grpc]!=2.0.*,!=2.1.*,!=2.10.*,!=2.2.*,!=2.3.*,!=2.4.*,!=2.5.*,!=2.6.*,!=2.7.*,!=2.8.*,!=2.9.*,<3.0.0,>=1.34.0
 Requires-Dist: proto-plus<2.0.0,>=1.22.0

{google_cloud_pubsub-2.31.0 → google_cloud_pubsub-2.32.0}/google/cloud/pubsub_v1/open_telemetry/subscribe_opentelemetry.py

@@ -160,7 +160,7 @@ class SubscribeOpenTelemetry:
         assert self._scheduler_span is not None
         self._scheduler_span.end()
 
-    def start_process_span(self) -> None:
+    def start_process_span(self) -> trace.Span:
         assert self._subscribe_span is not None
         tracer = trace.get_tracer(_OPEN_TELEMETRY_TRACER_NAME)
         publish_create_span_link: Optional[trace.Link] = None
@@ -186,6 +186,7 @@ class SubscribeOpenTelemetry:
             end_on_exit=False,
         ) as process_span:
             self._process_span = process_span
+            return process_span
 
     def end_process_span(self) -> None:
         assert self._process_span is not None
@@ -200,6 +201,13 @@ class SubscribeOpenTelemetry:
             },
         )
 
+    def __enter__(self) -> trace.Span:
+        return self.start_process_span()
+
+    def __exit__(self, exc_type, exc_val, traceback):
+        if self._process_span:
+            self.end_process_span()
+
 
 def start_modack_span(
     subscribe_span_links: List[trace.Link],

{google_cloud_pubsub-2.31.0 → google_cloud_pubsub-2.32.0}/google/cloud/pubsub_v1/publisher/_sequencer/base.py

@@ -53,8 +53,8 @@ class Sequencer(metaclass=abc.ABCMeta):
     def publish(
         self,
         message: gapic_types.PubsubMessage,
-        retry: "OptionalRetry" = gapic_v1.method.DEFAULT,
-        timeout: gapic_types.TimeoutType = gapic_v1.method.DEFAULT,
+        retry: "OptionalRetry" = gapic_v1.method.DEFAULT,  # type: ignore
+        timeout: gapic_types.TimeoutType = gapic_v1.method.DEFAULT,  # type: ignore
     ) -> "futures.Future":  # pragma: NO COVER
         """Publish message for this ordering key.
 

{google_cloud_pubsub-2.31.0 → google_cloud_pubsub-2.32.0}/google/cloud/pubsub_v1/subscriber/_protocol/requests.py

@@ -32,6 +32,7 @@ class AckRequest(NamedTuple):
     ordering_key: Optional[str]
     future: Optional["futures.Future"]
     opentelemetry_data: Optional[SubscribeOpenTelemetry] = None
+    message_id: Optional[str] = None
 
 
 class DropRequest(NamedTuple):
@@ -52,6 +53,7 @@ class ModAckRequest(NamedTuple):
     seconds: float
     future: Optional["futures.Future"]
     opentelemetry_data: Optional[SubscribeOpenTelemetry] = None
+    message_id: Optional[str] = None
 
 
 class NackRequest(NamedTuple):

{google_cloud_pubsub-2.31.0 → google_cloud_pubsub-2.32.0}/google/cloud/pubsub_v1/subscriber/_protocol/streaming_pull_manager.py

@@ -21,7 +21,16 @@ import itertools
 import logging
 import threading
 import typing
-from typing import Any, Dict, Callable, Iterable, List, Optional, Set, Tuple
+from typing import (
+    Any,
+    Dict,
+    Callable,
+    Iterable,
+    List,
+    Optional,
+    Set,
+    Tuple,
+)
 import uuid
 
 from opentelemetry import trace
@@ -60,6 +69,12 @@ if typing.TYPE_CHECKING:  # pragma: NO COVER
 
 
 _LOGGER = logging.getLogger(__name__)
+_SLOW_ACK_LOGGER = logging.getLogger("slow-ack")
+_STREAMS_LOGGER = logging.getLogger("subscriber-streams")
+_FLOW_CONTROL_LOGGER = logging.getLogger("subscriber-flow-control")
+_CALLBACK_DELIVERY_LOGGER = logging.getLogger("callback-delivery")
+_CALLBACK_EXCEPTION_LOGGER = logging.getLogger("callback-exceptions")
+_EXPIRY_LOGGER = logging.getLogger("expiry")
 _REGULAR_SHUTDOWN_THREAD_NAME = "Thread-RegularStreamShutdown"
 _RPC_ERROR_THREAD_NAME = "Thread-OnRpcTerminated"
 _RETRYABLE_STREAM_ERRORS = (
@@ -145,18 +160,34 @@ def _wrap_callback_errors(
         callback: The user callback.
         message: The Pub/Sub message.
     """
+    _CALLBACK_DELIVERY_LOGGER.debug(
+        "Message (id=%s, ack_id=%s, ordering_key=%s, exactly_once=%s) received by subscriber callback",
+        message.message_id,
+        message.ack_id,
+        message.ordering_key,
+        message.exactly_once_enabled,
+    )
+
     try:
         if message.opentelemetry_data:
             message.opentelemetry_data.end_subscribe_concurrency_control_span()
-            message.opentelemetry_data.start_process_span()
-        callback(message)
+            with message.opentelemetry_data:
+                callback(message)
+        else:
+            callback(message)
     except BaseException as exc:
         # Note: the likelihood of this failing is extremely low. This just adds
         # a message to a queue, so if this doesn't work the world is in an
         # unrecoverable state and this thread should just bail.
-        _LOGGER.exception(
-            "Top-level exception occurred in callback while processing a message"
+
+        _CALLBACK_EXCEPTION_LOGGER.exception(
+            "Message (id=%s, ack_id=%s, ordering_key=%s, exactly_once=%s)'s callback threw exception, nacking message.",
+            message.message_id,
+            message.ack_id,
+            message.ordering_key,
+            message.exactly_once_enabled,
         )
+
         message.nack()
         on_callback_error(exc)
 
@@ -197,6 +228,9 @@ def _process_requests(
     error_status: Optional["status_pb2.Status"],
     ack_reqs_dict: Dict[str, requests.AckRequest],
     errors_dict: Optional[Dict[str, str]],
+    ack_histogram: Optional[histogram.Histogram] = None,
+    # TODO - Change this param to a Union of Literals when we drop p3.7 support
+    req_type: str = "ack",
 ):
     """Process requests when exactly-once delivery is enabled by referring to
     error_status and errors_dict.
@@ -207,28 +241,40 @@ def _process_requests(
     """
     requests_completed = []
     requests_to_retry = []
-    for ack_id in ack_reqs_dict:
+    for ack_id, ack_request in ack_reqs_dict.items():
+        # Debug logging: slow acks
+        if (
+            req_type == "ack"
+            and ack_histogram
+            and ack_request.time_to_ack > ack_histogram.percentile(percent=99)
+        ):
+            _SLOW_ACK_LOGGER.debug(
+                "Message (id=%s, ack_id=%s) ack duration of %s s is higher than the p99 ack duration",
+                ack_request.message_id,
+                ack_request.ack_id,
+            )
+
         # Handle special errors returned for ack/modack RPCs via the ErrorInfo
         # sidecar metadata when exactly-once delivery is enabled.
         if errors_dict and ack_id in errors_dict:
             exactly_once_error = errors_dict[ack_id]
             if exactly_once_error.startswith("TRANSIENT_"):
-                requests_to_retry.append(ack_reqs_dict[ack_id])
+                requests_to_retry.append(ack_request)
             else:
                 if exactly_once_error == "PERMANENT_FAILURE_INVALID_ACK_ID":
                     exc = AcknowledgeError(AcknowledgeStatus.INVALID_ACK_ID, info=None)
                 else:
                     exc = AcknowledgeError(AcknowledgeStatus.OTHER, exactly_once_error)
-                future = ack_reqs_dict[ack_id].future
+                future = ack_request.future
                 if future is not None:
                     future.set_exception(exc)
-                requests_completed.append(ack_reqs_dict[ack_id])
+                requests_completed.append(ack_request)
         # Temporary GRPC errors are retried
         elif (
             error_status
             and error_status.code in _EXACTLY_ONCE_DELIVERY_TEMPORARY_RETRY_ERRORS
         ):
-            requests_to_retry.append(ack_reqs_dict[ack_id])
+            requests_to_retry.append(ack_request)
         # Other GRPC errors are NOT retried
         elif error_status:
             if error_status.code == code_pb2.PERMISSION_DENIED:
@@ -237,20 +283,20 @@ def _process_requests(
                 exc = AcknowledgeError(AcknowledgeStatus.FAILED_PRECONDITION, info=None)
             else:
                 exc = AcknowledgeError(AcknowledgeStatus.OTHER, str(error_status))
-            future = ack_reqs_dict[ack_id].future
+            future = ack_request.future
             if future is not None:
                 future.set_exception(exc)
-            requests_completed.append(ack_reqs_dict[ack_id])
+            requests_completed.append(ack_request)
         # Since no error occurred, requests with futures are completed successfully.
-        elif ack_reqs_dict[ack_id].future:
-            future = ack_reqs_dict[ack_id].future
+        elif ack_request.future:
+            future = ack_request.future
             # success
             assert future is not None
             future.set_result(AcknowledgeStatus.SUCCESS)
-            requests_completed.append(ack_reqs_dict[ack_id])
+            requests_completed.append(ack_request)
         # All other requests are considered completed.
         else:
-            requests_completed.append(ack_reqs_dict[ack_id])
+            requests_completed.append(ack_request)
 
     return requests_completed, requests_to_retry
 
@@ -412,7 +458,7 @@ class StreamingPullManager(object):
         return self._dispatcher
 
     @property
-    def leaser(self) -> Optional[leaser.Leaser]:
+    def leaser(self) -> Optional["leaser.Leaser"]:
         """The leaser helper."""
         return self._leaser
 
@@ -558,8 +604,10 @@ class StreamingPullManager(object):
         with self._pause_resume_lock:
             if self.load >= _MAX_LOAD:
                 if self._consumer is not None and not self._consumer.is_paused:
-                    _LOGGER.debug(
-                        "Message backlog over load at %.2f, pausing.", self.load
+                    _FLOW_CONTROL_LOGGER.debug(
+                        "Message backlog over load at %.2f (threshold %.2f), initiating client-side flow control",
+                        self.load,
+                        _RESUME_THRESHOLD,
                     )
                     self._consumer.pause()
 
@@ -586,10 +634,18 @@ class StreamingPullManager(object):
             self._maybe_release_messages()
 
             if self.load < _RESUME_THRESHOLD:
-                _LOGGER.debug("Current load is %.2f, resuming consumer.", self.load)
+                _FLOW_CONTROL_LOGGER.debug(
+                    "Current load is %.2f (threshold %.2f), suspending client-side flow control.",
+                    self.load,
+                    _RESUME_THRESHOLD,
+                )
                 self._consumer.resume()
             else:
-                _LOGGER.debug("Did not resume, current load is %.2f.", self.load)
+                _FLOW_CONTROL_LOGGER.debug(
+                    "Current load is %.2f (threshold %.2f), retaining client-side flow control.",
+                    self.load,
+                    _RESUME_THRESHOLD,
+                )
 
     def _maybe_release_messages(self) -> None:
         """Release (some of) the held messages if the current load allows for it.
@@ -700,7 +756,7 @@ class StreamingPullManager(object):
 
         if self._exactly_once_delivery_enabled():
             requests_completed, requests_to_retry = _process_requests(
-                error_status, ack_reqs_dict, ack_errors_dict
+                error_status, ack_reqs_dict, ack_errors_dict, self.ack_histogram, "ack"
             )
         else:
             requests_completed = []
@@ -794,7 +850,11 @@ class StreamingPullManager(object):
 
         if self._exactly_once_delivery_enabled():
             requests_completed, requests_to_retry = _process_requests(
-                error_status, ack_reqs_dict, modack_errors_dict
+                error_status,
+                ack_reqs_dict,
+                modack_errors_dict,
+                self.ack_histogram,
+                "modack",
             )
         else:
             requests_completed = []
@@ -1237,6 +1297,11 @@ class StreamingPullManager(object):
             receipt_modack=True,
         )
 
+        if len(expired_ack_ids):
+            _EXPIRY_LOGGER.debug(
+                "ack ids %s were dropped as they have already expired.", expired_ack_ids
+            )
+
         with self._pause_resume_lock:
             if self._scheduler is None or self._leaser is None:
                 _LOGGER.debug(
@@ -1279,7 +1344,7 @@ class StreamingPullManager(object):
         Called whenever `self.consumer` receives a non-retryable exception.
         We close the manager on such non-retryable cases.
         """
-        _LOGGER.exception(
+        _LOGGER.info(
             "Streaming pull terminating after receiving non-recoverable error: %s",
             exception,
         )
@@ -1302,9 +1367,13 @@ class StreamingPullManager(object):
         # If this is in the list of idempotent exceptions, then we want to
         # recover.
         if isinstance(exception, _RETRYABLE_STREAM_ERRORS):
-            _LOGGER.debug("Observed recoverable stream error %s", exception)
+            _STREAMS_LOGGER.debug(
+                "Observed recoverable stream error %s, reopening stream", exception
+            )
             return True
-        _LOGGER.debug("Observed non-recoverable stream error %s", exception)
+        _STREAMS_LOGGER.debug(
+            "Observed non-recoverable stream error %s, shutting down stream", exception
+        )
         return False
 
     def _should_terminate(self, exception: BaseException) -> bool:
@@ -1324,9 +1393,13 @@ class StreamingPullManager(object):
         is_api_error = isinstance(exception, exceptions.GoogleAPICallError)
         # Terminate any non-API errors, or non-retryable errors (permission denied, unauthorized, etc.)
         if not is_api_error or isinstance(exception, _TERMINATING_STREAM_ERRORS):
-            _LOGGER.error("Observed terminating stream error %s", exception)
+            _STREAMS_LOGGER.debug(
+                "Observed terminating stream error %s, shutting down stream", exception
+            )
             return True
-        _LOGGER.debug("Observed non-terminating stream error %s", exception)
+        _STREAMS_LOGGER.debug(
+            "Observed non-terminating stream error %s, attempting to reopen", exception
+        )
         return False
 
     def _on_rpc_done(self, future: Any) -> None:

{google_cloud_pubsub-2.31.0 → google_cloud_pubsub-2.32.0}/google/cloud/pubsub_v1/subscriber/message.py

@@ -16,6 +16,7 @@ from __future__ import absolute_import
 
 import datetime as dt
 import json
+import logging
 import math
 import time
 import typing
@@ -43,6 +44,8 @@ Message {{
   attributes: {}
 }}"""
 
+_ACK_NACK_LOGGER = logging.getLogger("ack-nack")
+
 _SUCCESS_FUTURE = futures.Future()
 _SUCCESS_FUTURE.set_result(AcknowledgeStatus.SUCCESS)
 
@@ -274,6 +277,7 @@ class Message(object):
         time_to_ack = math.ceil(time.time() - self._received_timestamp)
         self._request_queue.put(
             requests.AckRequest(
+                message_id=self.message_id,
                 ack_id=self._ack_id,
                 byte_size=self.size,
                 time_to_ack=time_to_ack,
@@ -282,6 +286,12 @@ class Message(object):
                 opentelemetry_data=self.opentelemetry_data,
             )
         )
+        _ACK_NACK_LOGGER.debug(
+            "Called ack for message (id=%s, ack_id=%s, ordering_key=%s)",
+            self.message_id,
+            self.ack_id,
+            self.ordering_key,
+        )
 
     def ack_with_response(self) -> "futures.Future":
         """Acknowledge the given message.
@@ -322,6 +332,12 @@ class Message(object):
             pubsub_v1.subscriber.exceptions.AcknowledgeError exception
             will be thrown.
         """
+        _ACK_NACK_LOGGER.debug(
+            "Called ack for message (id=%s, ack_id=%s, ordering_key=%s, exactly_once=True)",
+            self.message_id,
+            self.ack_id,
+            self.ordering_key,
+        )
         if self.opentelemetry_data:
             self.opentelemetry_data.add_process_span_event("ack called")
             self.opentelemetry_data.end_process_span()
@@ -335,6 +351,7 @@ class Message(object):
         time_to_ack = math.ceil(time.time() - self._received_timestamp)
         self._request_queue.put(
             requests.AckRequest(
+                message_id=self.message_id,
                 ack_id=self._ack_id,
                 byte_size=self.size,
                 time_to_ack=time_to_ack,
@@ -382,6 +399,7 @@ class Message(object):
         """
         self._request_queue.put(
             requests.ModAckRequest(
+                message_id=self.message_id,
                 ack_id=self._ack_id,
                 seconds=seconds,
                 future=None,
@@ -445,6 +463,7 @@ class Message(object):
 
         self._request_queue.put(
             requests.ModAckRequest(
+                message_id=self.message_id,
                 ack_id=self._ack_id,
                 seconds=seconds,
                 future=req_future,
@@ -461,6 +480,13 @@ class Message(object):
         may take place immediately or after a delay, and may arrive at this subscriber
         or another.
         """
+        _ACK_NACK_LOGGER.debug(
+            "Called nack for message (id=%s, ack_id=%s, ordering_key=%s, exactly_once=%s)",
+            self.message_id,
+            self.ack_id,
+            self.ordering_key,
+            self._exactly_once_delivery_enabled_func(),
+        )
         if self.opentelemetry_data:
             self.opentelemetry_data.add_process_span_event("nack called")
             self.opentelemetry_data.end_process_span()
@@ -530,3 +556,7 @@ class Message(object):
         )
 
         return future
+
+    @property
+    def exactly_once_enabled(self):
+        return self._exactly_once_delivery_enabled_func()

{google_cloud_pubsub-2.31.0 → google_cloud_pubsub-2.32.0}/google/cloud/pubsub_v1/subscriber/scheduler.py

@@ -21,6 +21,7 @@ each message.
 import abc
 import concurrent.futures
 import queue
+import sys
 import typing
 from typing import Callable, List, Optional
 import warnings
@@ -37,7 +38,7 @@ class Scheduler(metaclass=abc.ABCMeta):
 
     @property
     @abc.abstractmethod
-    def queue(self) -> queue.Queue:  # pragma: NO COVER
+    def queue(self) -> "queue.Queue":  # pragma: NO COVER
         """Queue: A concurrency-safe queue specific to the underlying
         concurrency implementation.
 
@@ -162,7 +163,25 @@ class ThreadScheduler(Scheduler):
                 work_item = self._executor._work_queue.get(block=False)
                 if work_item is None:  # Exceutor in shutdown mode.
                     continue
-                dropped_messages.append(work_item.args[0])  # type: ignore[index]
+
+                dropped_message = None
+                if sys.version_info < (3, 14):
+                    # For Python < 3.14, work_item.args is a tuple of positional arguments.
+                    # The message is expected to be the first argument.
+                    if hasattr(work_item, "args") and work_item.args:
+                        dropped_message = work_item.args[0]  # type: ignore[index]
+                else:
+                    # For Python >= 3.14, work_item.task is (fn, args, kwargs).
+                    # The message is expected to be the first item in the args tuple (task[1]).
+                    if (
+                        hasattr(work_item, "task")
+                        and len(work_item.task) == 3
+                        and work_item.task[1]
+                    ):
+                        dropped_message = work_item.task[1][0]
+
+                if dropped_message is not None:
+                    dropped_messages.append(dropped_message)
         except queue.Empty:
             pass
 

{google_cloud_pubsub-2.31.0/google/pubsub_v1 → google_cloud_pubsub-2.32.0/google/pubsub}/gapic_version.py

@@ -13,4 +13,4 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 #
-__version__ = "2.31.0"  # {x-release-please-version}
+__version__ = "2.32.0"  # {x-release-please-version}

{google_cloud_pubsub-2.31.0/google/pubsub → google_cloud_pubsub-2.32.0/google/pubsub_v1}/gapic_version.py

@@ -13,4 +13,4 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 #
-__version__ = "2.31.0"  # {x-release-please-version}
+__version__ = "2.32.0"  # {x-release-please-version}

{google_cloud_pubsub-2.31.0 → google_cloud_pubsub-2.32.0}/google/pubsub_v1/services/publisher/client.py

@@ -725,7 +725,7 @@ class PublisherClient(metaclass=PublisherClientMeta):
 
             emulator_host = os.environ.get("PUBSUB_EMULATOR_HOST")
             if emulator_host:
-                if issubclass(transport_init, type(self)._transport_registry["grpc"]):
+                if issubclass(transport_init, type(self)._transport_registry["grpc"]):  # type: ignore
                     channel = grpc.insecure_channel(target=emulator_host)
                 else:
                     channel = grpc.aio.insecure_channel(target=emulator_host)

{google_cloud_pubsub-2.31.0 → google_cloud_pubsub-2.32.0}/google/pubsub_v1/services/schema_service/client.py

@@ -677,7 +677,7 @@ class SchemaServiceClient(metaclass=SchemaServiceClientMeta):
 
             emulator_host = os.environ.get("PUBSUB_EMULATOR_HOST")
             if emulator_host:
-                if issubclass(transport_init, type(self)._transport_registry["grpc"]):
+                if issubclass(transport_init, type(self)._transport_registry["grpc"]):  # type: ignore
                     channel = grpc.insecure_channel(target=emulator_host)
                 else:
                     channel = grpc.aio.insecure_channel(target=emulator_host)

{google_cloud_pubsub-2.31.0 → google_cloud_pubsub-2.32.0}/google/pubsub_v1/services/subscriber/client.py

@@ -729,7 +729,7 @@ class SubscriberClient(metaclass=SubscriberClientMeta):
 
             emulator_host = os.environ.get("PUBSUB_EMULATOR_HOST")
             if emulator_host:
-                if issubclass(transport_init, type(self)._transport_registry["grpc"]):
+                if issubclass(transport_init, type(self)._transport_registry["grpc"]):  # type: ignore
                     channel = grpc.insecure_channel(target=emulator_host)
                 else:
                     channel = grpc.aio.insecure_channel(target=emulator_host)

{google_cloud_pubsub-2.31.0 → google_cloud_pubsub-2.32.0}/google/pubsub_v1/types/pubsub.py

@@ -241,13 +241,13 @@ class IngestionDataSourceSettings(proto.Message):
                     Permission denied encountered while consuming data from
                     Kinesis. This can happen if:
 
-                    -  The provided ``aws_role_arn`` does not exist or does not
-                       have the appropriate permissions attached.
-                    -  The provided ``aws_role_arn`` is not set up properly for
-                       Identity Federation using ``gcp_service_account``.
-                    -  The Pub/Sub SA is not granted the
-                       ``iam.serviceAccounts.getOpenIdToken`` permission on
-                       ``gcp_service_account``.
+                    - The provided ``aws_role_arn`` does not exist or does not
+                      have the appropriate permissions attached.
+                    - The provided ``aws_role_arn`` is not set up properly for
+                      Identity Federation using ``gcp_service_account``.
+                    - The Pub/Sub SA is not granted the
+                      ``iam.serviceAccounts.getOpenIdToken`` permission on
+                      ``gcp_service_account``.
                 PUBLISH_PERMISSION_DENIED (3):
                     Permission denied encountered while publishing to the topic.
                     This can happen if the Pub/Sub SA has not been granted the
@@ -347,9 +347,9 @@ class IngestionDataSourceSettings(proto.Message):
                     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.
+                    - 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.
                 PUBLISH_PERMISSION_DENIED (3):
                     Permission denied encountered while publishing to the topic.
                     This can happen if the Pub/Sub SA has not been granted the
@@ -1991,11 +1991,11 @@ class Subscription(proto.Message):
             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 acknowledgment deadline
-               expires.
-            -  An acknowledged message will not be resent to a
-               subscriber.
+            - The message sent to a subscriber is guaranteed not to be
+              resent before the message's acknowledgment 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
@@ -2309,10 +2309,10 @@ class PushConfig(proto.Message):
             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.
+            - ``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" }``
         oidc_token (google.pubsub_v1.types.PushConfig.OidcToken):
@@ -2478,12 +2478,11 @@ class BigQueryConfig(proto.Message):
                 Cannot write to the BigQuery table because of permission
                 denied errors. This can happen if
 
-                -  Pub/Sub SA has not been granted the `appropriate BigQuery
-                   IAM
-                   permissions <https://cloud.google.com/pubsub/docs/create-subscription#assign_bigquery_service_account>`__
-                -  bigquery.googleapis.com API is not enabled for the
-                   project
-                   (`instructions <https://cloud.google.com/service-usage/docs/enable-disable>`__)
+                - Pub/Sub SA has not been granted the `appropriate BigQuery
+                  IAM
+                  permissions <https://cloud.google.com/pubsub/docs/create-subscription#assign_bigquery_service_account>`__
+                - bigquery.googleapis.com API is not enabled for the project
+                  (`instructions <https://cloud.google.com/service-usage/docs/enable-disable>`__)
             NOT_FOUND (3):
                 Cannot write to the BigQuery table because it
                 does not exist.
@@ -3111,6 +3110,11 @@ class StreamingPullRequest(proto.Message):
             only be set on the initial StreamingPullRequest. If it is
             set on a subsequent request, the stream will be aborted with
             status ``INVALID_ARGUMENT``.
+        protocol_version (int):
+            Optional. The protocol version used by the client. This
+            property can only be set on the initial
+            StreamingPullRequest. If it is set on a subsequent request,
+            the stream will be aborted with status ``INVALID_ARGUMENT``.
     """
 
     subscription: str = proto.Field(
@@ -3145,6 +3149,10 @@ class StreamingPullRequest(proto.Message):
         proto.INT64,
         number=8,
     )
+    protocol_version: int = proto.Field(
+        proto.INT64,
+        number=10,
+    )
 
 
 class StreamingPullResponse(proto.Message):

{google_cloud_pubsub-2.31.0 → google_cloud_pubsub-2.32.0/google_cloud_pubsub.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: google-cloud-pubsub
-Version: 2.31.0
+Version: 2.32.0
 Summary: Google Cloud Pub/Sub API client library
 Home-page: https://github.com/googleapis/python-pubsub
 Author: Google LLC
@@ -19,11 +19,13 @@ Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
 Classifier: Operating System :: OS Independent
 Classifier: Topic :: Internet
 Requires-Python: >=3.7
 License-File: LICENSE
-Requires-Dist: grpcio<2.0.0,>=1.51.3
+Requires-Dist: grpcio<2.0.0,>=1.51.3; python_version < "3.14"
+Requires-Dist: grpcio<2.0.0,>=1.75.1; python_version >= "3.14"
 Requires-Dist: google-auth<3.0.0,>=2.14.1
 Requires-Dist: google-api-core[grpc]!=2.0.*,!=2.1.*,!=2.10.*,!=2.2.*,!=2.3.*,!=2.4.*,!=2.5.*,!=2.6.*,!=2.7.*,!=2.8.*,!=2.9.*,<3.0.0,>=1.34.0
 Requires-Dist: proto-plus<2.0.0,>=1.22.0