As of January 1, 2020 this library no longer supports Python 2 on the latest released version. Library versions released prior to that date will continue to be available. For more information please visit Python 2 support on Google Cloud.

Changelog

PyPI History

2.38.0 (2026-09-17)

Features

• core: add request hook to enrich T4 network spans with GCP resource attributes (E) (#18272) (1ca95e9)

2.37.0 (2026-09-14)

Features

• gapic: add OpenTelemetry T3 client method span wrapping in gapic_v1.method (D) (#18274) (156e319)

2.36.0 (2026-09-03)

Features

• api-core: add ClientInterceptor and apply_interceptors helper (A) (#18236) (b6db5a9)

• api-core: add tracer_provider to ClientOptions for OTel support (#18139) (9ffebc2)

Bug Fixes

• api-core: handle list-shaped REST error payloads (#18232) (02d1fd8)

• api-core: move http encoding into transcode method (#18218) (082a99a)

2.35.0 (2026-08-21)

Features

• api_core: add deprecation warning for grpcio < 1.83.0 for PQC (#18045) (7e2e23e)

Bug Fixes

• api_core: improve rest path validation (#17753) (63bfb96)

• api_core: support suppress_metrics_header fallback in AuthMetadataPlugin (#18029) (dd2000d)

Documentation

• handwritten: centralize CONTRIBUTING.rst pointers (#17642) (23b9499)

2.34.0 (2026-08-06)

Features

• Add Feature Gating configuration helpers. (#17524) (eceea95)

• api-core: centralize rest transcoding helpers (#17765) (4f21b8b)

Bug Fixes

• api-core: use truthiness check in setup_request_id to support proto-plus messages (#18000) (ad8f93c)

• bump grpcio to 1.59.0; require Python 3.10+ (#17351) (a53487a)

• deduplicate x-goog-api-client headers (#17616) (6167e41)

• require Protobuf 6.33.5+ (#17743) (d267342)

2.33.0 (2026-07-22)

Features

• api_core: add request-id auto-population logic to gapic_v1 public helpers (#17738) (68e1313)

• api-core: add get_universe_domain helper to universe.py (#17799) (d461da7)

Bug Fixes

• api-core: prevent overwriting explicit empty strings for optional request_id (#17798) (07f7503)

2.32.0 (2026-07-16)

Features

• implement PEP 0810 lazy loading in operations_v1 (#17724) (22c5304)

Bug Fixes

• api_core: clarify misleading http 404 unimplemented error message (#17681) (00b9040)

2.31.0 (2026-06-02)

Documentation

• fix FAQ grammar in httplib2 example

• 774a0b8 (b79b3ea0c28e4b2d16aef8da14ad87c5735b1328)

• same block as other sections

• 9c72a41 Bump github/codeql-action from 4.33.0 to 4.34.1
• ebf7190 Bump github/codeql-action from 4.32.0 to 4.33.0
• 0e4ae38 (b79b3ea0c28e4b2d16aef8da14ad87c5735b1328)

• exclude Response.is_permanent_redirect from API docs (#7244)

• d568f47 (b79b3ea0c28e4b2d16aef8da14ad87c5735b1328)

• clarify Quickstart POST example (#6960)

• Additional commits viewable in compare view

(b79b3ea0c28e4b2d16aef8da14ad87c5735b1328)

Bug Fixes

• bump protobuf from 4.25.8 to 5.29.6 (#17021) (8f52e9ad30b58436480e35d462e9367172bd6656)

• drop support for Python 3.9 (#16980) (e5ed47205cb478a4b6ba8f602b7c7198911d086e)

2.30.3 (2026-04-09)

Bug Fixes

• avoid repeated scan of entire venv via packages_distributions() at import time (#16579) (c5728b24fac3363c10a8cfb315b96d3e6459cf06)

2.30.2 (2026-04-02)

Bug Fixes

• allow Protobuf 7.x (#16532) (ffb4b712121d04a38399e0bd3dc9773e96798564)

2.30.1 (2026-03-26)

Bug Fixes

• Allow Protobuf 7.x, require Python 3.9 (#16102) (ec9262c45055d3d2b596cdde1649d3ce90b4347d)

• Require Python 3.9 (ec9262c45055d3d2b596cdde1649d3ce90b4347d)

2.30.0 (2026-02-17)

Bug Fixes

• preserve exception cause (c7fc19303e0f1d7357109a73c13f875a5ced7606)

• require Python ≥ 3.9, protobuf ≥ 4.25.8 (2d1aa4288c222b247fc49ea0da03c126c051e079)

2.29.0 (2026-01-08)

Features

• Auto enable mTLS when supported certificates are detected (#869) (f8bf6f9610f3e0e7580f223794c3906513e1fa73)

• make parse_version_to_tuple public (#864) (c969186f2b66bde1df5e25bbedc5868e27d136f9)

Bug Fixes

• flaky tests due to imprecision in floating point calculation and performance test setup (#865) (93404080f853699b9217e4b76391a13525db4e3e)

• remove call to importlib.metadata.packages_distributions() for py38/py39 (#859) (628003e217d9a881d24f3316aecfd48c244a73f0)

• Log version check errors (#858) (6493118cae2720696c3d0097274edfd7fe2bce67)

• closes tailing streams in bidi classes. (#851) (c97b3a004044ebf8b35c2a7ba97409d7795e11b0)

2.28.1 (2025-10-28)

Bug Fixes

• Remove dependency on packaging and pkg_resources (#852) (ca59a86)

2.28.0 (2025-10-24)

Features

• Provide and use Python version support check (#832) (d36e896)

2.27.0 (2025-10-22)

Features

• Support for async bidi streaming apis (#836) (9530548)

2.26.0 (2025-10-08)

Features

• Add trove classifier for Python 3.14 (#842) (43690de)

2.25.2 (2025-10-01)

Bug Fixes

• Deprecate credentials_file argument (#841) (324eb74)

• Fix async tests and round-off error in test expectations (#837) (14a5978)

2.25.1 (2025-06-02)

Bug Fixes

• Allow BackgroundConsumer To Inform Caller of Fatal Exceptions with Optional Callback (3206c01)

2.25.0 (2025-05-06)

Features

• Add protobuf runtime version to x-goog-api-client header (#812) (118bd96)

• Support dynamic retry backoff values (#793) (70697a3)

Bug Fixes

• Resolve issue where pre-release versions of dependencies are installed (#808) (1ca7973)

2.24.2 (2025-03-06)

Bug Fixes

• deps: Allow protobuf 6.x (#804) (687be7c)

2.24.1 (2025-01-24)

Bug Fixes

• Memory leak in bidi classes (#770) (c1b8afa)

• Resolve the issue where rpc timeout of 0 is used when timeout expires (#776) (a5604a5)

Documentation

• Add warnings regarding consuming externally sourced credentials (#783) (0ec1825)

2.24.0 (2024-12-06)

Features

• Add automatic logging config to support debug logging (#754) (d18d9b5)

• Update recognized logging fields (#766) (5f80f77)

2.23.0 (2024-11-11)

Features

• Migrate to pyproject.toml (#736) (159e9a4)

2.22.0 (2024-10-25)

Features

• Add support for python 3.13 (#696) (46b3d3a)

Bug Fixes

• Add type hints to ClientOptions (#735) (b91ed19)

• Improve Any decode error (#712) (0d5ed37)

• Require proto-plus >= 1.25.0 for Python 3.13 (#740) (a26313e)

• Switch to unittest.mock from mock (#713) (8c53381)

2.21.0 (2024-10-07)

Features

• Add support for asynchronous long running operations (#724) (aaed69b)

Bug Fixes

• Set chunk size for async stream content (#702) (45b8a6d)

2.20.0 (2024-09-18)

Features

• Add async unsupported paramater exception (#694) (8c137fe)

• Add support for asynchronous rest streaming (#686) (1b7bb6d)

• Add support for creating exceptions from an asynchronous response (#688) (1c4b0d0)

2.19.2 (2024-08-16)

Bug Fixes

• Fail gracefully if could not import rpc_status module (#680) (7ccbf57)

2.19.1 (2024-06-19)

Bug Fixes

• Add support for protobuf 5.x (#644) (fda0ca6)

• Ignore unknown fields in rest streaming. (#651) (1203fb9)

2.19.0 (2024-04-29)

Features

• Add google.api_core.version_header (#638) (a7b53e9)

2.18.0 (2024-03-20)

Features

• Add common logic for supporting universe domain (#621) (94f2ca3)

Bug Fixes

• Add _registered_method to grpc ChannelStub (#614) (5eaaea8)

• deps: Require proto-plus >= 1.22.3 (#626) (4fed37c)

2.17.1 (2024-02-13)

Bug Fixes

• Resolve issue handling protobuf responses in rest streaming (#604) (bcebc92)

2.17.0 (2024-02-06)

Features

• Add attempt_direct_path argument to create_channel (#583) (94726e7)

Bug Fixes

• Retry constructors methods support None (#592) (416203c)

2.16.2 (2024-02-02)

Bug Fixes

• Spelling error a,out -> amount (#596) (88688b1)

2.16.1 (2024-01-30)

Bug Fixes

• Fix broken import for google.api_core.retry_async.AsyncRetry (#587) (ac012c0)

2.16.0 (2024-01-29)

Features

• Retry and retry_async support streaming rpcs (#495) (17ff5f1)

2.15.0 (2023-12-07)

Features

• Add support for Python 3.12 (#557) (091b4f1)

• Add type annotations to wrapped grpc calls (#554) (fc12b40)

• Add universe_domain argument to ClientOptions (3069ef4)

• Introduce compatibility with native namespace packages (#561) (bd82827)

Bug Fixes

• Fix regression in bidi causing Thread-ConsumeBidirectionalStream caught unexpected exception  and will exit (#562) (40c8ae0)

• Replace deprecated datetime.datetime.utcnow() (#552) (