[youtube-data-api] Update YouTubeDataApiClient and YouTubeDataApiReportFetcher

* Raise exception when API key is not set or directly provided to YouTubeDataApiClient
* Pass YouTubeDataApiQuery to YouTubeDataApiReportFetcher to allow additional query customization
* Add common GarfYouTubeDataApiError in exceptions module

Author: AndreyMarkinPPC

libs/garf_community/youtube/garf_youtube_data_api/garf_youtube_data_api/__init__.py

@@ -24,4 +24,4 @@
   'YouTubeDataApiReportFetcher',
 ]
 
-__version__ = '0.0.5'
+__version__ = '0.0.6'

libs/garf_community/youtube/garf_youtube_data_api/garf_youtube_data_api/api_clients.py

@@ -18,17 +18,28 @@
 from googleapiclient.discovery import build
 from typing_extensions import override
 
-from garf_core import api_clients, query_editor
+from garf_core import api_clients, exceptions, query_editor
+
+
+class YouTubeDataApiClientError(exceptions.GarfYouTubeDataApiError):
+  """API client specific exception."""
 
 
 class YouTubeDataApiClient(api_clients.BaseClient):
+  """Handles fetching data form YouTube Data API."""
+
   def __init__(
     self,
     api_key: str = os.getenv('GOOGLE_API_KEY'),
     api_version: str = 'v3',
     **kwargs: str,
   ) -> None:
     """Initializes YouTubeDataApiClient."""
+    if not api_key:
+      raise YouTubeDataApiClientError(
+        'api_key is not found. Either pass to YouTubeDataApiClient as api_key '
+        'parameter or expose as GOOGLE_API_KEY ENV varible'
+      )
     self.api_key = api_key
     self.api_version = api_version
     self.api_key

libs/garf_community/youtube/garf_youtube_data_api/garf_youtube_data_api/exceptions.py

@@ -0,0 +1,19 @@
+# Copyright 2025 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
+#
+#     https://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.
+
+"""Defines common library exceptions."""
+
+
+class GarfYouTubeDataApiError(Exception):
+  """Base class for all library exceptions."""

libs/garf_community/youtube/garf_youtube_data_api/garf_youtube_data_api/report_fetcher.py

@@ -23,6 +23,7 @@
 from typing_extensions import override
 
 from garf_core import parsers, report, report_fetcher
+from garf_youtube_data_api import query_editor
 from garf_youtube_data_api.api_clients import YouTubeDataApiClient
 
 ALLOWED_FILTERS: Final[set[str]] = (
@@ -54,10 +55,13 @@ def __init__(
     self,
     api_client: YouTubeDataApiClient = YouTubeDataApiClient(),
     parser: parsers.BaseParser = parsers.NumericConverterDictParser,
+    query_spec: query_editor.YouTubeDataApiQuery = (
+      query_editor.YouTubeDataApiQuery
+    ),
     **kwargs: str,
   ) -> None:
     """Initializes YouTubeDataApiReportFetcher."""
-    super().__init__(api_client, parser, **kwargs)
+    super().__init__(api_client, parser, query_spec, **kwargs)
 
   @override
   def fetch(