docs: minor clarifications (#352)

* docs: mention that some fields are deprecated

PiperOrigin-RevId: 519755058

Source-Link: googleapis/googleapis@26b4d27

Source-Link: googleapis/googleapis-gen@7ad7fcf
Copy-Tag: eyJwIjoiLmdpdGh1Yi8uT3dsQm90LnlhbWwiLCJoIjoiN2FkN2ZjZjllNWQyYThiMjQzOTM1ZWMyMDk1NGZiMjkwMTg1ODkxNSJ9

* 🦉 Updates from OwlBot post-processor

See https://github.com/googleapis/repo-automation-bots/blob/main/packages/owl-bot/README.md

---------

Co-authored-by: Owl Bot <gcf-owl-bot[bot]@users.noreply.github.com>

Author: gcf-owl-bot[bot]

packages/google-cloud-bigquery-reservation/google/cloud/bigquery_reservation_v1/services/reservation_service/async_client.py

@@ -57,8 +57,7 @@
 
 
 class ReservationServiceAsyncClient:
-    """This API allows users to manage their flat-rate BigQuery
-    reservations.
+    """This API allows users to manage their BigQuery reservations.
 
     A reservation provides computational resource guarantees, in the
     form of `slots <https://cloud.google.com/bigquery/docs/slots>`__, to

packages/google-cloud-bigquery-reservation/google/cloud/bigquery_reservation_v1/services/reservation_service/client.py

@@ -99,8 +99,7 @@ def get_transport_class(
 
 
 class ReservationServiceClient(metaclass=ReservationServiceClientMeta):
-    """This API allows users to manage their flat-rate BigQuery
-    reservations.
+    """This API allows users to manage their BigQuery reservations.
 
     A reservation provides computational resource guarantees, in the
     form of `slots <https://cloud.google.com/bigquery/docs/slots>`__, to

packages/google-cloud-bigquery-reservation/google/cloud/bigquery_reservation_v1/services/reservation_service/transports/grpc.py

@@ -32,8 +32,7 @@
 class ReservationServiceGrpcTransport(ReservationServiceTransport):
     """gRPC backend transport for ReservationService.
 
-    This API allows users to manage their flat-rate BigQuery
-    reservations.
+    This API allows users to manage their BigQuery reservations.
 
     A reservation provides computational resource guarantees, in the
     form of `slots <https://cloud.google.com/bigquery/docs/slots>`__, to

packages/google-cloud-bigquery-reservation/google/cloud/bigquery_reservation_v1/services/reservation_service/transports/grpc_asyncio.py

@@ -33,8 +33,7 @@
 class ReservationServiceGrpcAsyncIOTransport(ReservationServiceTransport):
     """gRPC AsyncIO backend transport for ReservationService.
 
-    This API allows users to manage their flat-rate BigQuery
-    reservations.
+    This API allows users to manage their BigQuery reservations.
 
     A reservation provides computational resource guarantees, in the
     form of `slots <https://cloud.google.com/bigquery/docs/slots>`__, to

packages/google-cloud-bigquery-reservation/google/cloud/bigquery_reservation_v1/services/reservation_service/transports/rest.py

@@ -689,8 +689,7 @@ class ReservationServiceRestStub:
 class ReservationServiceRestTransport(ReservationServiceTransport):
     """REST backend transport for ReservationService.
 
-    This API allows users to manage their flat-rate BigQuery
-    reservations.
+    This API allows users to manage their BigQuery reservations.
 
     A reservation provides computational resource guarantees, in the
     form of `slots <https://cloud.google.com/bigquery/docs/slots>`__, to

packages/google-cloud-bigquery-reservation/google/cloud/bigquery_reservation_v1/types/reservation.py

@@ -146,6 +146,8 @@ class Reservation(proto.Message):
             designated for disaster recovery purposes. If
             false, this reservation is placed in the
             organization's default region.
+            NOTE: this is a preview feature. Project must be
+            allow-listed in order to set this field.
         edition (google.cloud.bigquery_reservation_v1.types.Edition):
             Edition of the reservation.
     """
@@ -263,6 +265,8 @@ class CapacityCommitment(proto.Message):
             designated for disaster recovery purposes. If
             false, this commitment is placed in the
             organization's default region.
+            NOTE: this is a preview feature. Project must be
+            allow-listed in order to set this field.
         edition (google.cloud.bigquery_reservation_v1.types.Edition):
             Edition of the capacity commitment.
     """

packages/google-cloud-bigquery-reservation/samples/generated_samples/snippet_metadata_google.cloud.bigquery.reservation.v1.json

@@ -8,7 +8,7 @@
     ],
     "language": "PYTHON",
     "name": "google-cloud-bigquery-reservation",
-    "version": "1.11.0"
+    "version": "0.1.0"
   },
   "snippets": [
     {