docs: add generated snippets (#79)

* chore: use gapic-generator-python 0.63.2 docs: add generated snippets PiperOrigin-RevId: 427792504 Source-Link: googleapis/googleapis@55b9e1e Source-Link: https://github.com/googleapis/googleapis-gen/commit/bf4e86b753f42cb0edb1fd51fbe840d7da0a1cde Copy-Tag: eyJwIjoiLmdpdGh1Yi8uT3dsQm90LnlhbWwiLCJoIjoiYmY0ZTg2Yjc1M2Y0MmNiMGVkYjFmZDUxZmJlODQwZDdkYTBhMWNkZSJ9 * 🦉 Updates from OwlBot 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]

google/cloud/service_usage_v1/services/service_usage/async_client.py

@@ -216,6 +216,29 @@ async def enable_service(
  r"""Enable a service so that it can be used with a
  project.
 
+
+ .. code-block::
+
+ from google.cloud import service_usage_v1
+
+ def sample_enable_service():
+ # Create a client
+ client = service_usage_v1.ServiceUsageClient()
+
+ # Initialize request argument(s)
+ request = service_usage_v1.EnableServiceRequest(
+ )
+
+ # Make the request
+ operation = client.enable_service(request=request)
+
+ print("Waiting for operation to complete...")
+
+ response = operation.result()
+
+ # Handle the response
+ print(response)
+
  Args:
  request (Union[google.cloud.service_usage_v1.types.EnableServiceRequest, dict]):
  The request object. Request message for the
@@ -284,6 +307,29 @@ async def disable_service(
  ``FAILED_PRECONDITION`` status if the target service is not
  currently enabled.
 
+
+ .. code-block::
+
+ from google.cloud import service_usage_v1
+
+ def sample_disable_service():
+ # Create a client
+ client = service_usage_v1.ServiceUsageClient()
+
+ # Initialize request argument(s)
+ request = service_usage_v1.DisableServiceRequest(
+ )
+
+ # Make the request
+ operation = client.disable_service(request=request)
+
+ print("Waiting for operation to complete...")
+
+ response = operation.result()
+
+ # Handle the response
+ print(response)
+
  Args:
  request (Union[google.cloud.service_usage_v1.types.DisableServiceRequest, dict]):
  The request object. Request message for the
@@ -346,6 +392,25 @@ async def get_service(
  r"""Returns the service configuration and enabled state
  for a given service.
 
+
+ .. code-block::
+
+ from google.cloud import service_usage_v1
+
+ def sample_get_service():
+ # Create a client
+ client = service_usage_v1.ServiceUsageClient()
+
+ # Initialize request argument(s)
+ request = service_usage_v1.GetServiceRequest(
+ )
+
+ # Make the request
+ response = client.get_service(request=request)
+
+ # Handle the response
+ print(response)
+
  Args:
  request (Union[google.cloud.service_usage_v1.types.GetServiceRequest, dict]):
  The request object. Request message for the `GetService`
@@ -408,6 +473,26 @@ async def list_services(
  which provides higher throughput and richer filtering
  capability.
 
+
+ .. code-block::
+
+ from google.cloud import service_usage_v1
+
+ def sample_list_services():
+ # Create a client
+ client = service_usage_v1.ServiceUsageClient()
+
+ # Initialize request argument(s)
+ request = service_usage_v1.ListServicesRequest(
+ )
+
+ # Make the request
+ page_result = client.list_services(request=request)
+
+ # Handle the response
+ for response in page_result:
+ print(response)
+
  Args:
  request (Union[google.cloud.service_usage_v1.types.ListServicesRequest, dict]):
  The request object. Request message for the
@@ -468,6 +553,29 @@ async def batch_enable_services(
  no state changes occur. To enable a single service, use the
  ``EnableService`` method instead.
 
+
+ .. code-block::
+
+ from google.cloud import service_usage_v1
+
+ def sample_batch_enable_services():
+ # Create a client
+ client = service_usage_v1.ServiceUsageClient()
+
+ # Initialize request argument(s)
+ request = service_usage_v1.BatchEnableServicesRequest(
+ )
+
+ # Make the request
+ operation = client.batch_enable_services(request=request)
+
+ print("Waiting for operation to complete...")
+
+ response = operation.result()
+
+ # Handle the response
+ print(response)
+
  Args:
  request (Union[google.cloud.service_usage_v1.types.BatchEnableServicesRequest, dict]):
  The request object. Request message for the
@@ -530,6 +638,25 @@ async def batch_get_services(
  r"""Returns the service configurations and enabled states
  for a given list of services.
 
+
+ .. code-block::
+
+ from google.cloud import service_usage_v1
+
+ def sample_batch_get_services():
+ # Create a client
+ client = service_usage_v1.ServiceUsageClient()
+
+ # Initialize request argument(s)
+ request = service_usage_v1.BatchGetServicesRequest(
+ )
+
+ # Make the request
+ response = client.batch_get_services(request=request)
+
+ # Handle the response
+ print(response)
+
  Args:
  request (Union[google.cloud.service_usage_v1.types.BatchGetServicesRequest, dict]):
  The request object. Request message for the

google/cloud/service_usage_v1/services/service_usage/client.py

@@ -401,6 +401,30 @@ def enable_service(
  r"""Enable a service so that it can be used with a
  project.
 
+
+
+ .. code-block::
+
+ from google.cloud import service_usage_v1
+
+ def sample_enable_service():
+ # Create a client
+ client = service_usage_v1.ServiceUsageClient()
+
+ # Initialize request argument(s)
+ request = service_usage_v1.EnableServiceRequest(
+ )
+
+ # Make the request
+ operation = client.enable_service(request=request)
+
+ print("Waiting for operation to complete...")
+
+ response = operation.result()
+
+ # Handle the response
+ print(response)
+
  Args:
  request (Union[google.cloud.service_usage_v1.types.EnableServiceRequest, dict]):
  The request object. Request message for the
@@ -470,6 +494,30 @@ def disable_service(
  ``FAILED_PRECONDITION`` status if the target service is not
  currently enabled.
 
+
+
+ .. code-block::
+
+ from google.cloud import service_usage_v1
+
+ def sample_disable_service():
+ # Create a client
+ client = service_usage_v1.ServiceUsageClient()
+
+ # Initialize request argument(s)
+ request = service_usage_v1.DisableServiceRequest(
+ )
+
+ # Make the request
+ operation = client.disable_service(request=request)
+
+ print("Waiting for operation to complete...")
+
+ response = operation.result()
+
+ # Handle the response
+ print(response)
+
  Args:
  request (Union[google.cloud.service_usage_v1.types.DisableServiceRequest, dict]):
  The request object. Request message for the
@@ -533,6 +581,26 @@ def get_service(
  r"""Returns the service configuration and enabled state
  for a given service.
 
+
+
+ .. code-block::
+
+ from google.cloud import service_usage_v1
+
+ def sample_get_service():
+ # Create a client
+ client = service_usage_v1.ServiceUsageClient()
+
+ # Initialize request argument(s)
+ request = service_usage_v1.GetServiceRequest(
+ )
+
+ # Make the request
+ response = client.get_service(request=request)
+
+ # Handle the response
+ print(response)
+
  Args:
  request (Union[google.cloud.service_usage_v1.types.GetServiceRequest, dict]):
  The request object. Request message for the `GetService`
@@ -596,6 +664,27 @@ def list_services(
  which provides higher throughput and richer filtering
  capability.
 
+
+
+ .. code-block::
+
+ from google.cloud import service_usage_v1
+
+ def sample_list_services():
+ # Create a client
+ client = service_usage_v1.ServiceUsageClient()
+
+ # Initialize request argument(s)
+ request = service_usage_v1.ListServicesRequest(
+ )
+
+ # Make the request
+ page_result = client.list_services(request=request)
+
+ # Handle the response
+ for response in page_result:
+ print(response)
+
  Args:
  request (Union[google.cloud.service_usage_v1.types.ListServicesRequest, dict]):
  The request object. Request message for the
@@ -657,6 +746,30 @@ def batch_enable_services(
  no state changes occur. To enable a single service, use the
  ``EnableService`` method instead.
 
+
+
+ .. code-block::
+
+ from google.cloud import service_usage_v1
+
+ def sample_batch_enable_services():
+ # Create a client
+ client = service_usage_v1.ServiceUsageClient()
+
+ # Initialize request argument(s)
+ request = service_usage_v1.BatchEnableServicesRequest(
+ )
+
+ # Make the request
+ operation = client.batch_enable_services(request=request)
+
+ print("Waiting for operation to complete...")
+
+ response = operation.result()
+
+ # Handle the response
+ print(response)
+
  Args:
  request (Union[google.cloud.service_usage_v1.types.BatchEnableServicesRequest, dict]):
  The request object. Request message for the
@@ -720,6 +833,26 @@ def batch_get_services(
  r"""Returns the service configurations and enabled states
  for a given list of services.
 
+
+
+ .. code-block::
+
+ from google.cloud import service_usage_v1
+
+ def sample_batch_get_services():
+ # Create a client
+ client = service_usage_v1.ServiceUsageClient()
+
+ # Initialize request argument(s)
+ request = service_usage_v1.BatchGetServicesRequest(
+ )
+
+ # Make the request
+ response = client.batch_get_services(request=request)
+
+ # Handle the response
+ print(response)
+
  Args:
  request (Union[google.cloud.service_usage_v1.types.BatchGetServicesRequest, dict]):
  The request object. Request message for the

samples/generated_samples/serviceusage_generated_service_usage_v1_service_usage_batch_enable_services_async.py

@@ -0,0 +1,48 @@
+# -*- coding: utf-8 -*-
+# Copyright 2020 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#
+# Generated code. DO NOT EDIT!
+#
+# Snippet for BatchEnableServices
+# NOTE: This snippet has been automatically generated for illustrative purposes only.
+# It may require modifications to work in your environment.
+
+# To install the latest published package dependency, execute the following:
+# python3 -m pip install google-cloud-service-usage
+
+
+# [START serviceusage_generated_service_usage_v1_ServiceUsage_BatchEnableServices_async]
+from google.cloud import service_usage_v1
+
+
+async def sample_batch_enable_services():
+ # Create a client
+ client = service_usage_v1.ServiceUsageAsyncClient()
+
+ # Initialize request argument(s)
+ request = service_usage_v1.BatchEnableServicesRequest(
+ )
+
+ # Make the request
+ operation = client.batch_enable_services(request=request)
+
+ print("Waiting for operation to complete...")
+
+ response = await operation.result()
+
+ # Handle the response
+ print(response)
+
+# [END serviceusage_generated_service_usage_v1_ServiceUsage_BatchEnableServices_async]