apache-airflow-providers-google 10.14.0rc2__py3-none-any.whl → 10.15.0rc1__py3-none-any.whl

airflow/providers/google/cloud/hooks/compute.py

@@ -75,7 +75,7 @@ class ComputeEngineHook(GoogleBaseHook):
 
     def get_conn(self):
         """
-        Retrieves connection to Google Compute Engine.
+        Retrieve connection to Google Compute Engine.
 
         :return: Google Compute Engine services object
         :rtype: dict
@@ -86,15 +86,15 @@ class ComputeEngineHook(GoogleBaseHook):
         return self._conn
 
     def get_compute_instance_template_client(self):
-        """Returns Compute Engine Instance Template Client."""
+        """Return Compute Engine Instance Template Client."""
         return InstanceTemplatesClient(credentials=self.get_credentials(), client_info=self.client_info)
 
     def get_compute_instance_client(self):
-        """Returns Compute Engine Instance Client."""
+        """Return Compute Engine Instance Client."""
         return InstancesClient(credentials=self.get_credentials(), client_info=self.client_info)
 
     def get_compute_instance_group_managers_client(self):
-        """Returns Compute Engine Instance Group Managers Client."""
+        """Return Compute Engine Instance Group Managers Client."""
         return InstanceGroupManagersClient(credentials=self.get_credentials(), client_info=self.client_info)
 
     @GoogleBaseHook.fallback_to_default_project_id
@@ -108,7 +108,7 @@ class ComputeEngineHook(GoogleBaseHook):
         metadata: Sequence[tuple[str, str]] = (),
     ) -> None:
         """
-        Creates Instance Template using body specified.
+        Create Instance Template using body specified.
 
         Must be called with keyword arguments rather than positional.
 
@@ -160,7 +160,7 @@ class ComputeEngineHook(GoogleBaseHook):
         metadata: Sequence[tuple[str, str]] = (),
     ) -> None:
         """
-        Deletes Instance Template.
+        Delete Instance Template.
 
         Deleting an Instance Template is permanent and cannot be undone. It is not
         possible to delete templates that are already in use by a managed instance
@@ -213,7 +213,7 @@ class ComputeEngineHook(GoogleBaseHook):
         metadata: Sequence[tuple[str, str]] = (),
     ) -> InstanceTemplate:
         """
-        Retrieves Instance Template by project_id and resource_id.
+        Retrieve Instance Template by project_id and resource_id.
 
         Must be called with keyword arguments rather than positional.
 
@@ -263,7 +263,7 @@ class ComputeEngineHook(GoogleBaseHook):
         metadata: Sequence[tuple[str, str]] = (),
     ) -> None:
         """
-        Creates Instance using body specified.
+        Create Instance using body specified.
 
         Must be called with keyword arguments rather than positional.
 
@@ -337,7 +337,7 @@ class ComputeEngineHook(GoogleBaseHook):
         metadata: Sequence[tuple[str, str]] = (),
     ) -> Instance:
         """
-        Retrieves Instance by project_id and resource_id.
+        Retrieve Instance by project_id and resource_id.
 
         Must be called with keyword arguments rather than positional.
 
@@ -439,7 +439,7 @@ class ComputeEngineHook(GoogleBaseHook):
     @GoogleBaseHook.fallback_to_default_project_id
     def start_instance(self, zone: str, resource_id: str, project_id: str) -> None:
         """
-        Starts an existing instance defined by project_id, zone and resource_id.
+        Start an existing instance defined by project_id, zone and resource_id.
 
         Must be called with keyword arguments rather than positional.
 
@@ -465,7 +465,7 @@ class ComputeEngineHook(GoogleBaseHook):
     @GoogleBaseHook.fallback_to_default_project_id
     def stop_instance(self, zone: str, resource_id: str, project_id: str) -> None:
         """
-        Stops an instance defined by project_id, zone and resource_id.
+        Stop an instance defined by project_id, zone and resource_id.
 
         Must be called with keyword arguments rather than positional.
 
@@ -491,7 +491,7 @@ class ComputeEngineHook(GoogleBaseHook):
     @GoogleBaseHook.fallback_to_default_project_id
     def set_machine_type(self, zone: str, resource_id: str, body: dict, project_id: str) -> None:
         """
-        Sets machine type of an instance defined by project_id, zone and resource_id.
+        Set machine type of an instance defined by project_id, zone and resource_id.
 
         Must be called with keyword arguments rather than positional.
 
@@ -532,7 +532,7 @@ class ComputeEngineHook(GoogleBaseHook):
         metadata: Sequence[tuple[str, str]] = (),
     ) -> None:
         """
-        Creates an Instance Group Managers using the body specified.
+        Create an Instance Group Managers using the body specified.
 
         After the group is created, instances in the group are created using the specified Instance Template.
         Must be called with keyword arguments rather than positional.
@@ -589,7 +589,7 @@ class ComputeEngineHook(GoogleBaseHook):
         metadata: Sequence[tuple[str, str]] = (),
     ) -> InstanceGroupManager:
         """
-        Retrieves Instance Group Manager by project_id, zone and resource_id.
+        Retrieve Instance Group Manager by project_id, zone and resource_id.
 
         Must be called with keyword arguments rather than positional.
 
@@ -737,7 +737,7 @@ class ComputeEngineHook(GoogleBaseHook):
         self, project_id: str, operation_name: str, zone: str | None = None
     ) -> None:
         """
-        Waits for the named operation to complete - checks status of the async call.
+        Wait for the named operation to complete - checks status of the async call.
 
         :param operation_name: name of the operation
         :param zone: optional region of the request (might be None for global operations)
@@ -793,7 +793,7 @@ class ComputeEngineHook(GoogleBaseHook):
     @GoogleBaseHook.fallback_to_default_project_id
     def get_instance_info(self, zone: str, resource_id: str, project_id: str) -> dict[str, Any]:
         """
-        Gets instance information.
+        Get instance information.
 
         :param zone: Google Cloud zone where the Instance Group Manager exists
         :param resource_id: Name of the Instance Group Manager

airflow/providers/google/cloud/hooks/compute_ssh.py

@@ -327,7 +327,7 @@ class ComputeEngineSSHHook(SSHHook):
                 break
         else:
             new_dict = {"key": "ssh-keys", "value": keys}
-            metadata["items"] = [new_dict]
+            metadata["items"] = [*items, new_dict]
 
         self._compute_hook.set_instance_metadata(
             zone=self.zone, resource_id=self.instance_name, metadata=metadata, project_id=self.project_id

airflow/providers/google/cloud/hooks/datacatalog.py

@@ -73,7 +73,7 @@ class CloudDataCatalogHook(GoogleBaseHook):
         self._client: DataCatalogClient | None = None
 
     def get_conn(self) -> DataCatalogClient:
-        """Retrieves client library object that allow access to Cloud Data Catalog service."""
+        """Retrieve client library object that allow access to Cloud Data Catalog service."""
         if not self._client:
             self._client = DataCatalogClient(credentials=self.get_credentials(), client_info=CLIENT_INFO)
         return self._client
@@ -91,7 +91,7 @@ class CloudDataCatalogHook(GoogleBaseHook):
         metadata: Sequence[tuple[str, str]] = (),
     ) -> Entry:
         """
-        Creates an entry.
+        Create an entry.
 
         Currently only entries of 'FILESET' type can be created.
 
@@ -133,7 +133,7 @@ class CloudDataCatalogHook(GoogleBaseHook):
         metadata: Sequence[tuple[str, str]] = (),
     ) -> EntryGroup:
         """
-        Creates an EntryGroup.
+        Create an EntryGroup.
 
         :param location: Required. The location of the entry group to create.
         :param entry_group_id: Required. The id of the entry group to create. The id must begin with a letter
@@ -179,7 +179,7 @@ class CloudDataCatalogHook(GoogleBaseHook):
         metadata: Sequence[tuple[str, str]] = (),
     ) -> Tag:
         """
-        Creates a tag on an entry.
+        Create a tag on an entry.
 
         :param location: Required. The location of the tag to create.
         :param entry_group: Required. Entry group ID under which the tag is created.
@@ -242,7 +242,7 @@ class CloudDataCatalogHook(GoogleBaseHook):
         metadata: Sequence[tuple[str, str]] = (),
     ) -> TagTemplate:
         """
-        Creates a tag template.
+        Create a tag template.
 
         :param location: Required. The location of the tag template to create.
         :param tag_template_id: Required. The id of the tag template to create.
@@ -301,7 +301,7 @@ class CloudDataCatalogHook(GoogleBaseHook):
         metadata: Sequence[tuple[str, str]] = (),
     ) -> TagTemplateField:
         r"""
-        Creates a field in a tag template.
+        Create a field in a tag template.
 
         :param location: Required. The location of the tag template field to create.
         :param tag_template: Required. The id of the tag template to create.
@@ -353,7 +353,7 @@ class CloudDataCatalogHook(GoogleBaseHook):
         metadata: Sequence[tuple[str, str]] = (),
     ) -> None:
         """
-        Deletes an existing entry.
+        Delete an existing entry.
 
         :param location: Required. The location of the entry to delete.
         :param entry_group: Required. Entry group ID for entries that is deleted.
@@ -383,7 +383,7 @@ class CloudDataCatalogHook(GoogleBaseHook):
         metadata: Sequence[tuple[str, str]] = (),
     ) -> None:
         """
-        Deletes an EntryGroup.
+        Delete an EntryGroup.
 
         Only entry groups that do not contain entries can be deleted.
 
@@ -419,7 +419,7 @@ class CloudDataCatalogHook(GoogleBaseHook):
         metadata: Sequence[tuple[str, str]] = (),
     ) -> None:
         """
-        Deletes a tag.
+        Delete a tag.
 
         :param location: Required. The location of the tag to delete.
         :param entry_group: Entry group ID for tag that is deleted.
@@ -454,7 +454,7 @@ class CloudDataCatalogHook(GoogleBaseHook):
         metadata: Sequence[tuple[str, str]] = (),
     ) -> None:
         """
-        Deletes a tag template and all tags using the template.
+        Delete a tag template and all tags using the template.
 
         :param location: Required. The location of the tag template to delete.
         :param tag_template: ID for tag template that is deleted.
@@ -491,7 +491,7 @@ class CloudDataCatalogHook(GoogleBaseHook):
         metadata: Sequence[tuple[str, str]] = (),
     ) -> None:
         """
-        Deletes a field in a tag template and all uses of that field.
+        Delete a field in a tag template and all uses of that field.
 
         :param location: Required. The location of the tag template to delete.
         :param tag_template: Tag Template ID for tag template field that is deleted.
@@ -526,7 +526,7 @@ class CloudDataCatalogHook(GoogleBaseHook):
         metadata: Sequence[tuple[str, str]] = (),
     ) -> Entry:
         """
-        Gets an entry.
+        Get an entry.
 
         :param location: Required. The location of the entry to get.
         :param entry_group: Required. The entry group of the entry to get.
@@ -562,7 +562,7 @@ class CloudDataCatalogHook(GoogleBaseHook):
         metadata: Sequence[tuple[str, str]] = (),
     ) -> EntryGroup:
         """
-        Gets an entry group.
+        Get an entry group.
 
         :param location: Required. The location of the entry group to get.
         :param entry_group: The ID of the entry group to get.
@@ -605,7 +605,7 @@ class CloudDataCatalogHook(GoogleBaseHook):
         metadata: Sequence[tuple[str, str]] = (),
     ) -> TagTemplate:
         """
-        Gets a tag template.
+        Get a tag template.
 
         :param location: Required. The location of the tag template to get.
         :param tag_template: Required. The ID of the tag template to get.
@@ -643,7 +643,7 @@ class CloudDataCatalogHook(GoogleBaseHook):
         metadata: Sequence[tuple[str, str]] = (),
     ):
         """
-        Lists the tags on an Entry.
+        List the tags on an Entry.
 
         :param location: Required. The location of the tags to get.
         :param entry_group: Required. The entry group of the tags to get.
@@ -688,7 +688,7 @@ class CloudDataCatalogHook(GoogleBaseHook):
         metadata: Sequence[tuple[str, str]] = (),
     ) -> Tag:
         """
-        Gets for a tag with a specific template for a specific entry.
+        Get for a tag with a specific template for a specific entry.
 
         :param location: Required. The location which contains the entry to search for.
         :param entry_group: The entry group ID which contains the entry to search for.
@@ -779,7 +779,7 @@ class CloudDataCatalogHook(GoogleBaseHook):
         metadata: Sequence[tuple[str, str]] = (),
     ) -> TagTemplateField:
         """
-        Renames a field in a tag template.
+        Rename a field in a tag template.
 
         :param location: Required. The location of the tag template field to rename.
         :param tag_template: The tag template ID for field that is renamed.
@@ -824,7 +824,7 @@ class CloudDataCatalogHook(GoogleBaseHook):
         metadata: Sequence[tuple[str, str]] = (),
     ):
         r"""
-        Searches Data Catalog for multiple resources like entries, tags that match a query.
+        Search Data Catalog for multiple resources like entries, tags that match a query.
 
         This does not return the complete resource, only the resource identifier and high level fields.
         Clients can subsequently call ``Get`` methods.
@@ -898,7 +898,7 @@ class CloudDataCatalogHook(GoogleBaseHook):
         metadata: Sequence[tuple[str, str]] = (),
     ) -> Entry:
         """
-        Updates an existing entry.
+        Update an existing entry.
 
         :param entry: Required. The updated entry. The "name" field must be set.
 
@@ -968,7 +968,7 @@ class CloudDataCatalogHook(GoogleBaseHook):
         metadata: Sequence[tuple[str, str]] = (),
     ) -> Tag:
         """
-        Updates an existing tag.
+        Update an existing tag.
 
         :param tag: Required. The updated tag. The "name" field must be set.
 
@@ -1038,7 +1038,7 @@ class CloudDataCatalogHook(GoogleBaseHook):
         metadata: Sequence[tuple[str, str]] = (),
     ) -> TagTemplate:
         """
-        Updates a tag template.
+        Update a tag template.
 
         This method cannot be used to update the fields of a template. The tag
         template fields are represented as separate resources and should be updated using their own
@@ -1112,7 +1112,7 @@ class CloudDataCatalogHook(GoogleBaseHook):
         metadata: Sequence[tuple[str, str]] = (),
     ):
         """
-        Updates a field in a tag template. This method cannot be used to update the field type.
+        Update a field in a tag template. This method cannot be used to update the field type.
 
         :param tag_template_field: Required. The template to update.
 

airflow/providers/google/cloud/hooks/dataflow.py

@@ -29,6 +29,7 @@ import warnings
 from copy import deepcopy
 from typing import TYPE_CHECKING, Any, Callable, Generator, Sequence, TypeVar, cast
 
+from deprecated import deprecated
 from google.cloud.dataflow_v1beta3 import GetJobRequest, Job, JobState, JobsV1Beta3AsyncClient, JobView
 from google.cloud.dataflow_v1beta3.types.jobs import ListJobsRequest
 from googleapiclient.discovery import build
@@ -86,7 +87,7 @@ def process_line_and_extract_dataflow_job_id_callback(
 def _fallback_variable_parameter(parameter_name: str, variable_key_name: str) -> Callable[[T], T]:
     def _wrapper(func: T) -> T:
         """
-        Decorator that provides fallback for location from `region` key in `variables` parameters.
+        Fallback for location from `region` key in `variables` parameters.
 
         :param func: function to wrap
         :return: result of the function call
@@ -224,7 +225,7 @@ class _DataflowJobsController(LoggingMixin):
 
     def is_job_running(self) -> bool:
         """
-        Helper method to check if job is still running in dataflow.
+        Check if job is still running in dataflow.
 
         :return: True if job is running.
         """
@@ -236,7 +237,7 @@ class _DataflowJobsController(LoggingMixin):
 
     def _get_current_jobs(self) -> list[dict]:
         """
-        Helper method to get list of jobs that start with job name or id.
+        Get list of jobs that start with job name or id.
 
         :return: list of jobs including id's
         """
@@ -254,7 +255,7 @@ class _DataflowJobsController(LoggingMixin):
 
     def fetch_job_by_id(self, job_id: str) -> dict:
         """
-        Helper method to fetch the job with the specified Job ID.
+        Fetch the job with the specified Job ID.
 
         :param job_id: Job ID to get.
         :return: the Job
@@ -273,7 +274,7 @@ class _DataflowJobsController(LoggingMixin):
 
     def fetch_job_metrics_by_id(self, job_id: str) -> dict:
         """
-        Helper method to fetch the job metrics with the specified Job ID.
+        Fetch the job metrics with the specified Job ID.
 
         :param job_id: Job ID to get.
         :return: the JobMetrics. See:
@@ -292,7 +293,7 @@ class _DataflowJobsController(LoggingMixin):
 
     def _fetch_list_job_messages_responses(self, job_id: str) -> Generator[dict, None, None]:
         """
-        Helper method to fetch ListJobMessagesResponse with the specified Job ID.
+        Fetch ListJobMessagesResponse with the specified Job ID.
 
         :param job_id: Job ID to get.
         :return: yields the ListJobMessagesResponse. See:
@@ -320,7 +321,7 @@ class _DataflowJobsController(LoggingMixin):
 
     def fetch_job_messages_by_id(self, job_id: str) -> list[dict]:
         """
-        Helper method to fetch the job messages with the specified Job ID.
+        Fetch the job messages with the specified Job ID.
 
         :param job_id: Job ID to get.
         :return: the list of JobMessages. See:
@@ -333,7 +334,7 @@ class _DataflowJobsController(LoggingMixin):
 
     def fetch_job_autoscaling_events_by_id(self, job_id: str) -> list[dict]:
         """
-        Helper method to fetch the job autoscaling events with the specified Job ID.
+        Fetch the job autoscaling events with the specified Job ID.
 
         :param job_id: Job ID to get.
         :return: the list of AutoscalingEvents. See:
@@ -374,7 +375,7 @@ class _DataflowJobsController(LoggingMixin):
 
     def _refresh_jobs(self) -> None:
         """
-        Helper method to get all jobs by name.
+        Get all jobs by name.
 
         :return: jobs
         """
@@ -392,7 +393,7 @@ class _DataflowJobsController(LoggingMixin):
 
     def _check_dataflow_job_state(self, job) -> bool:
         """
-        Helper method to check the state of one job in dataflow for this task if job failed raise exception.
+        Check the state of one job in dataflow for this task if job failed raise exception.
 
         :return: True if job is done.
         :raise: Exception
@@ -439,7 +440,7 @@ class _DataflowJobsController(LoggingMixin):
         )
 
     def wait_for_done(self) -> None:
-        """Helper method to wait for result of submitted job."""
+        """Wait for result of submitted job."""
         self.log.info("Start waiting for done.")
         self._refresh_jobs()
         while self._jobs and not all(self._check_dataflow_job_state(job) for job in self._jobs):
@@ -449,7 +450,7 @@ class _DataflowJobsController(LoggingMixin):
 
     def get_jobs(self, refresh: bool = False) -> list[dict]:
         """
-        Returns Dataflow jobs.
+        Return Dataflow jobs.
 
         :param refresh: Forces the latest data to be fetched.
         :return: list of jobs
@@ -462,7 +463,7 @@ class _DataflowJobsController(LoggingMixin):
         return self._jobs
 
     def _wait_for_states(self, expected_states: set[str]):
-        """Waiting for the jobs to reach a certain state."""
+        """Wait for the jobs to reach a certain state."""
         if not self._jobs:
             raise ValueError("The _jobs should be set")
         while True:
@@ -485,7 +486,7 @@ class _DataflowJobsController(LoggingMixin):
             time.sleep(self._poll_sleep)
 
     def cancel(self) -> None:
-        """Cancels or drains current job."""
+        """Cancel or drains current job."""
         self._jobs = [
             job for job in self.get_jobs() if job["currentState"] not in DataflowJobStatus.TERMINAL_STATES
         ]
@@ -560,13 +561,22 @@ class DataflowHook(GoogleBaseHook):
         )
 
     def get_conn(self) -> build:
-        """Returns a Google Cloud Dataflow service object."""
+        """Return a Google Cloud Dataflow service object."""
         http_authorized = self._authorize()
         return build("dataflow", "v1b3", http=http_authorized, cache_discovery=False)
 
     @_fallback_to_location_from_variables
     @_fallback_to_project_id_from_variables
     @GoogleBaseHook.fallback_to_default_project_id
+    @deprecated(
+        reason=(
+            "This method is deprecated. "
+            "Please use `airflow.providers.apache.beam.hooks.beam.start.start_java_pipeline` "
+            "to start pipeline and `providers.google.cloud.hooks.dataflow.DataflowHook.wait_for_done` "
+            "to wait for the required pipeline state."
+        ),
+        category=AirflowProviderDeprecationWarning,
+    )
     def start_java_dataflow(
         self,
         job_name: str,
@@ -580,7 +590,7 @@ class DataflowHook(GoogleBaseHook):
         location: str = DEFAULT_DATAFLOW_LOCATION,
     ) -> None:
         """
-        Starts Dataflow java job.
+        Start Dataflow java job.
 
         :param job_name: The name of the job.
         :param variables: Variables passed to the job.
@@ -593,16 +603,6 @@ class DataflowHook(GoogleBaseHook):
         :param on_new_job_id_callback: Callback called when the job ID is known.
         :param location: Job location.
         """
-        warnings.warn(
-            """"This method is deprecated.
-            Please use `airflow.providers.apache.beam.hooks.beam.start.start_java_pipeline`
-            to start pipeline and `providers.google.cloud.hooks.dataflow.DataflowHook.wait_for_done`
-            to wait for the required pipeline state.
-            """,
-            AirflowProviderDeprecationWarning,
-            stacklevel=3,
-        )
-
         name = self.build_dataflow_job_name(job_name, append_job_name)
 
         variables["jobName"] = name
@@ -642,7 +642,7 @@ class DataflowHook(GoogleBaseHook):
         environment: dict | None = None,
     ) -> dict:
         """
-        Starts Dataflow template job.
+        Start Dataflow template job.
 
         :param job_name: The name of the job.
         :param variables: Map of job runtime environment options.
@@ -767,7 +767,7 @@ class DataflowHook(GoogleBaseHook):
         on_new_job_callback: Callable[[dict], None] | None = None,
     ) -> dict:
         """
-        Starts flex templates with the Dataflow pipeline.
+        Start flex templates with the Dataflow pipeline.
 
         :param body: The request body. See:
             https://cloud.google.com/dataflow/docs/reference/rest/v1b3/projects.locations.flexTemplates/launch#request-body
@@ -816,6 +816,15 @@ class DataflowHook(GoogleBaseHook):
     @_fallback_to_location_from_variables
     @_fallback_to_project_id_from_variables
     @GoogleBaseHook.fallback_to_default_project_id
+    @deprecated(
+        reason=(
+            "This method is deprecated. "
+            "Please use `airflow.providers.apache.beam.hooks.beam.start.start_python_pipeline` "
+            "to start pipeline and `providers.google.cloud.hooks.dataflow.DataflowHook.wait_for_done` "
+            "to wait for the required pipeline state."
+        ),
+        category=AirflowProviderDeprecationWarning,
+    )
     def start_python_dataflow(
         self,
         job_name: str,
@@ -831,7 +840,7 @@ class DataflowHook(GoogleBaseHook):
         location: str = DEFAULT_DATAFLOW_LOCATION,
     ):
         """
-        Starts Dataflow job.
+        Start Dataflow job.
 
         :param job_name: The name of the job.
         :param variables: Variables passed to the job.
@@ -859,16 +868,6 @@ class DataflowHook(GoogleBaseHook):
         :param on_new_job_id_callback: Callback called when the job ID is known.
         :param location: Job location.
         """
-        warnings.warn(
-            """This method is deprecated.
-            Please use `airflow.providers.apache.beam.hooks.beam.start.start_python_pipeline`
-            to start pipeline and `providers.google.cloud.hooks.dataflow.DataflowHook.wait_for_done`
-            to wait for the required pipeline state.
-            """,
-            AirflowProviderDeprecationWarning,
-            stacklevel=3,
-        )
-
         name = self.build_dataflow_job_name(job_name, append_job_name)
         variables["job_name"] = name
         variables["region"] = location
@@ -892,7 +891,7 @@ class DataflowHook(GoogleBaseHook):
 
     @staticmethod
     def build_dataflow_job_name(job_name: str, append_job_name: bool = True) -> str:
-        """Builds Dataflow job name."""
+        """Build Dataflow job name."""
         base_job_name = str(job_name).replace("_", "-")
 
         if not re.fullmatch(r"[a-z]([-a-z0-9]*[a-z0-9])?", base_job_name):
@@ -919,7 +918,7 @@ class DataflowHook(GoogleBaseHook):
         variables: dict | None = None,
     ) -> bool:
         """
-        Helper method to check if jos is still running in dataflow.
+        Check if jos is still running in dataflow.
 
         :param name: The name of the job.
         :param project_id: Optional, the Google Cloud project ID in which to start a job.
@@ -955,7 +954,7 @@ class DataflowHook(GoogleBaseHook):
         location: str = DEFAULT_DATAFLOW_LOCATION,
     ) -> None:
         """
-        Cancels the job with the specified name prefix or Job ID.
+        Cancel the job with the specified name prefix or Job ID.
 
         Parameter ``name`` and ``job_id`` are mutually exclusive.
 
@@ -990,7 +989,7 @@ class DataflowHook(GoogleBaseHook):
         on_new_job_callback: Callable[[dict], None] | None = None,
     ):
         """
-        Starts Dataflow SQL query.
+        Start Dataflow SQL query.
 
         :param job_name: The unique name to assign to the Cloud Dataflow job.
         :param query: The SQL query to execute.
@@ -1083,7 +1082,7 @@ class DataflowHook(GoogleBaseHook):
         location: str = DEFAULT_DATAFLOW_LOCATION,
     ) -> dict:
         """
-        Gets the job with the specified Job ID.
+        Get the job with the specified Job ID.
 
         :param job_id: Job ID to get.
         :param project_id: Optional, the Google Cloud project ID in which to start a job.
@@ -1107,7 +1106,7 @@ class DataflowHook(GoogleBaseHook):
         location: str = DEFAULT_DATAFLOW_LOCATION,
     ) -> dict:
         """
-        Gets the job metrics with the specified Job ID.
+        Get the job metrics with the specified Job ID.
 
         :param job_id: Job ID to get.
         :param project_id: Optional, the Google Cloud project ID in which to start a job.
@@ -1132,7 +1131,7 @@ class DataflowHook(GoogleBaseHook):
         location: str = DEFAULT_DATAFLOW_LOCATION,
     ) -> list[dict]:
         """
-        Gets the job messages with the specified Job ID.
+        Get the job messages with the specified Job ID.
 
         :param job_id: Job ID to get.
         :param project_id: Optional, the Google Cloud project ID in which to start a job.
@@ -1156,7 +1155,7 @@ class DataflowHook(GoogleBaseHook):
         location: str = DEFAULT_DATAFLOW_LOCATION,
     ) -> list[dict]:
         """
-        Gets the job autoscaling events with the specified Job ID.
+        Get the job autoscaling events with the specified Job ID.
 
         :param job_id: Job ID to get.
         :param project_id: Optional, the Google Cloud project ID in which to start a job.
@@ -1266,7 +1265,7 @@ class AsyncDataflowHook(GoogleBaseAsyncHook):
         location: str = DEFAULT_DATAFLOW_LOCATION,
     ) -> Job:
         """
-        Gets the job with the specified Job ID.
+        Get the job with the specified Job ID.
 
         :param job_id: Job ID to get.
         :param project_id: the Google Cloud project ID in which to start a job.
@@ -1301,7 +1300,7 @@ class AsyncDataflowHook(GoogleBaseAsyncHook):
         location: str = DEFAULT_DATAFLOW_LOCATION,
     ) -> JobState:
         """
-        Gets the job status with the specified Job ID.
+        Get the job status with the specified Job ID.
 
         :param job_id: Job ID to get.
         :param project_id: the Google Cloud project ID in which to start a job.