Changelog

PyPI History

3.5.0 (2025-11-05)

Features

  • experimental: Add base resumption strategy for bidi streams (#1594) (5fb85ea)

  • experimental: Add checksum for bidi reads operation (#1566) (93ce515)

  • experimental: Add read resumption strategy (#1599) (5d5e895)

  • experimental: Handle BidiReadObjectRedirectedError for bidi reads (#1600) (71b0f8a)

  • Indicate that md5 is used as a CRC (#1522) (961536c)

  • Provide option to update user_agent (#1596) (02f1451)

Bug Fixes

  • Deprecate credentials_file argument (74415a2)

  • Flaky system tests for resumable_media (#1592) (7fee3dd)

  • Makedownload_ranges compatible withasyncio.create_task(..) (#1591) (faf8b83)

  • Makedownload_ranges compatible withasyncio.create_task(..) (#1591) (faf8b83)

  • Redact sensitive data from OTEL traces and fix env var parsing (#1553) (a38ca19)

  • Redact sensitive data from OTEL traces and fix env var parsing (#1553) (a38ca19)

  • Use separate header object for each upload in Transfer Manager MPU (#1595) (0d867bd)

3.4.1 (2025-10-08)

Bug Fixes

  • Fixes#1561 by adding an option to specify the entire object checksum for resumable uploads via theupload_from_string,upload_from_file, andupload_from_filename methods (acb918e)

3.4.0 (2025-09-15)

Features

Bug Fixes

  • GAPIC generation failed with ‘Directory not empty’ (#1542) (c80d820)

3.3.1 (2025-08-25)

Bug Fixes

  • Provide option to user to set entire object checksum at “initiate a resumable upload session” and send the same (#1525) (a8109e0)

  • Send part’s checksum for XML MPU part upload (#1529) (2ad77c7)

3.3.0 (2025-08-05)

Features

Bug Fixes

Documentation

  • Update the documentation of move_blob function (#1507) (72252e9)

3.2.0 (2025-07-04)

Features

3.1.1 (2025-06-13)

Bug Fixes

  • Add a check for partial response data (#1487) (7e0412a)

  • Add trove classifier for Python 3.13 (0100916)

  • deps: Require google-crc32c >= 1.1.3 (0100916)

  • deps: Require protobuf >= 3.20.2, < 7.0.0 (0100916)

  • deps: Require requests >= 2.22.0 (0100916)

  • Remove setup.cfg configuration for creating universal wheels (#1448) (d3b6b3f)

  • Resolve issue where pre-release versions of dependencies are installed (0100916)

  • Segmentation fault in tink while writing data (#1490) (2a46c0b)

Documentation

3.1.0 (2025-02-27)

Features

  • Add api_key argument to Client constructor (#1441) (c869e15)

  • Add Bucket.move_blob() for HNS-enabled buckets (#1431) (24c000f)

3.0.0 (2025-01-28)

⚠ BREAKING CHANGES

Please consult the README for details on this major version release.

  • The default checksum strategy for uploads has changed from None to “auto” (#1383)

  • The default checksum strategy for downloads has changed from “md5” to “auto” (#1383)

  • Deprecated positional argument “num_retries” has been removed (#1377)

  • Deprecated argument “text_mode” has been removed (#1379)

  • Blob.download_to_filename() now deletes the empty destination file on a 404 (#1394)

  • Media operations now use the same retry backoff, timeout and custom predicate system as non-media operations, which may slightly impact default retry behavior (#1385)

  • Retries are now enabled by default for uploads, blob deletes and blob metadata updates (#1400)

Features

  • Add “auto” checksum option and make default (#1383) (5375fa0)

  • Blob.download_to_filename() deletes the empty destination file on a 404 (#1394) (066be2d)

  • Enable custom predicates for media operations (#1385) (f3517bf)

  • Integrate google-resumable-media (#1283) (bd917b4)

  • Retry by default for uploads, blob deletes, metadata updates (#1400) (0426005)

Bug Fixes

  • Cancel upload when BlobWriter exits with exception (#1243) (df107d2)

  • Changed name of methodsBlob.from_string() andBucket.from_string() tofrom_uri() (#1335) (58c1d03)

  • Correctly calculate starting offset for retries of ranged reads (#1376) (7b6c9a0)

  • Filter download_kwargs in BlobReader (#1411) (0c21210)

  • Remove deprecated num_retries argument (#1377) (58b5040)

  • Remove deprecated text_mode argument (#1379) (4d20a8e)

Documentation

2.19.0 (2024-11-21)

Features

  • Add integration test for universe domain (#1346) (02a972d)

  • Add restore_bucket and handling for soft-deleted buckets (#1365) (ab94efd)

  • Add support for restore token (#1369) (06ed15b)

  • IAM signBlob retry and universe domain support (#1380) (abc8061)

Bug Fixes

  • Allow signed post policy v4 with service account and token (#1356) (8ec02c0)

  • Do not spam the log with checksum related INFO messages when downloading using transfer_manager (#1357) (42392ef)

2.18.2 (2024-08-08)

Bug Fixes

  • Add regression test for range read retry issue and bump dependency to fix (#1338) (0323647)

2.18.1 (2024-08-05)

Bug Fixes

  • Properly escape URL construction for XML MPU API, fixing a path traversal issue that allowed uploads to unintended buckets. Reported by @jdomeracki. (#1333) (bf4d0e0)

2.18.0 (2024-07-09)

Features

  • Add OpenTelemetry Tracing support as a preview feature (#1288) (c2ab0e0)

Bug Fixes

2.17.0 (2024-05-22)

Features

Bug Fixes

  • Remove deprecated methods in samples and tests (#1274) (4db96c9)

Documentation

  • Reference Storage Control in readme (#1254) (3d6d369)

  • Update DEFAULT_RETRY_IF_GENERATION_SPECIFIED docstrings (#1234) (bdd426a)

2.16.0 (2024-03-18)

Features

2.15.0 (2024-02-28)

Features

Bug Fixes

2.14.0 (2023-12-10)

Features

Bug Fixes

  • Clarify error message and docstrings in Blob class method (#1196) (92c20d3)

  • Propagate timeout in BlobWriter (#1186) (22f36da), closes#1184

  • Use native namespace to avoid pkg_resources warnings (#1176) (2ed915e)

2.13.0 (2023-10-31)

Features

Bug Fixes

  • Blob.from_string parse storage uri with regex (#1170) (0a243fa)

  • Bucket.delete(force=True) now works with version-enabled buckets (#1172) (0de09d3)

  • Fix typo in Bucket.clear_lifecycle_rules() (#1169) (eae9ebe)

Documentation

2.12.0 (2023-10-12)

Features

  • Add additional_blob_attributes to upload_many_from_filenames (#1162) (c7229f2)

  • Add crc32c_checksum argument to download_chunks_concurrently (#1138) (fc92ad1)

  • Add skip_if_exists to download_many (#1161) (c5a983d)

  • Launch transfer manager to GA (#1159) (5c90563)

Bug Fixes

  • Bump python-auth version to fix issue and remove workaround (#1158) (28c02dd)

  • Mark _deprecate_threads_param as a wrapper to unblock introspection and docs (#1122) (69bd4a9)

Documentation

  • Add snippets for upload_chunks_concurrently and add chunk_size (#1135) (3a0f551)

  • Update formatting and wording in transfer_manager docstrings (#1163) (9e460d8)

2.11.0 (2023-09-19)

Features

  • Add gccl-gcs-cmd field to X-Goog-API-Client header for Transfer Manager calls (#1119) (14a1909)

  • Add transfer_manager.upload_chunks_concurrently using the XML MPU API (#1115) (56aeb87)

  • Support configurable retries in upload_chunks_concurrently (#1120) (1271686)

Bug Fixes

  • Split retention period tests due to caching change (#1068) (cc191b0)

Documentation

  • Add Transfer Manager documentation in c.g.c (#1109) (c1f8724)

2.10.0 (2023-06-14)

Features

  • Add matchGlob parameter to list_blobs (#1055) (d02098e)

  • Allow exceptions to be included in batch responses (#1043) (94a35ba)

Bug Fixes

  • Extend wait for bucket metadata consistency in system tests (#1053) (d78586c)

Documentation

2.9.0 (2023-05-04)

Features

  • Un-deprecate blob.download_to_file(), bucket.create(), and bucket.list_blobs() (#1013) (aa4f282)

Bug Fixes

  • Avoid pickling processed credentials (#1016) (7935824)

  • Improve test error message for missing credentials (#1024) (892481a)

Documentation

  • Add sample and sample test for transfer manager (#1027) (4698799)

  • Remove threads in transfer manager samples (#1029) (30c5146)

2.8.0 (2023-03-29)

Features

  • Add multiprocessing and chunked downloading to transfer manager (#1002) (e65316b)

Bug Fixes

Documentation

2.7.0 (2022-12-07)

Features

  • Add “transfer_manager” module for concurrent uploads and downloads, as a preview feature (#943) (9998a5e)

  • Add use_auth_w_custom_endpoint support (#941) (5291c08)

Bug Fixes

  • Implement closed property on fileio.py classes (#907) (64406ca)

2.6.0 (2022-11-07)

Features

  • Add Autoclass support and samples (#791) (9ccdc5f), closes#797

  • Add predefined_acl to create_resumable_upload_session (#878) (2b3e8f9)

  • Enable delete_blobs() to preserve generation (#840) (8fd4c37), closes#814

  • Make tests run against environments other than prod (#883) (7dfeb62)

Bug Fixes

  • Align bucket bound hostname url builder consistency (#875) (8a24add)

  • BlobWriter.close() will do nothing if already closed (#887) (7707220)

  • Remove client side validations (#868) (928ebbc)

Documentation

  • Update comments in list_blobs sample (#866) (9469f5d)

  • Clarify prefixes entity in list_blobs usage (#837) (7101f47)

  • Streamline docs for migration (#876) (7c8a178)

  • Update docstring for lifecycle_rules to match generator behavior (#841) (36fb81b)

2.5.0 (2022-07-24)

Features

  • Custom Placement Config Dual Region Support (#819) (febece7)

Documentation

  • open file-like objects in byte mode for uploads (#824) (4bd3d1d)

2.4.0 (2022-06-07)

Features

Bug Fixes

  • fix rewrite object in CMEK enabled bucket (#807) (9b3cbf3)

Documentation

  • fix changelog header to consistent size (#802) (4dd0907)

  • samples: Update the Recovery Point Objective (RPO) sample output (#725) (b0bf411)

  • Update generation_metageneration.rst with a missing space (#798) (1e7cdb6)

  • update retry docs (#808) (c365d5b)

2.3.0 (2022-04-12)

Features

  • add dual region bucket support and sample (#748) (752e8ab)

  • track invocation id for retry metrics (#741) (bd56931)

Bug Fixes

Documentation

2.2.1 (2022-03-15)

Bug Fixes

2.2.0 (2022-03-14)

Features

  • allow no project in client methods using storage emulator (#703) (bcde0ec)

Bug Fixes

  • add user agent in python-storage when calling resumable media (c7bf615)

  • deps: require google-api-core>=1.31.5, >=2.3.2 (#722) (e9aab38)

  • Fix BlobReader handling of interleaved reads and seeks (#721) (5d1cfd2)

  • retry client side requests timeout (#727) (e0b3b35)

Documentation

2.1.0 (2022-01-19)

Features

2.0.0 (2022-01-12)

⚠ BREAKING CHANGES

  • Remove Python 2 support (#657)

Features

1.44.0 (2022-01-05)

Features

Documentation

  • Describe code sample more specifically (#660) (0459cb4)

  • refresh readme instructions (#667) (ceb9314)

  • This is just a simple PR to better describe what the code is doing in the comments. (0459cb4)

  • use writeable streamin example for ‘download_blob_to_file’ (#676) (96092d4)

1.43.0 (2021-11-15)

Features

Bug Fixes

  • raise a ValueError in BucketNotification.create() if a topic name is not set (#617) (9dd78df)

Documentation

  • add contributing and authoring guides under samples/ (#633) (420591a)

  • add links to samples and how to guides (#641) (49f78b0)

  • add README to samples subdirectory (#639) (58af882)

  • update samples readme with cli args (#651) (75dda81)

1.42.3 (2021-09-30)

Bug Fixes

  • changeover unspecified to inherited (#603) (283a419)

  • check response code in batch.finish (#609) (318a286)

  • skip tests that use unspecified pap until we get the change in (#600) (38b9b55)

1.42.2 (2021-09-16)

Bug Fixes

  • add preconditions and retry config support to ACL patch operationss (#586) (4333caf)

  • add unpinned protobuf for python3 (#592) (53f7ad0)

  • pin six as a required dependency (#589) (9ca97bf)

1.42.1 (2021-09-07)

Bug Fixes

  • do not append duplicates to user agent string (#570) (57cf3a1)

Documentation

  • pass explicit ‘client’ in ‘{Blob.Bucket}.from_string’ examples (#545) (6eff22d)

1.42.0 (2021-08-05)

Features

  • add ‘page_size’ parameter to ‘Bucket.list_blobs, list_buckets (#520) (c5f4ad8)

Bug Fixes

  • deps: add explicit ranges for ‘google-api-core’ and ‘google-auth’ (#530) (310f207)

  • downloading no longer marks metadata fields as ‘changed’ (#523) (160d1ec)

  • make ‘requests.exceptions.ChunkedEncodingError retryable by default (#526) (4abb403)

Documentation

  • update supported / removed Python versions in README (#519) (1f1b138)

1.41.1 (2021-07-20)

Bug Fixes

  • deps: pin{api,cloud}-core,auth to allow 2.x versions on Python 3 (#512) (4d7500e)

  • remove trailing commas from error message constants (#505) (d4a86ce), closes#501

Documentation

  • replace usage of deprecated functiondownload_as_string in docs (#508) (8dfa4d4)

1.41.0 (2021-07-13)

Features

Bug Fixes

  • deps: update minimum dependency versions to pick up bugfixes (#496) (92251a5), closes#494

  • populate etag / generation / metageneration properties during download (#488) (49ba14c)

  • revise and rename is_etag_in_json(data) (#483) (0a52546)

1.40.0 (2021-06-30)

Features

  • add preconditions and retry configuration to blob.create_resumable_upload_session (#484) (0ae35ee)

  • add public access prevention to bucket IAM configuration (#304) (e3e57a9)

Bug Fixes

  • replace default retry for upload operations (#480) (c027ccf)

1.39.0 (2021-06-21)

Features

  • media operation retries can be configured using the same interface as with non-media operation (#447) (0dbbb8a)

Bug Fixes

  • add ConnectionError to default retry (#445) (8344253)

  • apply idempotency policies for ACLs (#458) (2232f38)

  • replace python lifecycle action parsing ValueError with warning (#437) (2532d50)

  • revise blob.compose query parametersif_generation_match (#454) (70d19e7)

Documentation

  • streamline ‘timeout’ / ‘retry’ docs in docstrings (#461) (78b2eba)

  • streamline docstrings for conditional parmas (#464) (6999370)

1.38.0 (2021-04-26)

Features

  • add getters and setters for encryption_key and kms_key_name (#409) (2adfb59)

Bug Fixes

Documentation

  • revise docstrings for generate_signed_url (#408) (f090548)

1.37.1 (2021-04-02)

Bug Fixes

  • Ensure consistency check in test runs even if expected error occurs (#402) (416bcd4)

  • silence expected errors for routine operations on BlobReader (#400) (d52853b)

1.37.0 (2021-03-24)

Features

Bug Fixes

  • update user_project usage and documentation in bucket/client class methods (#396) (1a2734b)

1.36.2 (2021-03-09)

Bug Fixes

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

1.36.1 (2021-02-19)

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)

1.36.0 (2021-02-10)

Features

Bug Fixes

1.35.1 (2021-01-28)

Bug Fixes

  • address incorrect usage of request preconditions (#366) (321658c)

  • Amend default retry behavior for bucket operations on client (#358) (b91e57d)

1.35.0 (2020-12-14)

Features

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

1.34.0 (2020-12-11)

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

1.33.0 (2020-11-16)

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-inclient withinBlob.from_string and helpers (#290) (d457ce3), closes#286

  • preservemetadata value when uploading new file content (#298) (5ab6b0d), closes#293

1.32.0 (2020-10-16)

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)

1.31.2 (2020-09-23)

Documentation

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

1.31.1 (2020-09-16)

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)

1.31.0 (2020-08-26)

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

Documentation

1.30.0 (2020-07-24)

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

Documentation

Dependencies

1.29.0 (2020-06-09)

Features

  • addgenerationmatch args into Blob.compose() (#122) (dc01c59)

  • add Bucket.reload() and Bucket.update() wrappers to restrict generation match args (#153) (76dd9ac), closes#127

  • add helper for bucket bound hostname URLs (#137) (b26f9fa), closes#121

  • add ifgenerationmatch support for Bucket.rename_blob() (#141) (f52efc8)

  • add ifgenerationMatch support, pt1 (#123) (0944442)

  • add offset and includeTrailingPrefix options to list_blobs (#125) (d84c0dd)

  • Create CODEOWNERS (#135) (32a8d55)

Bug Fixes

  • add documentaion of list_blobs with user project (#147) (792b21f)

  • add projection parameter to blob.reload method (#146) (ddad20b)

  • add unused variables to method generation match (#152) (f6574bb)

  • change the method names in snippets file (#161) (e516ed9)

  • fix upload object with bucket cmek enabled (#158) (5f27ffa)

  • set default POST policy scheme to “http” (#172) (90c020d)

1.28.1 (2020-04-28)

Bug Fixes

  • anonymous credentials for private bucket (#107) (6152ab4)

  • add bucket name into POST policy conditions (#118) (311ecab)

1.28.0 (2020-04-22)

Features

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

Bug Fixes

1.27.0 (2020-04-01)

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)

1.26.0 (2020-02-12)

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

01-16-2020 11:00 PST

Implementation Changes

  • fix: replace unsafe six.PY3 with PY2 for better future compatibility with Python 4 (#10081)

  • fix(storage): fix document of delete blob (#10015)

New Features

  • feat(storage): support optionsRequestedPolicyVersion (#9989)

Dependencies

  • chore(storage): bump core dependency to 1.2.0 (#10160)

1.24.1

01-02-2020 13:20 PST

Implementation Changes

  • Add ‘ARCHIVE’ storage class (#9533)

1.24.0

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)

1.23.0

11-12-2019 12:57 PST

Implementation Changes

  • Movecreate_bucket implementation fromBucket toClient. (#8604)

New Features

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

Dependencies

  • Pingoogle-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)

1.22.0

11-05-2019 10:22 PST

New Features

  • Add UBLA attrs to IAMConfiguration. (#9475)

1.21.0

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 inBucket.create (#9334)

Documentation

  • Addhmac_key and notification documentation rst files (#9529)

  • Remove references to the old authentication credentials (#9456)

  • Clarify docstring forBlob.download_as_string (#9332)

1.20.0

09-26-2019 06:45 PDT

New Features

  • Adduser_project param to HMAC-related methods. (#9237)

  • AddBlob.from_string andBucket.from_string factories. (#9143)

Documentation

  • Fix intersphinx reference torequests. (#9294)

  • Fix deep / broken URL for service account setup. (#9164)

Internal / Testing Changes

  • Fix typo in_helpers.py. (#9239)

  • In systests, retry bucket creation on 503. (#9248)

  • Avoid usingREGIONAL /MULTI_REGIONAL in examples, tests. (#9205)

  • Movebenchwrapper intotests/perf. (#9246)

  • Add support forSTORAGE_EMULATOR_HOST; addbenchwrapper script. (#9219)

1.19.0

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

  • Addclient_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)

1.18.0

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)

1.17.0

07-24-2019 12:37 PDT

New Features

  • AddBucket.location_type property. (#8570)

  • AddClient.list_blobs(bucket_or_name). (#8375)

Implementation Changes

  • Retry bucket creation in signing setup. (#8620)

  • Fix URI -> blob name conversion inClient 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 inClient.download_blob_to_file docstring. (#8629)

  • Remove typing information for kwargs to not conflict with type checkers (#8546)

Internal / Testing Changes

  • Skip failingtest_bpo_set_unset_preserves_acls systest. (#8617)

  • Add nox session ‘docs’. (#8478)

  • Add docs job to publish to googleapis.dev. (#8464)

1.16.1

06-04-2019 11:09 PDT

Dependencies

  • Don’t pingoogle-api-core in libs usinggoogle-cloud-core. (#8213)

Documentation

  • Fix example indownload_blob_to_file docstring. (#8201)

  • Tweakfields docstring further. (#8040)

  • Improve docs forfields argument toBucket.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)

1.16.0

05-16-2019 12:55 PDT

New Features

  • UpdateClient.create_bucket to take a Bucket object or string. (#7820)

  • UpdateClient.get_bucket to take aBucket object or string. (#7856)

  • AddClient.download_blob_to_file method. (#7949)

  • Addclient_info support to client / connection. (#7872)

Dependencies

  • Pingoogle-cloud-core >= 1.0.0, < 2.0dev. (#7993)

  • Pingoogle-auth >= 1.2.0. (#7798)

1.15.0

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)

1.14.0

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)

1.13.2

12-17-2018 17:02 PST

Implementation Changes

  • UpdateBlob.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 forpage_size /max_results /page_token. (#6842)

1.13.1

12-10-2018 13:31 PST

Implementation Changes

  • Importiam.policy fromgoogle.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 minimumapi_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)

  • Hardencreate_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)

1.13.0

New Features

  • Add support for bucket retention policies (#5534)

  • Allowdestination.content_type to be None inBlob.compose. (#6031)

Implementation Changes

  • Ensure thatmethod forBlob.generate_signed_url is uppercase. (#6110)

Documentation

  • Clarify GCS URL signing limitations on GCE (#6104)

  • Redirect renamed ‘usage.html’/’client.html’ -> ‘index.html’. (#5996)

1.12.0

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)

1.11.0

Implementation Changes

  • Preserve message / args from anInvalidResponse. (#5492)

  • Fix generating signed urls for blobs with non-ascii names. (#5625)

  • Move bucket location specification toBucket.create; deprecateBucket.location setter (#5808)

New Features

  • AddClient.get_service_account_email. (#5765)

Documentation

  • ClarifyNone values for resource-backed properties. (#5509)

  • Elaborate docs for{Bucket,Blob}.make_{public,private}; note how to enable anonymous accesss toBlob.public_url. (#5767)

Internal / Testing Changes

  • Hardencreate_bucket systest against 429 responses. (#5535)

  • Add system test: signed URLs w/ non-ASCII blob name. (#5626)

  • HardentearDownModule against 429 TooManyRequests. (#5701)

  • Retrynotification.create() on503 ServiceUnavailable. (#5741)

  • Fix failing KMS system tests. (#5832, #5837, #5860)

1.10.0

New Features

  • Add support for KMS keys (#5259)

  • Add{Blob,Bucket}make_private method (#5336)

Internal / Testing Changes

  • Modify system tests to use prerelease versions of grpcio (#5304)

1.9.0

Implementation Changes

  • Change GCS batch endpoint from/batch to/batch/storage/v1 (#5040)

New Features

  • Allow uploading files larger than 2GB by using Resumable Media Requests (#5187)

  • Add range downloads (#5081)

Documentation

  • Update docstring to reflect correct units (#5277)

  • Replace link to 404 object IAM docs with a note on limited utility. (#5181)

  • Update doc reference in GCS client documentation (#5084)

  • Add see also forBucket.create method call forClient.create_bucket() documentation. (#5073)

  • Link out to requester pays docs. (#5065)

Internal / Testing Changes

  • Add testing support for Python 3.7; remove testing support for Python 3.4. (#5295)

  • Fix bad trove classifier

  • Remove unused var (flake8 warning) (#5280)

  • Fix unit test moving batch to batch/storage/v1 (#5082)

1.8.0

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)

1.7.0

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 forsource_generation parameter toBucket.copy_blob (#4546)

1.6.0

Documentation

  • Added link to “Python Development Environment Setup Guide” inproject README (#4187, h/t to @michaelawyu)

Dependencies

  • Upgrading togoogle-cloud-core >= 0.28.0 and adding dependencyongoogle-api-core (#4221, #4280)

  • Requiringgoogle-resumable-media >= 0.3.1 (#4244)

PyPI:https://pypi.org/project/google-cloud-storage/1.6.0/

Except as otherwise noted, the content of this page is licensed under theCreative Commons Attribution 4.0 License, and code samples are licensed under theApache 2.0 License. For details, see theGoogle Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.

Last updated 2025-11-05 UTC.