docs: add generated snippets (#189)

* 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/scheduler_v1/services/cloud_scheduler/async_client.py

@@ -224,6 +224,26 @@ async def list_jobs(
  ) -> pagers.ListJobsAsyncPager:
  r"""Lists jobs.
 
+ .. code-block::
+
+ from google.cloud import scheduler_v1
+
+ def sample_list_jobs():
+ # Create a client
+ client = scheduler_v1.CloudSchedulerClient()
+
+ # Initialize request argument(s)
+ request = scheduler_v1.ListJobsRequest(
+ parent="parent_value",
+ )
+
+ # Make the request
+ page_result = client.list_jobs(request=request)
+
+ # Handle the response
+ for response in page_result:
+ print(response)
+
  Args:
  request (Union[google.cloud.scheduler_v1.types.ListJobsRequest, dict]):
  The request object. Request message for listing jobs
@@ -315,6 +335,25 @@ async def get_job(
  ) -> job.Job:
  r"""Gets a job.
 
+ .. code-block::
+
+ from google.cloud import scheduler_v1
+
+ def sample_get_job():
+ # Create a client
+ client = scheduler_v1.CloudSchedulerClient()
+
+ # Initialize request argument(s)
+ request = scheduler_v1.GetJobRequest(
+ name="name_value",
+ )
+
+ # Make the request
+ response = client.get_job(request=request)
+
+ # Handle the response
+ print(response)
+
  Args:
  request (Union[google.cloud.scheduler_v1.types.GetJobRequest, dict]):
  The request object. Request message for
@@ -398,6 +437,25 @@ async def create_job(
  ) -> gcs_job.Job:
  r"""Creates a job.
 
+ .. code-block::
+
+ from google.cloud import scheduler_v1
+
+ def sample_create_job():
+ # Create a client
+ client = scheduler_v1.CloudSchedulerClient()
+
+ # Initialize request argument(s)
+ request = scheduler_v1.CreateJobRequest(
+ parent="parent_value",
+ )
+
+ # Make the request
+ response = client.create_job(request=request)
+
+ # Handle the response
+ print(response)
+
  Args:
  request (Union[google.cloud.scheduler_v1.types.CreateJobRequest, dict]):
  The request object. Request message for
@@ -497,6 +555,25 @@ async def update_job(
  retry the UpdateJob request until a successful response is
  received.
 
+
+ .. code-block::
+
+ from google.cloud import scheduler_v1
+
+ def sample_update_job():
+ # Create a client
+ client = scheduler_v1.CloudSchedulerClient()
+
+ # Initialize request argument(s)
+ request = scheduler_v1.UpdateJobRequest(
+ )
+
+ # Make the request
+ response = client.update_job(request=request)
+
+ # Handle the response
+ print(response)
+
  Args:
  request (Union[google.cloud.scheduler_v1.types.UpdateJobRequest, dict]):
  The request object. Request message for
@@ -583,6 +660,22 @@ async def delete_job(
  ) -> None:
  r"""Deletes a job.
 
+ .. code-block::
+
+ from google.cloud import scheduler_v1
+
+ def sample_delete_job():
+ # Create a client
+ client = scheduler_v1.CloudSchedulerClient()
+
+ # Initialize request argument(s)
+ request = scheduler_v1.DeleteJobRequest(
+ name="name_value",
+ )
+
+ # Make the request
+ client.delete_job(request=request)
+
  Args:
  request (Union[google.cloud.scheduler_v1.types.DeleteJobRequest, dict]):
  The request object. Request message for deleting a job
@@ -669,6 +762,26 @@ async def pause_job(
  [Job.State.ENABLED][google.cloud.scheduler.v1.Job.State.ENABLED]
  to be paused.
 
+
+ .. code-block::
+
+ from google.cloud import scheduler_v1
+
+ def sample_pause_job():
+ # Create a client
+ client = scheduler_v1.CloudSchedulerClient()
+
+ # Initialize request argument(s)
+ request = scheduler_v1.PauseJobRequest(
+ name="name_value",
+ )
+
+ # Make the request
+ response = client.pause_job(request=request)
+
+ # Handle the response
+ print(response)
+
  Args:
  request (Union[google.cloud.scheduler_v1.types.PauseJobRequest, dict]):
  The request object. Request message for
@@ -751,6 +864,26 @@ async def resume_job(
  [Job.State.PAUSED][google.cloud.scheduler.v1.Job.State.PAUSED]
  to be resumed.
 
+
+ .. code-block::
+
+ from google.cloud import scheduler_v1
+
+ def sample_resume_job():
+ # Create a client
+ client = scheduler_v1.CloudSchedulerClient()
+
+ # Initialize request argument(s)
+ request = scheduler_v1.ResumeJobRequest(
+ name="name_value",
+ )
+
+ # Make the request
+ response = client.resume_job(request=request)
+
+ # Handle the response
+ print(response)
+
  Args:
  request (Union[google.cloud.scheduler_v1.types.ResumeJobRequest, dict]):
  The request object. Request message for
@@ -825,6 +958,26 @@ async def run_job(
  When this method is called, Cloud Scheduler will
  dispatch the job, even if the job is already running.
 
+
+ .. code-block::
+
+ from google.cloud import scheduler_v1
+
+ def sample_run_job():
+ # Create a client
+ client = scheduler_v1.CloudSchedulerClient()
+
+ # Initialize request argument(s)
+ request = scheduler_v1.RunJobRequest(
+ name="name_value",
+ )
+
+ # Make the request
+ response = client.run_job(request=request)
+
+ # Handle the response
+ print(response)
+
  Args:
  request (Union[google.cloud.scheduler_v1.types.RunJobRequest, dict]):
  The request object. Request message for forcing a job to