feat(youtube): add garf-youtube library

Combine youtube-reporting-api and youtube-data-api into one library

Author: AndreyMarkinPPC

.github/workflows/test_garf_youtube_data_api.yaml

@@ -1,11 +1,11 @@
-name: Run e2e tests for garf-youtube-data-api
+name: Run tests for garf-youtube
 
 on:
   workflow_dispatch:
   pull_request:
     branches: [main]
     paths:
-      - 'libs/community/google/youtube/youtube-data-api/**'
+      - 'libs/community/google/youtube/**'
 
 env:
   UV_SYSTEM_PYTHON: 1
@@ -26,14 +26,24 @@ jobs:
           enable-cache: true
       - name: Install dependencies
         run: |
-          uv pip install pytest python-dotenv
-      - name: Test ${{ matrix.library }}
+      - name: Run unit tests
         run: |
           uv pip install -e libs/core/.[all]
           uv pip install -e libs/io/.[test,all]
           uv pip install -e libs/executors/.[all]
-          cd libs/community/google/youtube/youtube-data-api/
-          uv pip install -e .
+          cd libs/community/google/youtube/
+          uv pip install -e .[test]
+          pytest tests/unit
+        env:
+          GARF_YOUTUBE_DATA_API_KEY: ${{ secrets.GARF_YOUTUBE_DATA_API_KEY }}
+          YOUTUBE_ID: ${{ secrets.YOUTUBE_ID }}
+      - name: Run end-to-end tests
+        run: |
+          uv pip install -e libs/core/.[all]
+          uv pip install -e libs/io/.[test,all]
+          uv pip install -e libs/executors/.[all]
+          cd libs/community/google/youtube/
+          uv pip install -e .[test]
           pytest tests/e2e
         env:
           GARF_YOUTUBE_DATA_API_KEY: ${{ secrets.GARF_YOUTUBE_DATA_API_KEY }}

…oogle/youtube/youtube-data-api/README.md libs/community/google/youtube/README.mdlibs/community/google/youtube/youtube-data-api/README.md renamed to libs/community/google/youtube/README.md libs/community/google/youtube/youtube-data-api/README.md renamed to libs/community/google/youtube/README.md

@@ -7,20 +7,39 @@
 
 ## Prerequisites
 
+### YouTube Data API
+
 * [YouTube Data API](https://console.cloud.google.com/apis/library/youtube.googleapis.com) enabled.
 * [API key](https://support.google.com/googleapi/answer/6158862?hl=en) to access to access YouTube Data API.
     > Once generated expose API key as `export GARF_YOUTUBE_DATA_API_KEY=<YOUR_API_KEY>`
 
+### YouTube Reporting API
+* [YouTube Reporting API](https://console.cloud.google.com/apis/library/youtubereporting.googleapis.com) enabled.
+* [Client ID, client secret](https://support.google.com/cloud/answer/6158849?hl=en) and refresh token generated. \
+    > Please note you'll need to use another OAuth2 credentials type - *Web application*, and set "https://developers.google.com/oauthplayground" as redirect url in it.
+* Refresh token. You can use [OAuth Playground](https://developers.google.com/oauthplayground/) to generate refresh token.
+    * Select `https://www.googleapis.com/auth/yt-analytics.readonly` scope
+    * Enter OAuth Client ID and OAuth Client secret under *Use your own OAuth credentials*;
+    * Click on *Authorize APIs*
+
+* Expose client id,  client secret and refresh token as environmental variables:
+
+```
+export GARF_YOUTUBE_REPORTING_API_CLIENT_ID=
+export GARF_YOUTUBE_REPORTING_API_CLIENT_SECRET=
+export GARF_YOUTUBE_REPORTING_API_REFRESH_TOKEN=
+```
+
 ## Installation
 
-`pip install garf-youtube-data-api`
+`pip install garf-youtube`
 
 ## Usage
 
 ### Run as a library
 ```
-from garf_youtube_data_api import report_fetcher
-from garf_io import writer
+from garf.community.google.youtube import report_fetcher
+from garf.io import writer
 
 
 # Specify query
@@ -37,7 +56,7 @@ console_writer = writer.create_writer('console')
 console_writer.write(fetched_report, 'output')
 ```
 
-Learn [more](https://google.github.io/garf/fetchers/youtube-data-api/#python) on library usage.
+Learn [more](https://google.github.io/garf/fetchers/youtube/#python) on library usage.
 
 ### Run via CLI
 
@@ -53,13 +72,13 @@ where:
 
 * `<PATH_TO_QUERIES>` - local or remove files containing queries
 * `<OUTPUT_TYPE>` - output supported by [`garf-io` library](https://google.github.io/garf/usage/writers/).
-* `<SOURCE_PARAMETER=VALUE` - key-value pairs to refine fetching, check [available source parameters](https://google.github.io/garf/fetchers/youtube-data-api/#available-source-parameters).
+* `<SOURCE_PARAMETER=VALUE` - key-value pairs to refine fetching, check [available source parameters](https://google.github.io/garf/fetchers/youtube/#available-source-parameters).
 
-Learn [more](https://google.github.io/garf/fetchers/youtube-data-api/#cli) on CLI usage.
+Learn [more](https://google.github.io/garf/fetchers/youtube/#cli) on CLI usage.
 
 ## Documentation
 
-You can find a documentation on `garf-youtube-data-api` [here](https://google.github.io/garf/fetchers/youtube-data-api/).
+You can find a documentation on `garf-youtube` [here](https://google.github.io/garf/fetchers/youtube/).
 
 ## Samples
 

…tube/youtube-data-api/examples/README.md …munity/google/youtube/examples/README.mdlibs/community/google/youtube/youtube-data-api/examples/README.md renamed to libs/community/google/youtube/examples/README.md libs/community/google/youtube/youtube-data-api/examples/README.md renamed to libs/community/google/youtube/examples/README.md

@@ -1,4 +1,4 @@
-# Example queries for `garf-youtube-data-api`
+# Example queries for `garf-youtube`
 
 Contains sample queries for everyone's reference.
 

…utube-data-api/examples/channel_info.sql …amples/youtube-data-api/channel_info.sqllibs/community/google/youtube/youtube-data-api/examples/channel_info.sql renamed to libs/community/google/youtube/examples/youtube-data-api/channel_info.sql libs/community/google/youtube/youtube-data-api/examples/channel_info.sql renamed to libs/community/google/youtube/examples/youtube-data-api/channel_info.sql

@@ -11,4 +11,4 @@ SELECT
   privacy_status,
   definition,
   caption
-FROM builtin.channelVideos
+FROM builtin.channelVideos