google-cloud-storage

Bug Fixes

• update batch connection to request api endpoint info from client (#392) (91fc6d9)

Bug Fixes

• allow metadata keys to be cleared (#383) (79d27da), closes #381
• allow signed url version v4 without signed credentials (#356) (3e69bf9)
• correctly encode bytes for V2 signature (#382) (f44212b)

Features

• add mtls support (#367) (d35ab35)

Bug Fixes

• correctly decode times without microseconds (#375) (37a1eb5), closes #363
• expose num_retries parameter for blob upload methods (#353) (fdabd6a), closes #352
• pass the unused parameter (#349) (5c60d24)
• set custom_time on uploads (#374) (f048be1), closes #372

Bug Fixes

• address incorrect usage of request preconditions (#366) (321658c)
• Amend default retry behavior for bucket operations on client (#358) (b91e57d)

Features

• support ConnectionError retries for media operations (#342) (e55b25b)

Features

• make retry parameter public and added in other methods (#331) (910e34c)

Bug Fixes

• avoid triggering global logging config (#333) (602108a), closes #332
• fall back to 'charset' of 'content_type' in 'download_as_text' (#326) (63ff233), closes #319
• fix conditional retry handling of camelCase query params (#340) (4ff6141)
• retry uploads only conditionally (#316) (547740c)
• update 'custom_time' setter to record change (#323) (5174154), closes #322

Features

• add classifiers for python3.9 and remove for python3.5 (#295) (f072825)
• add testing support for Python 3.9, drop Python 3.5 (#313) (fa14009)

Bug Fixes

• use passed-in client within Blob.from_string and helpers (#290) (d457ce3), closes #286
• preserve metadata value when uploading new file content (#298) (5ab6b0d), closes #293

Features

• retry API calls with exponential backoff (#287) (fbe5d9c)

Bug Fixes

• field policy return string (#282) (c356b84)
• self-upload files for Unicode system test (#296) (6f865d9)
• use version.py for versioning, avoid issues with discovering version via get_distribution (#288) (fcd1c4f)

Documentation

• fix docstring example for 'blob.generate_signed_url' (#278) (2dc91c9)

Bug Fixes

• add requests as a dependency (#271) (ec52b38)
• preserve existing blob hashes when 'X-Goog-Hash header' is not present (#267) (277afb8)
• blob: base64 includes additional characters (#258) (cf0774a)

Documentation

• add docs signed_url expiration take default utc (#250) (944ab18)

Features

• add configurable checksumming for blob uploads and downloads (#246) (23b7d1c)
• add support for 'Blob.custom_time' and lifecycle rules (#199) (180873d)
• error message return from api (#235) (a8de586)
• storage: add support of daysSinceNoncurrentTime and noncurrentTimeBefore (#162) (136c097)
• pass 'client_options' to base class ctor (#225) (e1f91fc), closes #210
• rename 'Blob.download_as_{string,bytes}', add 'Blob.download_as_text' (#182) (73107c3)

Bug Fixes

• change datetime.now to utcnow (#251) (3465d08), closes #228
• extract hashes correctly during download (#238) (23cfb65)
• repair mal-formed docstring (#255) (e722376)

Documentation

• update docs build (via synth) (#222) (4c5adfa)

Features

• add timeouts to Blob methods where missing (#185) (6eeb855)
• auto-populate standard headers for non-chunked downloads (#204) (d8432cd), closes #24
• migrate to Service Account Credentials API (#189) (e4990d0)

Bug Fixes

• add multiprocessing.rst to synthool excludes (#186) (4d76e38)

Documentation

• fix indent in code blocks (#171) (62d1543), closes #170
• remove doubled word in docstring (#209) (7a4e7a5)

Documentation

• fix indent in code blocks (#171) (62d1543), closes #170
• remove doubled word in docstring (#209) (7a4e7a5)

Dependencies

• prep for grmp-1.0.0 release (#211) (55bae9a)

1.29.0 (2026-09-29)

Features

• declare Python3.15 support (05b0c34)

Bug Fixes

• anonymous credentials for private bucket (#107) (6152ab4)
• add bucket name into POST policy conditions (#118) (311ecab)

Features

• add arguments for *GenerationMatch uploading options (#111) (b11aa5f)

Bug Fixes

• fix incorrect mtime by UTC offset (#42) (76bd652)
• remove expiration strict conversion (#106) (9550dad), closes #105

Features

• generate signed URLs for blobs/buckets using virtual hostname (#58) (23df542)
• Add cname support for V4 signature (#72) (cc853af)
• add conformance tests for virtual hosted style signed URLs (#83) (5adc8b0)
• add get notification method (#77) (f602252)
• improve v4 signature query parameters encoding (#48) (8df0b55)

Bug Fixes

• fix blob metadata to None regression (#60) (a834d1b)
• add classifer for Python 3.8 (#63) (1b9b6bc)
• make v4 signing formatting consistent w/ spec (#56) (8712da8)
• use correct IAM object admin role (#71) (2e27edd)
• remove docstring of retrun in reload method (#78) (4abeb1c)
• use OrderedDict while encoding POST policy (#95) (df560e1)

Features

• add support for signing URLs using token (#9889) (ad280bf)
• add timeout parameter to public methods (#44) (63abf07)

Bug Fixes

• fix documentation of max_result parameter in list_blob (#43) (ff15f19)
• fix system test and change scope for iam access token (#47) (bc5375f)
• remove low version error assertion from iam conditions system tests (#53) (8904aee)

1.25.0 (2026-10-01)

Features

• declare Python3.15 support (8775794)

01-02-2020 13:20 PST

Implementation Changes

• Add 'ARCHIVE' storage class (#9533)

01-02-2020 10:39 PST

Implementation Changes

-str() metadata for for blob (#9796)

New Features

• Add timeout parameter to Batch interface to match google-cloud-core (#10010)

11-12-2019 12:57 PST

Implementation Changes

• Move create_bucket implementation from Bucket to Client. (#8604)

New Features

• Add opt-in raw download support. (#9572)

Dependencies

• Pin google-resumable-media >= 0.5.0, < 0.6dev. (#9572)

Documentation

• Add python 2 sunset banner to documentation. (#9036)

Internal / Testing Changes

• Fix query-string order dependent assert. (#9728)
• Normalize VPCSC configuration in system tests. (#9616)

11-05-2019 10:22 PST

New Features

• Add UBLA attrs to IAMConfiguration. (#9475)

10-28-2019 21:52 PDT

Implementation Changes

• Add gcloud-python header to user agent (#9551)
• Don't report a gapic version for storage (#9549)
• Update storage endpoint from www.googleapis.com to storage.googleapis.com (#9543)
• Call anonymous client method to remove dependency of google application credentials (#9455)
• Enable CSEK w/ V4 signed URLs (#9450)

New Features

• Support predefined ACLs in Bucket.create (#9334)

Documentation

• Add hmac_key and notification documentation rst files (#9529)
• Remove references to the old authentication credentials (#9456)
• Clarify docstring for Blob.download_as_string (#9332)

1.20.0 (2026-08-21)

Features

• sqlalchemy-spanner: export MAX_SIZE constant (#17922) (e15c21d)
• sqlalchemy-spanner: native UUID data type support in dialect (#17913) (6431932)

Bug Fixes

• bump sqlparse from 0.5.5 to 0.6.0 in /packages/sqlalchemy-spanner (#18136) (3ba7d02)
• sqlalchemy-spanner: fix get_multi_indexes crash on SEARCH indexes (#17907) (5b2da81)
• sqlalchemy-spanner: register TOKENLIST in _type_map for reflection (#17911) (788208b)

08-28-2019 09:45 PDT

Implementation Changes

• Expose 'HMACKeyMetadata.id' field. (#9115)
• Make 'Blob.bucket' a readonly property. (#9113)
• Clarify 'response_type' for signed_url methods. (#8942)

New Features

• Add client_options to constructors for manual clients. (#9054)

Documentation

• Remove compatability badges from READMEs. (#9035)

Internal / Testing Changes

• Remove CI for gh-pages, use googleapis.dev for api_core refs. (#9085)
• Fix tests broken by yesterday's google-resumable-media release. (#9119)
• Harden 'test_access_to_public_bucket' systest against 429 / 503 errors. (#8997)

08-07-2019 00:37 PDT

New Features

• Add HMAC key support. (#8430)

Documentation

• Mark old storage classes as legacy, not deprecated. (#8887)

Internal / Testing Changes

• Normalize 'lint' / 'blacken' support under nox. (#8831)
• Update intersphinx mapping for requests. (#8805)

07-24-2019 12:37 PDT

New Features

• Add Bucket.location_type property. (#8570)
• Add Client.list_blobs(bucket_or_name). (#8375)

Implementation Changes

• Retry bucket creation in signing setup. (#8620)
• Fix URI -> blob name conversion in Client download_blob_to_file. (#8440)
• Avoid escaping tilde in blob public / signed URLs. (#8434)
• Add generation to 'Blob.repr'. (#8423)

Documentation

• Link to googleapis.dev documentation in READMEs. (#8705)
• Add compatibility check badges to READMEs. (#8288)
• Fix example in Client.download_blob_to_file docstring. (#8629)
• Remove typing information for kwargs to not conflict with type checkers (#8546)

Internal / Testing Changes

• Skip failing test_bpo_set_unset_preserves_acls systest. (#8617)
• Add nox session 'docs'. (#8478)
• Add docs job to publish to googleapis.dev. (#8464)

06-04-2019 11:09 PDT

Dependencies

• Don't pin google-api-core in libs using google-cloud-core. (#8213)

Documentation

• Fix example in download_blob_to_file docstring. (#8201)
• Tweak fields docstring further. (#8040)
• Improve docs for fields argument to Bucket.list_blobs. (#8023)
• Fix docs typo. (#8027)

Internal / Testing Changes

• Retry harder in face of 409/429 during module teardown. (#8113)
• Add more retries for 429s during teardown operations. (#8112)

05-16-2019 12:55 PDT

New Features

• Update Client.create_bucket to take a Bucket object or string. (#7820)
• Update Client.get_bucket to take a Bucket object or string. (#7856)
• Add Client.download_blob_to_file method. (#7949)
• Add client_info support to client / connection. (#7872)

Dependencies

• Pin google-cloud-core >= 1.0.0, < 2.0dev. (#7993)
• Pin google-auth >= 1.2.0. (#7798)

04-17-2019 15:37 PDT

New Features

• Add support for V4 signed URLs (#7460)
• Add generation arguments to bucket / blob methods. (#7444)

Implementation Changes

• Remove classifier for Python 3.4 for end-of-life. (#7535)
• Ensure that 'Blob.reload' passes encryption headers. (#7441)

Documentation

• Update client library documentation URLs. (#7307)

Internal / Testing Changes

• Fix failing system tests (#7714)
• Increase number of retries for 429 errors. (#7484)
• Un-flake KMS integration tests expecting empty bucket. (#7479)

02-06-2019 12:49 PST

New Features

• Add 'Bucket.iam_configuration' property, enabling Bucket-Policy-Only. (#7066)

Documentation

• Improve docs for 'generate_signed_url'. (#7201)

12-17-2018 17:02 PST

Implementation Changes

• Update Blob.update_storage_class to support rewrite tokens. (#6527)

Internal / Testing Changes

• Skip signing tests for insufficient credentials (#6917)
• Document Python 2 deprecation (#6910)
• Normalize docs for page_size / max_results / page_token. (#6842)

12-10-2018 13:31 PST

Implementation Changes

• Import iam.policy from google.api_core. (#6741)
• Accomodate new back-end restriction on retention period. (#6388)
• Avoid deleting a blob renamed to itself (#6365)

Dependencies

• Update dependency to google-cloud-core (#6835)
• Bump minimum api_core version for all GAPIC libs to 1.4.1. (#6391)

Documentation

• Normalize use of support level badges (#6159)

Internal / Testing Changes

• Blacken libraries (#6794)
• Add templates for flake8, coveragerc, noxfile, and black. (#6642)
• Harden teardown in system tests. (#6444)
• Harden create_bucket call in systests vs. 429 TooManyRequests. (#6401)
• Skip public bucket test in VPC Service Controls (#6230)
• Fix lint failure. (#6219)
• Disable test running in VPC Service Controls restricted environment (#6215)
• Use new Nox (#6175)

New Features

• Add support for bucket retention policies (#5534)
• Allow destination.content_type to be None in Blob.compose. (#6031)

Implementation Changes

• Ensure that method for Blob.generate_signed_url is uppercase. (#6110)

Documentation

• Clarify GCS URL signing limitations on GCE (#6104)
• Redirect renamed 'usage.html'/'client.html' -> 'index.html'. (#5996)

New Features

• Add support for Python 3.7, drop support for Python 3.4. (#5942)
• Add lifecycle rules helpers to bucket. (#5877)

Implementation Changes

• Add 'stacklevel=2' to deprecation warnings. (#5897)

Documentation

• Storage docs: fix typos. (#5933)
• Prep storage docs for repo split. (#5923)

Internal / Testing Changes

• Harden systest teardown further. (#5900)
• Nox: use inplace installs (#5865)

Implementation Changes

• Preserve message / args from an InvalidResponse. (#5492)
• Fix generating signed urls for blobs with non-ascii names. (#5625)
• Move bucket location specification to Bucket.create; deprecate Bucket.location setter (#5808)

New Features

• Add Client.get_service_account_email. (#5765)

Documentation

• Clarify None values for resource-backed properties. (#5509)
• Elaborate docs for {Bucket,Blob}.make_{public,private}; note how to enable anonymous accesss to Blob.public_url. (#5767)

Internal / Testing Changes

• Harden create_bucket systest against 429 responses. (#5535)
• Add system test: signed URLs w/ non-ASCII blob name. (#5626)
• Harden tearDownModule against 429 TooManyRequests. (#5701)
• Retry notification.create() on 503 ServiceUnavailable. (#5741)
• Fix failing KMS system tests. (#5832, #5837, #5860)

1.10.0 (2026-09-29)

Features

• declare Python3.15 support (05b0c34)

1.9.0 (2026-09-24)

Features

• crc32c: support Python 3.15 (1bf979a)

New features

• Implement predefined acl (#4757)
• Add support for resumable signed url generation (#4789)

Implementation changes

• Do not quote embedded slashes for public / signed URLs (#4716)

Dependencies

• Update dependency range for api-core to include v1.0.0 releases (#4944)

Documentation

• Missing word in docstring (#4763)

Testing and internal changes

• Install local dependencies when running lint (#4936)
• Re-enable lint for tests, remove usage of pylint (#4921)
• Normalize all setup.py files (#4909)

Features

• Enable anonymous access to blobs in public buckets (#4315)
• Make project optional / overridable for storage client (#4381)
• Relax regex used to test for valid project IDs (#4543)
• Add support for source_generation parameter to Bucket.copy_blob (#4546)

1.6.0 (2026-10-01)

Features

• declare Python3.15 support (8775794)

1.5.0 (2026-10-01)

Features

• declare Python3.15 support (8775794)