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

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

@@ -45,7 +45,7 @@ class GoogleDisplayVideo360Hook(GoogleBaseHook):
         self.api_version = api_version
 
     def get_conn(self) -> Resource:
-        """Retrieves connection to DisplayVideo."""
+        """Retrieve connection to DisplayVideo."""
         if not self._conn:
             http_authorized = self._authorize()
             self._conn = build(
@@ -57,7 +57,7 @@ class GoogleDisplayVideo360Hook(GoogleBaseHook):
         return self._conn
 
     def get_conn_to_display_video(self) -> Resource:
-        """Retrieves connection to DisplayVideo."""
+        """Retrieve connection to DisplayVideo."""
         if not self._conn:
             http_authorized = self._authorize()
             self._conn = build(
@@ -89,7 +89,7 @@ class GoogleDisplayVideo360Hook(GoogleBaseHook):
 
     def create_query(self, query: dict[str, Any]) -> dict:
         """
-        Creates a query.
+        Create a query.
 
         :param query: Query object to be passed to request body.
         """
@@ -98,7 +98,7 @@ class GoogleDisplayVideo360Hook(GoogleBaseHook):
 
     def delete_query(self, query_id: str) -> None:
         """
-        Deletes a stored query as well as the associated stored reports.
+        Delete a stored query as well as the associated stored reports.
 
         :param query_id: Query ID to delete.
         """
@@ -106,7 +106,7 @@ class GoogleDisplayVideo360Hook(GoogleBaseHook):
 
     def get_query(self, query_id: str) -> dict:
         """
-        Retrieves a stored query.
+        Retrieve a stored query.
 
         :param query_id: Query ID to retrieve.
         """
@@ -114,13 +114,13 @@ class GoogleDisplayVideo360Hook(GoogleBaseHook):
         return response
 
     def list_queries(self) -> list[dict]:
-        """Retrieves stored queries."""
+        """Retrieve stored queries."""
         response = self.get_conn().queries().list().execute(num_retries=self.num_retries)
         return response.get("queries", [])
 
     def run_query(self, query_id: str, params: dict[str, Any] | None) -> dict:
         """
-        Runs a stored query to generate a report.
+        Run a stored query to generate a report.
 
         :param query_id: Query ID to run.
         :param params: Parameters for the report.
@@ -131,7 +131,7 @@ class GoogleDisplayVideo360Hook(GoogleBaseHook):
 
     def get_report(self, query_id: str, report_id: str) -> dict:
         """
-        Retrieves a report.
+        Retrieve a report.
 
         :param query_id: Query ID for which report was generated.
         :param report_id: Report ID to retrieve.
@@ -146,7 +146,7 @@ class GoogleDisplayVideo360Hook(GoogleBaseHook):
 
     def upload_line_items(self, line_items: Any) -> list[dict[str, Any]]:
         """
-        Uploads line items in CSV format.
+        Upload line items in CSV format.
 
         :param line_items: downloaded data from GCS and passed to the body request
         :return: response body.
@@ -167,7 +167,7 @@ class GoogleDisplayVideo360Hook(GoogleBaseHook):
 
     def download_line_items(self, request_body: dict[str, Any]) -> list[Any]:
         """
-        Retrieves line items in CSV format.
+        Retrieve line items in CSV format.
 
         :param request_body: dictionary with parameters that should be passed into.
             More information about it can be found here:
@@ -183,7 +183,7 @@ class GoogleDisplayVideo360Hook(GoogleBaseHook):
 
     def create_sdf_download_operation(self, body_request: dict[str, Any]) -> dict[str, Any]:
         """
-        Creates an SDF Download Task and Returns an Operation.
+        Create an SDF Download Task and Returns an Operation.
 
         :param body_request: Body request.
 
@@ -200,7 +200,7 @@ class GoogleDisplayVideo360Hook(GoogleBaseHook):
 
     def get_sdf_download_operation(self, operation_name: str):
         """
-        Gets the latest state of an asynchronous SDF download task operation.
+        Get the latest state of an asynchronous SDF download task operation.
 
         :param operation_name: The name of the operation resource.
         """
@@ -215,7 +215,7 @@ class GoogleDisplayVideo360Hook(GoogleBaseHook):
 
     def download_media(self, resource_name: str):
         """
-        Downloads media.
+        Download media.
 
         :param resource_name: of the media that is being downloaded.
         """

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

@@ -45,7 +45,7 @@ class GoogleSearchAdsHook(GoogleBaseHook):
         self.api_version = api_version
 
     def get_conn(self):
-        """Retrieves connection to Google SearchAds."""
+        """Retrieve connection to Google SearchAds."""
         if not self._conn:
             http_authorized = self._authorize()
             self._conn = build(
@@ -58,7 +58,7 @@ class GoogleSearchAdsHook(GoogleBaseHook):
 
     def insert_report(self, report: dict[str, Any]) -> Any:
         """
-        Inserts a report request into the reporting system.
+        Insert a report request into the reporting system.
 
         :param report: Report to be generated.
         """
@@ -67,7 +67,7 @@ class GoogleSearchAdsHook(GoogleBaseHook):
 
     def get(self, report_id: str) -> Any:
         """
-        Polls for the status of a report request.
+        Poll for the status of a report request.
 
         :param report_id: ID of the report request being polled.
         """
@@ -76,7 +76,7 @@ class GoogleSearchAdsHook(GoogleBaseHook):
 
     def get_file(self, report_fragment: int, report_id: str) -> Any:
         """
-        Downloads a report file encoded in UTF-8.
+        Download a report file encoded in UTF-8.
 
         :param report_fragment: The index of the report fragment to download.
         :param report_id: ID of the report.

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

@@ -19,10 +19,11 @@
 from __future__ import annotations
 
 import csv
-import warnings
 from tempfile import NamedTemporaryFile
 from typing import TYPE_CHECKING, Any, Sequence
 
+from deprecated import deprecated
+
 from airflow.exceptions import AirflowProviderDeprecationWarning
 from airflow.models import BaseOperator
 from airflow.providers.google.cloud.hooks.gcs import GCSHook
@@ -32,6 +33,13 @@ if TYPE_CHECKING:
     from airflow.utils.context import Context
 
 
+@deprecated(
+    reason=(
+        "The `GoogleAnalyticsListAccountsOperator` class is deprecated, please use "
+        "`GoogleAnalyticsAdminListAccountsOperator` instead."
+    ),
+    category=AirflowProviderDeprecationWarning,
+)
 class GoogleAnalyticsListAccountsOperator(BaseOperator):
     """
     Lists all accounts to which the user has access.
@@ -76,13 +84,6 @@ class GoogleAnalyticsListAccountsOperator(BaseOperator):
         impersonation_chain: str | Sequence[str] | None = None,
         **kwargs,
     ) -> None:
-        warnings.warn(
-            f"The `{type(self).__name__}` operator is deprecated, please use "
-            f"`GoogleAnalyticsAdminListAccountsOperator` instead.",
-            AirflowProviderDeprecationWarning,
-            stacklevel=2,
-        )
-
         super().__init__(**kwargs)
 
         self.api_version = api_version
@@ -99,6 +100,13 @@ class GoogleAnalyticsListAccountsOperator(BaseOperator):
         return result
 
 
+@deprecated(
+    reason=(
+        "The `GoogleAnalyticsGetAdsLinkOperator` class is deprecated, please use "
+        "`GoogleAnalyticsAdminGetGoogleAdsLinkOperator` instead."
+    ),
+    category=AirflowProviderDeprecationWarning,
+)
 class GoogleAnalyticsGetAdsLinkOperator(BaseOperator):
     """
     Returns a web property-Google Ads link to which the user has access.
@@ -149,12 +157,6 @@ class GoogleAnalyticsGetAdsLinkOperator(BaseOperator):
         **kwargs,
     ):
         super().__init__(**kwargs)
-        warnings.warn(
-            f"The `{type(self).__name__}` operator is deprecated, please use "
-            f"`GoogleAnalyticsAdminGetGoogleAdsLinkOperator` instead.",
-            AirflowProviderDeprecationWarning,
-            stacklevel=2,
-        )
 
         self.account_id = account_id
         self.web_property_ad_words_link_id = web_property_ad_words_link_id
@@ -177,6 +179,13 @@ class GoogleAnalyticsGetAdsLinkOperator(BaseOperator):
         return result
 
 
+@deprecated(
+    reason=(
+        "The `GoogleAnalyticsRetrieveAdsLinksListOperator` class is deprecated, please use "
+        "`GoogleAnalyticsAdminListGoogleAdsLinksOperator` instead."
+    ),
+    category=AirflowProviderDeprecationWarning,
+)
 class GoogleAnalyticsRetrieveAdsLinksListOperator(BaseOperator):
     """
     Lists webProperty-Google Ads links for a given web property.
@@ -224,12 +233,6 @@ class GoogleAnalyticsRetrieveAdsLinksListOperator(BaseOperator):
         **kwargs,
     ) -> None:
         super().__init__(**kwargs)
-        warnings.warn(
-            f"The `{type(self).__name__}` operator is deprecated, please use "
-            f"`GoogleAnalyticsAdminListGoogleAdsLinksOperator` instead.",
-            AirflowProviderDeprecationWarning,
-            stacklevel=2,
-        )
 
         self.account_id = account_id
         self.web_property_id = web_property_id
@@ -250,6 +253,13 @@ class GoogleAnalyticsRetrieveAdsLinksListOperator(BaseOperator):
         return result
 
 
+@deprecated(
+    reason=(
+        "The `GoogleAnalyticsDataImportUploadOperator` class is deprecated, please use "
+        "`GoogleAnalyticsAdminCreateDataStreamOperator` instead."
+    ),
+    category=AirflowProviderDeprecationWarning,
+)
 class GoogleAnalyticsDataImportUploadOperator(BaseOperator):
     """
     Take a file from Cloud Storage and uploads it to GA via data import API.
@@ -303,12 +313,6 @@ class GoogleAnalyticsDataImportUploadOperator(BaseOperator):
         impersonation_chain: str | Sequence[str] | None = None,
         **kwargs,
     ) -> None:
-        warnings.warn(
-            f"The `{type(self).__name__}` operator is deprecated, please use "
-            f"`GoogleAnalyticsAdminCreateDataStreamOperator` instead.",
-            AirflowProviderDeprecationWarning,
-            stacklevel=2,
-        )
         super().__init__(**kwargs)
         self.storage_bucket = storage_bucket
         self.storage_name_object = storage_name_object
@@ -356,6 +360,13 @@ class GoogleAnalyticsDataImportUploadOperator(BaseOperator):
             )
 
 
+@deprecated(
+    reason=(
+        "The `GoogleAnalyticsDeletePreviousDataUploadsOperator` class is deprecated, please use "
+        "`GoogleAnalyticsAdminDeleteDataStreamOperator` instead."
+    ),
+    category=AirflowProviderDeprecationWarning,
+)
 class GoogleAnalyticsDeletePreviousDataUploadsOperator(BaseOperator):
     """
     Deletes previous GA uploads to leave the latest file to control the size of the Data Set Quota.
@@ -395,12 +406,6 @@ class GoogleAnalyticsDeletePreviousDataUploadsOperator(BaseOperator):
         impersonation_chain: str | Sequence[str] | None = None,
         **kwargs,
     ) -> None:
-        warnings.warn(
-            f"The `{type(self).__name__}` operator is deprecated, please use "
-            f"`GoogleAnalyticsAdminDeleteDataStreamOperator` instead.",
-            AirflowProviderDeprecationWarning,
-            stacklevel=2,
-        )
         super().__init__(**kwargs)
 
         self.account_id = account_id

airflow/providers/google/suite/hooks/calendar.py

@@ -69,7 +69,7 @@ class GoogleCalendarHook(GoogleBaseHook):
 
     def get_conn(self) -> Any:
         """
-        Retrieves connection to Google Calendar.
+        Retrieve connection to Google Calendar.
 
         :return: Google Calendar services object.
         """
@@ -99,7 +99,7 @@ class GoogleCalendarHook(GoogleBaseHook):
         updated_min: datetime | None = None,
     ) -> list:
         """
-        Gets events from Google Calendar from a single calendar_id.
+        Get events from Google Calendar from a single calendar_id.
 
         https://developers.google.com/calendar/api/v3/reference/events/list
 

airflow/providers/google/suite/hooks/drive.py

@@ -64,7 +64,7 @@ class GoogleDriveHook(GoogleBaseHook):
 
     def get_conn(self) -> Any:
         """
-        Retrieves the connection to Google Drive.
+        Retrieve the connection to Google Drive.
 
         :return: Google Drive services object.
         """
@@ -132,7 +132,7 @@ class GoogleDriveHook(GoogleBaseHook):
 
     def get_media_request(self, file_id: str) -> HttpRequest:
         """
-        Returns a get_media http request to a Google Drive object.
+        Return a get_media http request to a Google Drive object.
 
         :param file_id: The Google Drive file id
         :return: request
@@ -145,7 +145,7 @@ class GoogleDriveHook(GoogleBaseHook):
         self, folder_id: str, file_name: str, drive_id: str | None = None, *, include_trashed: bool = True
     ) -> bool:
         """
-        Checks to see if a file exists within a Google Drive folder.
+        Check to see if a file exists within a Google Drive folder.
 
         :param folder_id: The id of the Google Drive folder in which the file resides
         :param file_name: The name of a file in Google Drive
@@ -162,7 +162,7 @@ class GoogleDriveHook(GoogleBaseHook):
 
     def _get_file_info(self, file_id: str):
         """
-        Returns Google API file_info object containing id, name, parents in the response.
+        Return Google API file_info object containing id, name, parents in the response.
 
         https://developers.google.com/drive/api/v3/reference/files/get
 
@@ -183,7 +183,7 @@ class GoogleDriveHook(GoogleBaseHook):
 
     def _resolve_file_path(self, file_id: str) -> str:
         """
-        Returns the full Google Drive path for given file_id.
+        Return the full Google Drive path for given file_id.
 
         :param file_id: The id of a file in Google Drive
         :return: Google Drive full path for a file
@@ -211,7 +211,7 @@ class GoogleDriveHook(GoogleBaseHook):
         self, folder_id: str, file_name: str, drive_id: str | None = None, *, include_trashed: bool = True
     ) -> dict:
         """
-        Returns the file id of a Google Drive file.
+        Return the file id of a Google Drive file.
 
         :param folder_id: The id of the Google Drive folder in which the file resides
         :param file_name: The name of a file in Google Drive
@@ -264,7 +264,7 @@ class GoogleDriveHook(GoogleBaseHook):
         show_full_target_path: bool = True,
     ) -> str:
         """
-        Uploads a file that is available locally to a Google Drive service.
+        Upload a file that is available locally to a Google Drive service.
 
         :param local_location: The path where the file is available.
         :param remote_location: The path where the file will be send

airflow/providers/google/suite/hooks/sheets.py

@@ -66,7 +66,7 @@ class GSheetsHook(GoogleBaseHook):
 
     def get_conn(self) -> Any:
         """
-        Retrieves connection to Google Sheets.
+        Retrieve connection to Google Sheets.
 
         :return: Google Sheets services object.
         """
@@ -85,7 +85,7 @@ class GSheetsHook(GoogleBaseHook):
         date_time_render_option: str = "SERIAL_NUMBER",
     ) -> list:
         """
-        Gets values from Google Sheet from a single range.
+        Get values from Google Sheet from a single range.
 
         https://developers.google.com/sheets/api/reference/rest/v4/spreadsheets.values/get
 
@@ -125,7 +125,7 @@ class GSheetsHook(GoogleBaseHook):
         date_time_render_option: str = "SERIAL_NUMBER",
     ) -> dict:
         """
-        Gets values from Google Sheet from a list of ranges.
+        Get values from Google Sheet from a list of ranges.
 
         https://developers.google.com/sheets/api/reference/rest/v4/spreadsheets.values/batchGet
 
@@ -168,7 +168,7 @@ class GSheetsHook(GoogleBaseHook):
         date_time_render_option: str = "SERIAL_NUMBER",
     ) -> dict:
         """
-        Updates values from Google Sheet from a single range.
+        Update values from Google Sheet from a single range.
 
         https://developers.google.com/sheets/api/reference/rest/v4/spreadsheets.values/update
 
@@ -219,7 +219,7 @@ class GSheetsHook(GoogleBaseHook):
         date_time_render_option: str = "SERIAL_NUMBER",
     ) -> dict:
         """
-        Updates values from Google Sheet for multiple ranges.
+        Update values from Google Sheet for multiple ranges.
 
         https://developers.google.com/sheets/api/reference/rest/v4/spreadsheets.values/batchUpdate
 
@@ -365,7 +365,7 @@ class GSheetsHook(GoogleBaseHook):
 
     def get_spreadsheet(self, spreadsheet_id: str):
         """
-        Retrieves spreadsheet matching the given id.
+        Retrieve spreadsheet matching the given id.
 
         :param spreadsheet_id: The spreadsheet id.
         :return: An spreadsheet that matches the sheet filter.
@@ -380,7 +380,7 @@ class GSheetsHook(GoogleBaseHook):
 
     def get_sheet_titles(self, spreadsheet_id: str, sheet_filter: list[str] | None = None):
         """
-        Retrieves the sheet titles from a spreadsheet matching the given id and sheet filter.
+        Retrieve the sheet titles from a spreadsheet matching the given id and sheet filter.
 
         :param spreadsheet_id: The spreadsheet id.
         :param sheet_filter: List of sheet title to retrieve from sheet.
@@ -401,7 +401,7 @@ class GSheetsHook(GoogleBaseHook):
 
     def create_spreadsheet(self, spreadsheet: dict[str, Any]) -> dict[str, Any]:
         """
-        Creates a spreadsheet, returning the newly created spreadsheet.
+        Create a spreadsheet, returning the newly created spreadsheet.
 
         :param spreadsheet: an instance of Spreadsheet
             https://developers.google.com/sheets/api/reference/rest/v4/spreadsheets#Spreadsheet

{apache_airflow_providers_google-10.14.0rc1.dist-info → apache_airflow_providers_google-10.15.0rc1.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: apache-airflow-providers-google
-Version: 10.14.0rc1
+Version: 10.15.0rc1
 Summary: Provider package apache-airflow-providers-google for Apache Airflow
 Keywords: airflow-provider,google,airflow,integration
 Author-email: Apache Software Foundation <dev@airflow.apache.org>
@@ -30,7 +30,7 @@ Requires-Dist: gcloud-aio-storage>=9.0.0
 Requires-Dist: gcsfs>=2023.10.0
 Requires-Dist: google-ads>=22.1.0
 Requires-Dist: google-analytics-admin
-Requires-Dist: google-api-core>=2.11.0
+Requires-Dist: google-api-core>=2.11.0,!=2.16.0
 Requires-Dist: google-api-python-client>=1.6.0
 Requires-Dist: google-auth-httplib2>=0.0.1
 Requires-Dist: google-auth>=1.0.0
@@ -99,8 +99,8 @@ Requires-Dist: apache-airflow-providers-sftp ; extra == "sftp"
 Requires-Dist: apache-airflow-providers-ssh ; extra == "ssh"
 Requires-Dist: apache-airflow-providers-trino ; extra == "trino"
 Project-URL: Bug Tracker, https://github.com/apache/airflow/issues
-Project-URL: Changelog, https://airflow.apache.org/docs/apache-airflow-providers-google/10.14.0/changelog.html
-Project-URL: Documentation, https://airflow.apache.org/docs/apache-airflow-providers-google/10.14.0
+Project-URL: Changelog, https://airflow.apache.org/docs/apache-airflow-providers-google/10.15.0/changelog.html
+Project-URL: Documentation, https://airflow.apache.org/docs/apache-airflow-providers-google/10.15.0
 Project-URL: Slack Chat, https://s.apache.org/airflow-slack
 Project-URL: Source Code, https://github.com/apache/airflow
 Project-URL: Twitter, https://twitter.com/ApacheAirflow
@@ -168,7 +168,7 @@ Provides-Extra: trino
 
 Package ``apache-airflow-providers-google``
 
-Release: ``10.14.0.rc1``
+Release: ``10.15.0.rc1``
 
 
 Google services including:
@@ -188,7 +188,7 @@ This is a provider package for ``google`` provider. All classes for this provide
 are in ``airflow.providers.google`` python package.
 
 You can find package information and changelog for the provider
-in the `documentation <https://airflow.apache.org/docs/apache-airflow-providers-google/10.14.0/>`_.
+in the `documentation <https://airflow.apache.org/docs/apache-airflow-providers-google/10.15.0/>`_.
 
 Installation
 ------------
@@ -202,9 +202,9 @@ The package supports the following python versions: 3.8,3.9,3.10,3.11
 Requirements
 ------------
 
-=======================================  ==================
+=======================================  =====================
 PIP package                              Version required
-=======================================  ==================
+=======================================  =====================
 ``apache-airflow``                       ``>=2.6.0``
 ``apache-airflow-providers-common-sql``  ``>=1.7.2``
 ``asgiref``                              ``>=3.5.2``
@@ -214,7 +214,7 @@ PIP package                              Version required
 ``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``
@@ -264,7 +264,7 @@ PIP package                              Version required
 ``PyOpenSSL``
 ``sqlalchemy-bigquery``                  ``>=1.2.1``
 ``sqlalchemy-spanner``                   ``>=1.6.2``
-=======================================  ==================
+=======================================  =====================
 
 Cross provider package dependencies
 -----------------------------------
@@ -302,4 +302,4 @@ Dependent package
 ========================================================================================================================  ====================
 
 The changelog for the provider package can be found in the
-`changelog <https://airflow.apache.org/docs/apache-airflow-providers-google/10.14.0/changelog.html>`_.
+`changelog <https://airflow.apache.org/docs/apache-airflow-providers-google/10.15.0/changelog.html>`_.