google-cloud-storage 3.3.0__tar.gz → 3.4.0__tar.gz

{google_cloud_storage-3.3.0/google_cloud_storage.egg-info → google_cloud_storage-3.4.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: google-cloud-storage
-Version: 3.3.0
+Version: 3.4.0
 Summary: Google Cloud Storage API client library
 Home-page: https://github.com/googleapis/python-storage
 Author: Google LLC

{google_cloud_storage-3.3.0/google/cloud/storage_v2 → google_cloud_storage-3.4.0/google/cloud/_storage_v2}/__init__.py

@@ -13,7 +13,7 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 #
-from google.cloud.storage_v2 import gapic_version as package_version
+from google.cloud._storage_v2 import gapic_version as package_version
 
 __version__ = package_version.__version__
 

{google_cloud_storage-3.3.0/google/cloud/storage_v2 → google_cloud_storage-3.4.0/google/cloud/_storage_v2}/services/storage/async_client.py

@@ -32,7 +32,7 @@ from typing import (
     Union,
 )
 
-from google.cloud.storage_v2 import gapic_version as package_version
+from google.cloud._storage_v2 import gapic_version as package_version
 
 from google.api_core.client_options import ClientOptions
 from google.api_core import exceptions as core_exceptions
@@ -48,8 +48,8 @@ try:
 except AttributeError:  # pragma: NO COVER
     OptionalRetry = Union[retries.AsyncRetry, object, None]  # type: ignore
 
-from google.cloud.storage_v2.services.storage import pagers
-from google.cloud.storage_v2.types import storage
+from google.cloud._storage_v2.services.storage import pagers
+from google.cloud._storage_v2.types import storage
 from google.iam.v1 import iam_policy_pb2  # type: ignore
 from google.iam.v1 import policy_pb2  # type: ignore
 from google.longrunning import operations_pb2  # type: ignore
@@ -80,22 +80,22 @@ class StorageAsyncClient:
 
     Resources are named as follows:
 
-    -  Projects are referred to as they are defined by the Resource
-       Manager API, using strings like ``projects/123456`` or
-       ``projects/my-string-id``.
+    - Projects are referred to as they are defined by the Resource
+      Manager API, using strings like ``projects/123456`` or
+      ``projects/my-string-id``.
 
-    -  Buckets are named using string names of the form:
-       ``projects/{project}/buckets/{bucket}`` For globally unique
-       buckets, ``_`` may be substituted for the project.
+    - Buckets are named using string names of the form:
+      ``projects/{project}/buckets/{bucket}`` For globally unique
+      buckets, ``_`` may be substituted for the project.
 
-    -  Objects are uniquely identified by their name along with the name
-       of the bucket they belong to, as separate strings in this API.
-       For example:
+    - Objects are uniquely identified by their name along with the name
+      of the bucket they belong to, as separate strings in this API. For
+      example:
 
-       ReadObjectRequest { bucket: 'projects/_/buckets/my-bucket'
-       object: 'my-object' } Note that object names can contain ``/``
-       characters, which are treated as any other character (no special
-       directory semantics).
+      ReadObjectRequest { bucket: 'projects/\_/buckets/my-bucket'
+      object: 'my-object' } Note that object names can contain ``/``
+      characters, which are treated as any other character (no special
+      directory semantics).
     """
 
     _client: StorageClient
@@ -350,7 +350,7 @@ class StorageAsyncClient:
                 await client.delete_bucket(request=request)
 
         Args:
-            request (Optional[Union[google.cloud.storage_v2.types.DeleteBucketRequest, dict]]):
+            request (Optional[Union[google.cloud._storage_v2.types.DeleteBucketRequest, dict]]):
                 The request object. Request message for DeleteBucket.
             name (:class:`str`):
                 Required. Name of a bucket to delete.
@@ -455,7 +455,7 @@ class StorageAsyncClient:
                 print(response)
 
         Args:
-            request (Optional[Union[google.cloud.storage_v2.types.GetBucketRequest, dict]]):
+            request (Optional[Union[google.cloud._storage_v2.types.GetBucketRequest, dict]]):
                 The request object. Request message for GetBucket.
             name (:class:`str`):
                 Required. Name of a bucket.
@@ -471,7 +471,7 @@ class StorageAsyncClient:
                 be of type `bytes`.
 
         Returns:
-            google.cloud.storage_v2.types.Bucket:
+            google.cloud._storage_v2.types.Bucket:
                 A bucket.
         """
         # Create or coerce a protobuf request object.
@@ -570,7 +570,7 @@ class StorageAsyncClient:
                 print(response)
 
         Args:
-            request (Optional[Union[google.cloud.storage_v2.types.CreateBucketRequest, dict]]):
+            request (Optional[Union[google.cloud._storage_v2.types.CreateBucketRequest, dict]]):
                 The request object. Request message for CreateBucket.
             parent (:class:`str`):
                 Required. The project to which this bucket will belong.
@@ -581,7 +581,7 @@ class StorageAsyncClient:
                 This corresponds to the ``parent`` field
                 on the ``request`` instance; if ``request`` is provided, this
                 should not be set.
-            bucket (:class:`google.cloud.storage_v2.types.Bucket`):
+            bucket (:class:`google.cloud._storage_v2.types.Bucket`):
                 Optional. Properties of the new bucket being inserted.
                 The name of the bucket is specified in the ``bucket_id``
                 field. Populating ``bucket.name`` field will result in
@@ -613,7 +613,7 @@ class StorageAsyncClient:
                 be of type `bytes`.
 
         Returns:
-            google.cloud.storage_v2.types.Bucket:
+            google.cloud._storage_v2.types.Bucket:
                 A bucket.
         """
         # Create or coerce a protobuf request object.
@@ -719,7 +719,7 @@ class StorageAsyncClient:
                     print(response)
 
         Args:
-            request (Optional[Union[google.cloud.storage_v2.types.ListBucketsRequest, dict]]):
+            request (Optional[Union[google.cloud._storage_v2.types.ListBucketsRequest, dict]]):
                 The request object. Request message for ListBuckets.
             parent (:class:`str`):
                 Required. The project whose buckets
@@ -737,7 +737,7 @@ class StorageAsyncClient:
                 be of type `bytes`.
 
         Returns:
-            google.cloud.storage_v2.services.storage.pagers.ListBucketsAsyncPager:
+            google.cloud._storage_v2.services.storage.pagers.ListBucketsAsyncPager:
                 The result of a call to
                 Buckets.ListBuckets
                 Iterating over this object will yield
@@ -850,7 +850,7 @@ class StorageAsyncClient:
                 print(response)
 
         Args:
-            request (Optional[Union[google.cloud.storage_v2.types.LockBucketRetentionPolicyRequest, dict]]):
+            request (Optional[Union[google.cloud._storage_v2.types.LockBucketRetentionPolicyRequest, dict]]):
                 The request object. Request message for
                 LockBucketRetentionPolicyRequest.
             bucket (:class:`str`):
@@ -867,7 +867,7 @@ class StorageAsyncClient:
                 be of type `bytes`.
 
         Returns:
-            google.cloud.storage_v2.types.Bucket:
+            google.cloud._storage_v2.types.Bucket:
                 A bucket.
         """
         # Create or coerce a protobuf request object.
@@ -1006,19 +1006,19 @@ class StorageAsyncClient:
                    constraints based on attributes of the request, the
                    resource, or both. To learn which resources support
                    conditions in their IAM policies, see the [IAM
-                   documentation](\ https://cloud.google.com/iam/help/conditions/resource-policies).
+                   documentation](https://cloud.google.com/iam/help/conditions/resource-policies).
 
                    **JSON example:**
 
-                   :literal:`\`     {       "bindings": [         {           "role": "roles/resourcemanager.organizationAdmin",           "members": [             "user:mike@example.com",             "group:admins@example.com",             "domain:google.com",             "serviceAccount:my-project-id@appspot.gserviceaccount.com"           ]         },         {           "role": "roles/resourcemanager.organizationViewer",           "members": [             "user:eve@example.com"           ],           "condition": {             "title": "expirable access",             "description": "Does not grant access after Sep 2020",             "expression": "request.time <             timestamp('2020-10-01T00:00:00.000Z')",           }         }       ],       "etag": "BwWWja0YfJA=",       "version": 3     }`\ \`
+                   :literal:``     {       "bindings": [         {           "role": "roles/resourcemanager.organizationAdmin",           "members": [             "user:mike@example.com",             "group:admins@example.com",             "domain:google.com",             "serviceAccount:my-project-id@appspot.gserviceaccount.com"           ]         },         {           "role": "roles/resourcemanager.organizationViewer",           "members": [             "user:eve@example.com"           ],           "condition": {             "title": "expirable access",             "description": "Does not grant access after Sep 2020",             "expression": "request.time <             timestamp('2020-10-01T00:00:00.000Z')",           }         }       ],       "etag": "BwWWja0YfJA=",       "version": 3     }`\ \`
 
                    **YAML example:**
 
-                   :literal:`\`     bindings:     - members:       - user:mike@example.com       - group:admins@example.com       - domain:google.com       - serviceAccount:my-project-id@appspot.gserviceaccount.com       role: roles/resourcemanager.organizationAdmin     - members:       - user:eve@example.com       role: roles/resourcemanager.organizationViewer       condition:         title: expirable access         description: Does not grant access after Sep 2020         expression: request.time < timestamp('2020-10-01T00:00:00.000Z')     etag: BwWWja0YfJA=     version: 3`\ \`
+                   :literal:``     bindings:     - members:       - user:mike@example.com       - group:admins@example.com       - domain:google.com       - serviceAccount:my-project-id@appspot.gserviceaccount.com       role: roles/resourcemanager.organizationAdmin     - members:       - user:eve@example.com       role: roles/resourcemanager.organizationViewer       condition:         title: expirable access         description: Does not grant access after Sep 2020         expression: request.time < timestamp('2020-10-01T00:00:00.000Z')     etag: BwWWja0YfJA=     version: 3`\ \`
 
                    For a description of IAM and its features, see the
                    [IAM
-                   documentation](\ https://cloud.google.com/iam/docs/).
+                   documentation](https://cloud.google.com/iam/docs/).
 
         """
         # Create or coerce a protobuf request object.
@@ -1161,19 +1161,19 @@ class StorageAsyncClient:
                    constraints based on attributes of the request, the
                    resource, or both. To learn which resources support
                    conditions in their IAM policies, see the [IAM
-                   documentation](\ https://cloud.google.com/iam/help/conditions/resource-policies).
+                   documentation](https://cloud.google.com/iam/help/conditions/resource-policies).
 
                    **JSON example:**
 
-                   :literal:`\`     {       "bindings": [         {           "role": "roles/resourcemanager.organizationAdmin",           "members": [             "user:mike@example.com",             "group:admins@example.com",             "domain:google.com",             "serviceAccount:my-project-id@appspot.gserviceaccount.com"           ]         },         {           "role": "roles/resourcemanager.organizationViewer",           "members": [             "user:eve@example.com"           ],           "condition": {             "title": "expirable access",             "description": "Does not grant access after Sep 2020",             "expression": "request.time <             timestamp('2020-10-01T00:00:00.000Z')",           }         }       ],       "etag": "BwWWja0YfJA=",       "version": 3     }`\ \`
+                   :literal:``     {       "bindings": [         {           "role": "roles/resourcemanager.organizationAdmin",           "members": [             "user:mike@example.com",             "group:admins@example.com",             "domain:google.com",             "serviceAccount:my-project-id@appspot.gserviceaccount.com"           ]         },         {           "role": "roles/resourcemanager.organizationViewer",           "members": [             "user:eve@example.com"           ],           "condition": {             "title": "expirable access",             "description": "Does not grant access after Sep 2020",             "expression": "request.time <             timestamp('2020-10-01T00:00:00.000Z')",           }         }       ],       "etag": "BwWWja0YfJA=",       "version": 3     }`\ \`
 
                    **YAML example:**
 
-                   :literal:`\`     bindings:     - members:       - user:mike@example.com       - group:admins@example.com       - domain:google.com       - serviceAccount:my-project-id@appspot.gserviceaccount.com       role: roles/resourcemanager.organizationAdmin     - members:       - user:eve@example.com       role: roles/resourcemanager.organizationViewer       condition:         title: expirable access         description: Does not grant access after Sep 2020         expression: request.time < timestamp('2020-10-01T00:00:00.000Z')     etag: BwWWja0YfJA=     version: 3`\ \`
+                   :literal:``     bindings:     - members:       - user:mike@example.com       - group:admins@example.com       - domain:google.com       - serviceAccount:my-project-id@appspot.gserviceaccount.com       role: roles/resourcemanager.organizationAdmin     - members:       - user:eve@example.com       role: roles/resourcemanager.organizationViewer       condition:         title: expirable access         description: Does not grant access after Sep 2020         expression: request.time < timestamp('2020-10-01T00:00:00.000Z')     etag: BwWWja0YfJA=     version: 3`\ \`
 
                    For a description of IAM and its features, see the
                    [IAM
-                   documentation](\ https://cloud.google.com/iam/docs/).
+                   documentation](https://cloud.google.com/iam/docs/).
 
         """
         # Create or coerce a protobuf request object.
@@ -1422,9 +1422,9 @@ class StorageAsyncClient:
                 print(response)
 
         Args:
-            request (Optional[Union[google.cloud.storage_v2.types.UpdateBucketRequest, dict]]):
+            request (Optional[Union[google.cloud._storage_v2.types.UpdateBucketRequest, dict]]):
                 The request object. Request for UpdateBucket method.
-            bucket (:class:`google.cloud.storage_v2.types.Bucket`):
+            bucket (:class:`google.cloud._storage_v2.types.Bucket`):
                 Required. The bucket to update. The bucket's ``name``
                 field will be used to identify the bucket.
 
@@ -1455,7 +1455,7 @@ class StorageAsyncClient:
                 be of type `bytes`.
 
         Returns:
-            google.cloud.storage_v2.types.Bucket:
+            google.cloud._storage_v2.types.Bucket:
                 A bucket.
         """
         # Create or coerce a protobuf request object.
@@ -1552,7 +1552,7 @@ class StorageAsyncClient:
                 print(response)
 
         Args:
-            request (Optional[Union[google.cloud.storage_v2.types.ComposeObjectRequest, dict]]):
+            request (Optional[Union[google.cloud._storage_v2.types.ComposeObjectRequest, dict]]):
                 The request object. Request message for ComposeObject.
             retry (google.api_core.retry_async.AsyncRetry): Designation of what errors, if any,
                 should be retried.
@@ -1563,7 +1563,7 @@ class StorageAsyncClient:
                 be of type `bytes`.
 
         Returns:
-            google.cloud.storage_v2.types.Object:
+            google.cloud._storage_v2.types.Object:
                 An object.
         """
         # Create or coerce a protobuf request object.
@@ -1663,7 +1663,7 @@ class StorageAsyncClient:
                 await client.delete_object(request=request)
 
         Args:
-            request (Optional[Union[google.cloud.storage_v2.types.DeleteObjectRequest, dict]]):
+            request (Optional[Union[google.cloud._storage_v2.types.DeleteObjectRequest, dict]]):
                 The request object. Message for deleting an object. ``bucket`` and
                 ``object`` **must** be set.
             bucket (:class:`str`):
@@ -1796,7 +1796,7 @@ class StorageAsyncClient:
                 print(response)
 
         Args:
-            request (Optional[Union[google.cloud.storage_v2.types.RestoreObjectRequest, dict]]):
+            request (Optional[Union[google.cloud._storage_v2.types.RestoreObjectRequest, dict]]):
                 The request object. Message for restoring an object. ``bucket``, ``object``,
                 and ``generation`` **must** be set.
             bucket (:class:`str`):
@@ -1829,7 +1829,7 @@ class StorageAsyncClient:
                 be of type `bytes`.
 
         Returns:
-            google.cloud.storage_v2.types.Object:
+            google.cloud._storage_v2.types.Object:
                 An object.
         """
         # Create or coerce a protobuf request object.
@@ -1937,7 +1937,7 @@ class StorageAsyncClient:
                 print(response)
 
         Args:
-            request (Optional[Union[google.cloud.storage_v2.types.CancelResumableWriteRequest, dict]]):
+            request (Optional[Union[google.cloud._storage_v2.types.CancelResumableWriteRequest, dict]]):
                 The request object. Message for canceling an in-progress resumable upload.
                 ``upload_id`` **must** be set.
             upload_id (:class:`str`):
@@ -1957,7 +1957,7 @@ class StorageAsyncClient:
                 be of type `bytes`.
 
         Returns:
-            google.cloud.storage_v2.types.CancelResumableWriteResponse:
+            google.cloud._storage_v2.types.CancelResumableWriteResponse:
                 Empty response message for canceling
                 an in-progress resumable upload, will be
                 extended as needed.
@@ -2068,7 +2068,7 @@ class StorageAsyncClient:
                 print(response)
 
         Args:
-            request (Optional[Union[google.cloud.storage_v2.types.GetObjectRequest, dict]]):
+            request (Optional[Union[google.cloud._storage_v2.types.GetObjectRequest, dict]]):
                 The request object. Request message for GetObject.
             bucket (:class:`str`):
                 Required. Name of the bucket in which
@@ -2100,7 +2100,7 @@ class StorageAsyncClient:
                 be of type `bytes`.
 
         Returns:
-            google.cloud.storage_v2.types.Object:
+            google.cloud._storage_v2.types.Object:
                 An object.
         """
         # Create or coerce a protobuf request object.
@@ -2210,7 +2210,7 @@ class StorageAsyncClient:
                     print(response)
 
         Args:
-            request (Optional[Union[google.cloud.storage_v2.types.ReadObjectRequest, dict]]):
+            request (Optional[Union[google.cloud._storage_v2.types.ReadObjectRequest, dict]]):
                 The request object. Request message for ReadObject.
             bucket (:class:`str`):
                 Required. The name of the bucket
@@ -2244,7 +2244,7 @@ class StorageAsyncClient:
                 be of type `bytes`.
 
         Returns:
-            AsyncIterable[google.cloud.storage_v2.types.ReadObjectResponse]:
+            AsyncIterable[google.cloud._storage_v2.types.ReadObjectResponse]:
                 Response message for ReadObject.
         """
         # Create or coerce a protobuf request object.
@@ -2373,7 +2373,7 @@ class StorageAsyncClient:
                     print(response)
 
         Args:
-            requests (AsyncIterator[`google.cloud.storage_v2.types.BidiReadObjectRequest`]):
+            requests (AsyncIterator[`google.cloud._storage_v2.types.BidiReadObjectRequest`]):
                 The request object AsyncIterator. Request message for BidiReadObject.
             retry (google.api_core.retry_async.AsyncRetry): Designation of what errors, if any,
                 should be retried.
@@ -2384,7 +2384,7 @@ class StorageAsyncClient:
                 be of type `bytes`.
 
         Returns:
-            AsyncIterable[google.cloud.storage_v2.types.BidiReadObjectResponse]:
+            AsyncIterable[google.cloud._storage_v2.types.BidiReadObjectResponse]:
                 Response message for BidiReadObject.
         """
 
@@ -2454,9 +2454,9 @@ class StorageAsyncClient:
                 print(response)
 
         Args:
-            request (Optional[Union[google.cloud.storage_v2.types.UpdateObjectRequest, dict]]):
+            request (Optional[Union[google.cloud._storage_v2.types.UpdateObjectRequest, dict]]):
                 The request object. Request message for UpdateObject.
-            object_ (:class:`google.cloud.storage_v2.types.Object`):
+            object_ (:class:`google.cloud._storage_v2.types.Object`):
                 Required. The object to update.
                 The object's bucket and name fields are
                 used to identify the object to update.
@@ -2493,7 +2493,7 @@ class StorageAsyncClient:
                 be of type `bytes`.
 
         Returns:
-            google.cloud.storage_v2.types.Object:
+            google.cloud._storage_v2.types.Object:
                 An object.
         """
         # Create or coerce a protobuf request object.
@@ -2578,41 +2578,41 @@ class StorageAsyncClient:
         explicitly by the client or due to a network error or an error
         response from the server), the client should do as follows:
 
-        -  Check the result Status of the stream, to determine if
-           writing can be resumed on this stream or must be restarted
-           from scratch (by calling ``StartResumableWrite()``). The
-           resumable errors are DEADLINE_EXCEEDED, INTERNAL, and
-           UNAVAILABLE. For each case, the client should use binary
-           exponential backoff before retrying. Additionally, writes can
-           be resumed after RESOURCE_EXHAUSTED errors, but only after
-           taking appropriate measures, which may include reducing
-           aggregate send rate across clients and/or requesting a quota
-           increase for your project.
-        -  If the call to ``WriteObject`` returns ``ABORTED``, that
-           indicates concurrent attempts to update the resumable write,
-           caused either by multiple racing clients or by a single
-           client where the previous request was timed out on the client
-           side but nonetheless reached the server. In this case the
-           client should take steps to prevent further concurrent writes
-           (e.g., increase the timeouts, stop using more than one
-           process to perform the upload, etc.), and then should follow
-           the steps below for resuming the upload.
-        -  For resumable errors, the client should call
-           ``QueryWriteStatus()`` and then continue writing from the
-           returned ``persisted_size``. This may be less than the amount
-           of data the client previously sent. Note also that it is
-           acceptable to send data starting at an offset earlier than
-           the returned ``persisted_size``; in this case, the service
-           will skip data at offsets that were already persisted
-           (without checking that it matches the previously written
-           data), and write only the data starting from the persisted
-           offset. Even though the data isn't written, it may still
-           incur a performance cost over resuming at the correct write
-           offset. This behavior can make client-side handling simpler
-           in some cases.
-        -  Clients must only send data that is a multiple of 256 KiB per
-           message, unless the object is being finished with
-           ``finish_write`` set to ``true``.
+        - Check the result Status of the stream, to determine if writing
+          can be resumed on this stream or must be restarted from
+          scratch (by calling ``StartResumableWrite()``). The resumable
+          errors are DEADLINE_EXCEEDED, INTERNAL, and UNAVAILABLE. For
+          each case, the client should use binary exponential backoff
+          before retrying. Additionally, writes can be resumed after
+          RESOURCE_EXHAUSTED errors, but only after taking appropriate
+          measures, which may include reducing aggregate send rate
+          across clients and/or requesting a quota increase for your
+          project.
+        - If the call to ``WriteObject`` returns ``ABORTED``, that
+          indicates concurrent attempts to update the resumable write,
+          caused either by multiple racing clients or by a single client
+          where the previous request was timed out on the client side
+          but nonetheless reached the server. In this case the client
+          should take steps to prevent further concurrent writes (e.g.,
+          increase the timeouts, stop using more than one process to
+          perform the upload, etc.), and then should follow the steps
+          below for resuming the upload.
+        - For resumable errors, the client should call
+          ``QueryWriteStatus()`` and then continue writing from the
+          returned ``persisted_size``. This may be less than the amount
+          of data the client previously sent. Note also that it is
+          acceptable to send data starting at an offset earlier than the
+          returned ``persisted_size``; in this case, the service will
+          skip data at offsets that were already persisted (without
+          checking that it matches the previously written data), and
+          write only the data starting from the persisted offset. Even
+          though the data isn't written, it may still incur a
+          performance cost over resuming at the correct write offset.
+          This behavior can make client-side handling simpler in some
+          cases.
+        - Clients must only send data that is a multiple of 256 KiB per
+          message, unless the object is being finished with
+          ``finish_write`` set to ``true``.
 
         The service will not view the object as complete until the
         client has sent a ``WriteObjectRequest`` with ``finish_write``
@@ -2674,7 +2674,7 @@ class StorageAsyncClient:
                 print(response)
 
         Args:
-            requests (AsyncIterator[`google.cloud.storage_v2.types.WriteObjectRequest`]):
+            requests (AsyncIterator[`google.cloud._storage_v2.types.WriteObjectRequest`]):
                 The request object AsyncIterator. Request message for WriteObject.
             retry (google.api_core.retry_async.AsyncRetry): Designation of what errors, if any,
                 should be retried.
@@ -2685,7 +2685,7 @@ class StorageAsyncClient:
                 be of type `bytes`.
 
         Returns:
-            google.cloud.storage_v2.types.WriteObjectResponse:
+            google.cloud._storage_v2.types.WriteObjectResponse:
                 Response message for WriteObject.
         """
 
@@ -2774,7 +2774,7 @@ class StorageAsyncClient:
                     print(response)
 
         Args:
-            requests (AsyncIterator[`google.cloud.storage_v2.types.BidiWriteObjectRequest`]):
+            requests (AsyncIterator[`google.cloud._storage_v2.types.BidiWriteObjectRequest`]):
                 The request object AsyncIterator. Request message for BidiWriteObject.
             retry (google.api_core.retry_async.AsyncRetry): Designation of what errors, if any,
                 should be retried.
@@ -2785,7 +2785,7 @@ class StorageAsyncClient:
                 be of type `bytes`.
 
         Returns:
-            AsyncIterable[google.cloud.storage_v2.types.BidiWriteObjectResponse]:
+            AsyncIterable[google.cloud._storage_v2.types.BidiWriteObjectResponse]:
                 Response message for BidiWriteObject.
         """
 
@@ -2856,7 +2856,7 @@ class StorageAsyncClient:
                     print(response)
 
         Args:
-            request (Optional[Union[google.cloud.storage_v2.types.ListObjectsRequest, dict]]):
+            request (Optional[Union[google.cloud._storage_v2.types.ListObjectsRequest, dict]]):
                 The request object. Request message for ListObjects.
             parent (:class:`str`):
                 Required. Name of the bucket in which
@@ -2874,7 +2874,7 @@ class StorageAsyncClient:
                 be of type `bytes`.
 
         Returns:
-            google.cloud.storage_v2.services.storage.pagers.ListObjectsAsyncPager:
+            google.cloud._storage_v2.services.storage.pagers.ListObjectsAsyncPager:
                 The result of a call to
                 Objects.ListObjects
                 Iterating over this object will yield
@@ -2989,7 +2989,7 @@ class StorageAsyncClient:
                 print(response)
 
         Args:
-            request (Optional[Union[google.cloud.storage_v2.types.RewriteObjectRequest, dict]]):
+            request (Optional[Union[google.cloud._storage_v2.types.RewriteObjectRequest, dict]]):
                 The request object. Request message for RewriteObject. If the source object
                 is encrypted using a Customer-Supplied Encryption Key
                 the key information must be provided in the
@@ -3010,7 +3010,7 @@ class StorageAsyncClient:
                 be of type `bytes`.
 
         Returns:
-            google.cloud.storage_v2.types.RewriteResponse:
+            google.cloud._storage_v2.types.RewriteResponse:
                 A rewrite response.
         """
         # Create or coerce a protobuf request object.
@@ -3102,7 +3102,7 @@ class StorageAsyncClient:
                 print(response)
 
         Args:
-            request (Optional[Union[google.cloud.storage_v2.types.StartResumableWriteRequest, dict]]):
+            request (Optional[Union[google.cloud._storage_v2.types.StartResumableWriteRequest, dict]]):
                 The request object. Request message StartResumableWrite.
             retry (google.api_core.retry_async.AsyncRetry): Designation of what errors, if any,
                 should be retried.
@@ -3113,7 +3113,7 @@ class StorageAsyncClient:
                 be of type `bytes`.
 
         Returns:
-            google.cloud.storage_v2.types.StartResumableWriteResponse:
+            google.cloud._storage_v2.types.StartResumableWriteResponse:
                 Response object for StartResumableWrite.
         """
         # Create or coerce a protobuf request object.
@@ -3211,7 +3211,7 @@ class StorageAsyncClient:
                 print(response)
 
         Args:
-            request (Optional[Union[google.cloud.storage_v2.types.QueryWriteStatusRequest, dict]]):
+            request (Optional[Union[google.cloud._storage_v2.types.QueryWriteStatusRequest, dict]]):
                 The request object. Request object for ``QueryWriteStatus``.
             upload_id (:class:`str`):
                 Required. The name of the resume
@@ -3230,7 +3230,7 @@ class StorageAsyncClient:
                 be of type `bytes`.
 
         Returns:
-            google.cloud.storage_v2.types.QueryWriteStatusResponse:
+            google.cloud._storage_v2.types.QueryWriteStatusResponse:
                 Response object for QueryWriteStatus.
         """
         # Create or coerce a protobuf request object.
@@ -3333,7 +3333,7 @@ class StorageAsyncClient:
                 print(response)
 
         Args:
-            request (Optional[Union[google.cloud.storage_v2.types.MoveObjectRequest, dict]]):
+            request (Optional[Union[google.cloud._storage_v2.types.MoveObjectRequest, dict]]):
                 The request object. Request message for MoveObject.
             bucket (:class:`str`):
                 Required. Name of the bucket in which
@@ -3363,7 +3363,7 @@ class StorageAsyncClient:
                 be of type `bytes`.
 
         Returns:
-            google.cloud.storage_v2.types.Object:
+            google.cloud._storage_v2.types.Object:
                 An object.
         """
         # Create or coerce a protobuf request object.