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

airflow/providers/google/common/hooks/base_google.py

@@ -18,12 +18,12 @@
 """This module contains a Google Cloud API base hook."""
 from __future__ import annotations
 
+import datetime
 import functools
 import json
 import logging
 import os
 import tempfile
-import warnings
 from contextlib import ExitStack, contextmanager
 from subprocess import check_output
 from typing import TYPE_CHECKING, Any, Callable, Generator, Sequence, TypeVar, cast
@@ -35,6 +35,8 @@ import google_auth_httplib2
 import requests
 import tenacity
 from asgiref.sync import sync_to_async
+from deprecated import deprecated
+from gcloud.aio.auth.token import Token
 from google.api_core.exceptions import Forbidden, ResourceExhausted, TooManyRequests
 from google.auth import _cloud_sdk, compute_engine  # type: ignore[attr-defined]
 from google.auth.environment_vars import CLOUD_SDK_CONFIG_DIR, CREDENTIALS
@@ -43,6 +45,7 @@ from google.auth.transport import _http_client
 from googleapiclient import discovery
 from googleapiclient.errors import HttpError
 from googleapiclient.http import MediaIoBaseDownload, build_http, set_user_agent
+from requests import Session
 
 from airflow import version
 from airflow.exceptions import AirflowException, AirflowProviderDeprecationWarning
@@ -56,7 +59,9 @@ from airflow.providers.google.common.consts import CLIENT_INFO
 from airflow.utils.process_utils import patch_environ
 
 if TYPE_CHECKING:
+    from aiohttp import ClientSession
     from google.api_core.gapic_v1.client_info import ClientInfo
+    from google.auth.credentials import Credentials
 
 log = logging.getLogger(__name__)
 
@@ -74,6 +79,8 @@ INVALID_REASONS = [
 
 def is_soft_quota_exception(exception: Exception):
     """
+    Check for quota violation errors.
+
     API for Google services does not have a standardized way to report quota violation errors.
 
     The function has been adapted by trial and error to the following services:
@@ -95,6 +102,8 @@ def is_soft_quota_exception(exception: Exception):
 
 def is_operation_in_progress_exception(exception: Exception) -> bool:
     """
+    Handle operation in-progress exceptions.
+
     Some calls return 429 (too many requests!) or 409 errors (Conflict) in case of operation in progress.
 
     * Google Cloud SQL
@@ -190,7 +199,7 @@ class GoogleBaseHook(BaseHook):
 
     @classmethod
     def get_connection_form_widgets(cls) -> dict[str, Any]:
-        """Returns connection widgets to add to connection form."""
+        """Return connection widgets to add to connection form."""
         from flask_appbuilder.fieldwidgets import BS3PasswordFieldWidget, BS3TextFieldWidget
         from flask_babel import lazy_gettext
         from wtforms import IntegerField, PasswordField, StringField
@@ -223,7 +232,7 @@ class GoogleBaseHook(BaseHook):
 
     @classmethod
     def get_ui_field_behaviour(cls) -> dict[str, Any]:
-        """Returns custom field behaviour."""
+        """Return custom field behaviour."""
         return {
             "hidden_fields": ["host", "schema", "login", "password", "port", "extra"],
             "relabeling": {},
@@ -234,9 +243,8 @@ class GoogleBaseHook(BaseHook):
         gcp_conn_id: str = "google_cloud_default",
         delegate_to: str | None = None,
         impersonation_chain: str | Sequence[str] | None = None,
-        **kwargs,
     ) -> None:
-        super().__init__(**kwargs)
+        super().__init__()
         self.gcp_conn_id = gcp_conn_id
         self.delegate_to = delegate_to
         self.impersonation_chain = impersonation_chain
@@ -245,7 +253,7 @@ class GoogleBaseHook(BaseHook):
         self._cached_project_id: str | None = None
 
     def get_credentials_and_project_id(self) -> tuple[google.auth.credentials.Credentials, str | None]:
-        """Returns the Credentials object for Google API and the associated project_id."""
+        """Return the Credentials object for Google API and the associated project_id."""
         if self._cached_credentials is not None:
             return self._cached_credentials, self._cached_project_id
 
@@ -295,12 +303,12 @@ class GoogleBaseHook(BaseHook):
         return credentials, project_id
 
     def get_credentials(self) -> google.auth.credentials.Credentials:
-        """Returns the Credentials object for Google API."""
+        """Return the Credentials object for Google API."""
         credentials, _ = self.get_credentials_and_project_id()
         return credentials
 
     def _get_access_token(self) -> str:
-        """Returns a valid access token from Google API Credentials."""
+        """Return a valid access token from Google API Credentials."""
         credentials = self.get_credentials()
         auth_req = google.auth.transport.requests.Request()
         # credentials.token is None
@@ -311,7 +319,7 @@ class GoogleBaseHook(BaseHook):
     @functools.lru_cache(maxsize=None)
     def _get_credentials_email(self) -> str:
         """
-        Returns the email address associated with the currently logged in account.
+        Return the email address associated with the currently logged in account.
 
         If a service account is used, it returns the service account.
         If user authentication (e.g. gcloud auth) is used, it returns the e-mail account of that user.
@@ -337,7 +345,7 @@ class GoogleBaseHook(BaseHook):
         return oauth2_client.tokeninfo().execute()["email"]
 
     def _authorize(self) -> google_auth_httplib2.AuthorizedHttp:
-        """Returns an authorized HTTP object to be used to build a Google cloud service hook connection."""
+        """Return an authorized HTTP object to be used to build a Google cloud service hook connection."""
         credentials = self.get_credentials()
         http = build_http()
         http = set_user_agent(http, "airflow/" + version.version)
@@ -346,7 +354,7 @@ class GoogleBaseHook(BaseHook):
 
     def _get_field(self, f: str, default: Any = None) -> Any:
         """
-        Fetches a field from extras, and returns it.
+        Fetch a field from extras, and returns it.
 
         This is some Airflow magic. The google_cloud_platform hook type adds
         custom UI elements to the hook page, which allow admins to specify
@@ -386,6 +394,10 @@ class GoogleBaseHook(BaseHook):
             )
 
     @property
+    @deprecated(
+        reason="Please use `airflow.providers.google.common.consts.CLIENT_INFO`.",
+        category=AirflowProviderDeprecationWarning,
+    )
     def client_info(self) -> ClientInfo:
         """
         Return client information used to generate a user-agent for API calls.
@@ -396,11 +408,6 @@ class GoogleBaseHook(BaseHook):
         the Google Cloud. It is not supported by The Google APIs Python Client that use Discovery
         based APIs.
         """
-        warnings.warn(
-            "This method is deprecated, please use `airflow.providers.google.common.consts.CLIENT_INFO`.",
-            AirflowProviderDeprecationWarning,
-            stacklevel=2,
-        )
         return CLIENT_INFO
 
     @property
@@ -416,7 +423,7 @@ class GoogleBaseHook(BaseHook):
 
     @staticmethod
     def quota_retry(*args, **kwargs) -> Callable:
-        """Provides a mechanism to repeat requests in response to exceeding a temporary quota limit."""
+        """Provide a mechanism to repeat requests in response to exceeding a temporary quota limit."""
 
         def decorator(fun: Callable):
             default_kwargs = {
@@ -432,7 +439,7 @@ class GoogleBaseHook(BaseHook):
 
     @staticmethod
     def operation_in_progress_retry(*args, **kwargs) -> Callable[[T], T]:
-        """Provides a mechanism to repeat requests in response to operation in progress (HTTP 409) limit."""
+        """Provide a mechanism to repeat requests in response to operation in progress (HTTP 409) limit."""
 
         def decorator(fun: T):
             default_kwargs = {
@@ -449,7 +456,7 @@ class GoogleBaseHook(BaseHook):
     @staticmethod
     def fallback_to_default_project_id(func: Callable[..., RT]) -> Callable[..., RT]:
         """
-        Decorator that provides fallback for Google Cloud project id.
+        Provide fallback for Google Cloud project id. To be used as a decorator.
 
         If the project is None it will be replaced with the project_id from the
         service account the Hook is authenticated with. Project id can be specified
@@ -482,7 +489,7 @@ class GoogleBaseHook(BaseHook):
     @staticmethod
     def provide_gcp_credential_file(func: T) -> T:
         """
-        Provides a Google Cloud credentials for Application Default Credentials (ADC) strategy support.
+        Provide a Google Cloud credentials for Application Default Credentials (ADC) strategy support.
 
         It is recommended to use ``provide_gcp_credential_file_as_context`` context
         manager to limit the scope when authorization data is available. Using context
@@ -499,7 +506,7 @@ class GoogleBaseHook(BaseHook):
     @contextmanager
     def provide_gcp_credential_file_as_context(self) -> Generator[str | None, None, None]:
         """
-        Provides a Google Cloud credentials for Application Default Credentials (ADC) strategy support.
+        Provide a Google Cloud credentials for Application Default Credentials (ADC) strategy support.
 
         See:
             `Application Default Credentials (ADC)
@@ -535,7 +542,7 @@ class GoogleBaseHook(BaseHook):
     @contextmanager
     def provide_authorized_gcloud(self) -> Generator[None, None, None]:
         """
-        Provides a separate gcloud configuration with current credentials.
+        Provide a separate gcloud configuration with current credentials.
 
         The gcloud tool allows you to login to Google Cloud only - ``gcloud auth login`` and
         for the needs of Application Default Credentials ``gcloud auth application-default login``.
@@ -623,13 +630,60 @@ class GoogleBaseHook(BaseHook):
         return status, message
 
 
+class _CredentialsToken(Token):
+    """A token implementation which makes Google credentials objects accessible to [gcloud-aio](https://talkiq.github.io/gcloud-aio/) clients.
+
+    This class allows us to create token instances from credentials objects and thus supports a variety of use cases for Google
+    credentials in Airflow (i.e. impersonation chain). By relying on a existing credentials object we leverage functionality provided by the GoogleBaseHook
+    for generating credentials objects.
+    """
+
+    def __init__(
+        self,
+        credentials: Credentials,
+        *,
+        project: str | None = None,
+        session: ClientSession | None = None,
+        scopes: Sequence[str] | None = None,
+    ) -> None:
+        _scopes: list[str] | None = list(scopes) if scopes else None
+        super().__init__(session=cast(Session, session), scopes=_scopes)
+        self.credentials = credentials
+        self.project = project
+
+    @classmethod
+    async def from_hook(
+        cls,
+        hook: GoogleBaseHook,
+        *,
+        session: ClientSession | None = None,
+    ) -> _CredentialsToken:
+        credentials, project = hook.get_credentials_and_project_id()
+        return cls(
+            credentials=credentials,
+            project=project,
+            session=session,
+            scopes=hook.scopes,
+        )
+
+    async def get_project(self) -> str | None:
+        return self.project
+
+    async def acquire_access_token(self, timeout: int = 10) -> None:
+        await sync_to_async(self.credentials.refresh)(google.auth.transport.requests.Request())
+
+        self.access_token = cast(str, self.credentials.token)
+        self.access_token_duration = 3600
+        self.access_token_acquired_at = datetime.datetime.utcnow()
+        self.acquiring = None
+
+
 class GoogleBaseAsyncHook(BaseHook):
     """GoogleBaseAsyncHook inherits from BaseHook class, run on the trigger worker."""
 
     sync_hook_class: Any = None
 
     def __init__(self, **kwargs: Any):
-        super().__init__(logger_name=kwargs.pop("logger_name", None))
         self._hook_kwargs = kwargs
         self._sync_hook = None
 
@@ -639,6 +693,16 @@ class GoogleBaseAsyncHook(BaseHook):
             self._sync_hook = await sync_to_async(self.sync_hook_class)(**self._hook_kwargs)
         return self._sync_hook
 
+    async def get_token(self, *, session: ClientSession | None = None) -> _CredentialsToken:
+        """Return a Token instance for use in [gcloud-aio](https://talkiq.github.io/gcloud-aio/) clients."""
+        sync_hook = await self.get_sync_hook()
+        return await _CredentialsToken.from_hook(sync_hook, session=session)
+
     async def service_file_as_context(self) -> Any:
+        """
+        Provide a Google Cloud credentials for Application Default Credentials (ADC) strategy support.
+
+        This is the async equivalent of the non-async GoogleBaseHook's `provide_gcp_credential_file_as_context` method.
+        """
         sync_hook = await self.get_sync_hook()
         return await sync_to_async(sync_hook.provide_gcp_credential_file_as_context)()

airflow/providers/google/common/hooks/discovery_api.py

@@ -66,7 +66,7 @@ class GoogleDiscoveryApiHook(GoogleBaseHook):
 
     def get_conn(self) -> Resource:
         """
-        Creates an authenticated api client for the given api service name and credentials.
+        Create an authenticated api client for the given api service name and credentials.
 
         :return: the authenticated api service.
         """
@@ -84,7 +84,7 @@ class GoogleDiscoveryApiHook(GoogleBaseHook):
 
     def query(self, endpoint: str, data: dict, paginate: bool = False, num_retries: int = 0) -> dict:
         """
-        Creates a dynamic API call to any Google API registered in Google's API Client Library and queries it.
+        Create a dynamic API call to any Google API registered in Google's API Client Library and queries it.
 
         :param endpoint: The client libraries path to the api call's executing method.
             For example: 'analyticsreporting.reports.batchGet'

airflow/providers/google/common/utils/id_token_credentials.py

@@ -81,7 +81,7 @@ def _load_credentials_from_file(
     filename: str, target_audience: str | None
 ) -> google_auth_credentials.Credentials | None:
     """
-    Loads credentials from a file.
+    Load credentials from a file.
 
     The credentials file must be a service account key or a stored authorized user credential.
 
@@ -129,7 +129,7 @@ def _load_credentials_from_file(
 def _get_explicit_environ_credentials(
     target_audience: str | None,
 ) -> google_auth_credentials.Credentials | None:
-    """Gets credentials from the GOOGLE_APPLICATION_CREDENTIALS environment variable."""
+    """Get credentials from the GOOGLE_APPLICATION_CREDENTIALS environment variable."""
     explicit_file = os.environ.get(environment_vars.CREDENTIALS)
 
     if explicit_file is None:
@@ -145,7 +145,7 @@ def _get_explicit_environ_credentials(
 def _get_gcloud_sdk_credentials(
     target_audience: str | None,
 ) -> google_auth_credentials.Credentials | None:
-    """Gets the credentials and project ID from the Cloud SDK."""
+    """Get the credentials and project ID from the Cloud SDK."""
     from google.auth import _cloud_sdk  # type: ignore[attr-defined]
 
     # Check if application default credentials exist.
@@ -162,7 +162,7 @@ def _get_gcloud_sdk_credentials(
 def _get_gce_credentials(
     target_audience: str | None, request: google.auth.transport.Request | None = None
 ) -> google_auth_credentials.Credentials | None:
-    """Gets credentials and project ID from the GCE Metadata Service."""
+    """Get credentials and project ID from the GCE Metadata Service."""
     # Ping requires a transport, but we want application default credentials
     # to require no arguments. So, we'll use the _http_client transport which
     # uses http.client. This is only acceptable because the metadata server
@@ -191,7 +191,7 @@ def _get_gce_credentials(
 def get_default_id_token_credentials(
     target_audience: str | None, request: google.auth.transport.Request = None
 ) -> google_auth_credentials.Credentials:
-    """Gets the default ID Token credentials for the current environment.
+    """Get the default ID Token credentials for the current environment.
 
     `Application Default Credentials`_ provides an easy way to obtain credentials to call Google APIs for
     server-to-server or local applications.

airflow/providers/google/firebase/hooks/firestore.py

@@ -65,7 +65,7 @@ class CloudFirestoreHook(GoogleBaseHook):
 
     def get_conn(self):
         """
-        Retrieves the connection to Cloud Firestore.
+        Retrieve the connection to Cloud Firestore.
 
         :return: Google Cloud Firestore services object.
         """
@@ -86,7 +86,7 @@ class CloudFirestoreHook(GoogleBaseHook):
         self, body: dict, database_id: str = "(default)", project_id: str | None = None
     ) -> None:
         """
-        Starts a export with the specified configuration.
+        Start a export with the specified configuration.
 
         :param database_id: The Database ID.
         :param body: The request body.
@@ -110,7 +110,7 @@ class CloudFirestoreHook(GoogleBaseHook):
 
     def _wait_for_operation_to_complete(self, operation_name: str) -> None:
         """
-        Waits for the named operation to complete - checks status of the asynchronous call.
+        Wait for the named operation to complete - checks status of the asynchronous call.
 
         :param operation_name: The name of the operation.
         :return: The response returned by the operation.

airflow/providers/google/get_provider_info.py

@@ -28,8 +28,9 @@ def get_provider_info():
         "name": "Google",
         "description": "Google services including:\n\n  - `Google Ads <https://ads.google.com/>`__\n  - `Google Cloud (GCP) <https://cloud.google.com/>`__\n  - `Google Firebase <https://firebase.google.com/>`__\n  - `Google LevelDB <https://github.com/google/leveldb/>`__\n  - `Google Marketing Platform <https://marketingplatform.google.com/>`__\n  - `Google Workspace <https://workspace.google.com/>`__ (formerly Google Suite)\n",
         "state": "ready",
-        "source-date-epoch": 1705912108,
+        "source-date-epoch": 1707636385,
         "versions": [
+            "10.15.0",
             "10.14.0",
             "10.13.1",
             "10.13.0",
@@ -92,7 +93,7 @@ def get_provider_info():
             "gcsfs>=2023.10.0",
             "google-ads>=22.1.0",
             "google-analytics-admin",
-            "google-api-core>=2.11.0",
+            "google-api-core>=2.11.0,!=2.16.0",
             "google-api-python-client>=1.6.0",
             "google-auth>=1.0.0",
             "google-auth-httplib2>=0.0.1",
@@ -1215,6 +1216,10 @@ def get_provider_info():
                 "integration-name": "Google Cloud",
                 "python-modules": ["airflow.providers.google.cloud.triggers.cloud_batch"],
             },
+            {
+                "integration-name": "Google Vertex AI",
+                "python-modules": ["airflow.providers.google.cloud.triggers.vertex_ai"],
+            },
         ],
         "transfers": [
             {

airflow/providers/google/leveldb/hooks/leveldb.py

@@ -45,15 +45,15 @@ class LevelDBHook(BaseHook):
     conn_type = "leveldb"
     hook_name = "LevelDB"
 
-    def __init__(self, leveldb_conn_id: str = default_conn_name, **kwargs):
-        super().__init__(**kwargs)
+    def __init__(self, leveldb_conn_id: str = default_conn_name):
+        super().__init__()
         self.leveldb_conn_id = leveldb_conn_id
         self.connection = self.get_connection(leveldb_conn_id)
         self.db: plyvel.DB | None = None
 
     def get_conn(self, name: str = "/tmp/testdb/", create_if_missing: bool = False, **kwargs) -> DB:
         """
-        Creates `Plyvel DB <https://plyvel.readthedocs.io/en/latest/api.html#DB>`__.
+        Create `Plyvel DB <https://plyvel.readthedocs.io/en/latest/api.html#DB>`__.
 
         :param name: path to create database e.g. `/tmp/testdb/`)
         :param create_if_missing: whether a new database should be created if needed
@@ -66,7 +66,7 @@ class LevelDBHook(BaseHook):
         return self.db
 
     def close_conn(self) -> None:
-        """Closes connection."""
+        """Close connection."""
         db = self.db
         if db is not None:
             db.close()

airflow/providers/google/marketing_platform/hooks/analytics.py

@@ -17,9 +17,9 @@
 # under the License.
 from __future__ import annotations
 
-import warnings
 from typing import Any
 
+from deprecated import deprecated
 from googleapiclient.discovery import Resource, build
 from googleapiclient.http import MediaFileUpload
 
@@ -27,18 +27,15 @@ from airflow.exceptions import AirflowProviderDeprecationWarning
 from airflow.providers.google.common.hooks.base_google import GoogleBaseHook
 
 
+@deprecated(
+    reason="The `GoogleAnalyticsHook` class is deprecated, please use `GoogleAnalyticsAdminHook` instead.",
+    category=AirflowProviderDeprecationWarning,
+)
 class GoogleAnalyticsHook(GoogleBaseHook):
     """Hook for Google Analytics 360."""
 
     def __init__(self, api_version: str = "v3", *args, **kwargs):
         super().__init__(*args, **kwargs)
-        warnings.warn(
-            f"The `{type(self).__name__}` class is deprecated, please use "
-            f"`GoogleAnalyticsAdminHook` instead.",
-            AirflowProviderDeprecationWarning,
-            stacklevel=2,
-        )
-
         self.api_version = api_version
         self._conn = None
 
@@ -58,7 +55,7 @@ class GoogleAnalyticsHook(GoogleBaseHook):
         return result
 
     def get_conn(self) -> Resource:
-        """Retrieves connection to Google Analytics 360."""
+        """Retrieve connection to Google Analytics 360."""
         if not self._conn:
             http_authorized = self._authorize()
             self._conn = build(
@@ -70,7 +67,7 @@ class GoogleAnalyticsHook(GoogleBaseHook):
         return self._conn
 
     def list_accounts(self) -> list[dict[str, Any]]:
-        """Lists accounts list from Google Analytics 360."""
+        """List accounts list from Google Analytics 360."""
         self.log.info("Retrieving accounts list...")
         conn = self.get_conn()
         accounts = conn.management().accounts()
@@ -81,7 +78,7 @@ class GoogleAnalyticsHook(GoogleBaseHook):
         self, account_id: str, web_property_id: str, web_property_ad_words_link_id: str
     ) -> dict[str, Any]:
         """
-        Returns a web property-Google Ads link to which the user has access.
+        Return a web property-Google Ads link to which the user has access.
 
         :param account_id: ID of the account which the given web property belongs to.
         :param web_property_id: Web property-Google Ads link UA-string.
@@ -105,7 +102,7 @@ class GoogleAnalyticsHook(GoogleBaseHook):
 
     def list_ad_words_links(self, account_id: str, web_property_id: str) -> list[dict[str, Any]]:
         """
-        Lists webProperty-Google Ads links for a given web property.
+        List webProperty-Google Ads links for a given web property.
 
         :param account_id: ID of the account which the given web property belongs to.
         :param web_property_id: Web property UA-string to retrieve the Google Ads links for.
@@ -128,7 +125,7 @@ class GoogleAnalyticsHook(GoogleBaseHook):
         resumable_upload: bool = False,
     ) -> None:
         """
-        Uploads file to GA via the Data Import API.
+        Upload file to GA via the Data Import API.
 
         :param file_location: The path and name of the file to upload.
         :param account_id: The GA account Id to which the data upload belongs.
@@ -165,7 +162,7 @@ class GoogleAnalyticsHook(GoogleBaseHook):
         delete_request_body: dict[str, Any],
     ) -> None:
         """
-        Deletes the uploaded data for a given account/property/dataset.
+        Delete the uploaded data for a given account/property/dataset.
 
         :param account_id: The GA account Id to which the data upload belongs.
         :param web_property_id: UA-string associated with the upload.

airflow/providers/google/marketing_platform/hooks/campaign_manager.py

@@ -49,7 +49,7 @@ class GoogleCampaignManagerHook(GoogleBaseHook):
         self.api_version = api_version
 
     def get_conn(self) -> Resource:
-        """Retrieves connection to Campaign Manager."""
+        """Retrieve connection to Campaign Manager."""
         if not self._conn:
             http_authorized = self._authorize()
             self._conn = build(
@@ -62,7 +62,7 @@ class GoogleCampaignManagerHook(GoogleBaseHook):
 
     def delete_report(self, profile_id: str, report_id: str) -> Any:
         """
-        Deletes a report by its ID.
+        Delete a report by its ID.
 
         :param profile_id: The DFA user profile ID.
         :param report_id: The ID of the report.
@@ -77,7 +77,7 @@ class GoogleCampaignManagerHook(GoogleBaseHook):
 
     def insert_report(self, profile_id: str, report: dict[str, Any]) -> Any:
         """
-        Creates a report.
+        Create  a report.
 
         :param profile_id: The DFA user profile ID.
         :param report: The report resource to be inserted.
@@ -99,7 +99,7 @@ class GoogleCampaignManagerHook(GoogleBaseHook):
         sort_order: str | None = None,
     ) -> list[dict]:
         """
-        Retrieves list of reports.
+        Retrieve  list of reports.
 
         :param profile_id: The DFA user profile ID.
         :param max_results: Maximum number of results to return.
@@ -125,7 +125,7 @@ class GoogleCampaignManagerHook(GoogleBaseHook):
 
     def patch_report(self, profile_id: str, report_id: str, update_mask: dict) -> Any:
         """
-        Updates a report. This method supports patch semantics.
+        Update  a report. This method supports patch semantics.
 
         :param profile_id: The DFA user profile ID.
         :param report_id: The ID of the report.
@@ -142,7 +142,7 @@ class GoogleCampaignManagerHook(GoogleBaseHook):
 
     def run_report(self, profile_id: str, report_id: str, synchronous: bool | None = None) -> Any:
         """
-        Runs a report.
+        Run a report.
 
         :param profile_id: The DFA profile ID.
         :param report_id: The ID of the report.
@@ -158,7 +158,7 @@ class GoogleCampaignManagerHook(GoogleBaseHook):
 
     def update_report(self, profile_id: str, report_id: str) -> Any:
         """
-        Updates a report.
+        Update a report.
 
         :param profile_id: The DFA user profile ID.
         :param report_id: The ID of the report.
@@ -173,7 +173,7 @@ class GoogleCampaignManagerHook(GoogleBaseHook):
 
     def get_report(self, file_id: str, profile_id: str, report_id: str) -> Any:
         """
-        Retrieves a report file.
+        Retrieve a report file.
 
         :param profile_id: The DFA user profile ID.
         :param report_id: The ID of the report.
@@ -190,7 +190,7 @@ class GoogleCampaignManagerHook(GoogleBaseHook):
 
     def get_report_file(self, file_id: str, profile_id: str, report_id: str) -> http.HttpRequest:
         """
-        Retrieves a media part of report file.
+        Retrieve a media part of report file.
 
         :param profile_id: The DFA user profile ID.
         :param report_id: The ID of the report.
@@ -234,7 +234,7 @@ class GoogleCampaignManagerHook(GoogleBaseHook):
         max_failed_inserts: int = 0,
     ) -> Any:
         """
-        Inserts conversions.
+        Insert conversions.
 
         :param profile_id: User profile ID associated with this request.
         :param conversions: Conversations to insert, should by type of Conversation:
@@ -278,7 +278,7 @@ class GoogleCampaignManagerHook(GoogleBaseHook):
         max_failed_updates: int = 0,
     ) -> Any:
         """
-        Updates existing conversions.
+        Update existing conversions.
 
         :param profile_id: User profile ID associated with this request.
         :param conversions: Conversations to update, should by type of Conversation: