docs: add Bid Manager API documentation

* Add fetcher overview page
* Mention Bid Manager API in README

Author: AndreyMarkinPPC

README.md

@@ -25,6 +25,7 @@ and writes it virtually anywhere.
 * [YouTube Reporting API](https://google.github.io/garf/fetchers/youtube-reporting-api/)
 * [Google Analytics](https://google.github.io/garf/fetchers/google-analytics-api/)
 * [Google Merchant Center](https://google.github.io/garf/fetchers/merchant-center-api/)
+* [Bid Manager](https://google.github.io/garf/fetchers/bid-manager/)
 
 
 ## Installation

docs/fetchers/bid-manager.md

@@ -0,0 +1,76 @@
+## garf for Bid Manager API
+
+Interacts with [Bid Manager API](https://developers.google.com/bid-manager).
+
+## Install
+
+Install `garf-bid-manager` library
+
+/// tab | pip
+```
+pip install garf-executors garf-bid-manager
+```
+///
+
+/// tab | uv
+```
+uv pip install garf-executors garf-bid-manager
+```
+///
+
+## Usage
+
+### Prerequisites
+
+* [Bid Manager API](https://console.cloud.google.com/apis/library/analytics.googleapis.com) enabled.
+* [Credentials](https://developers.google.com/bid-manager/guides/get-started/generate-credentials) configured, can be exposed  as `GARF_BID_MANAGER_CREDENTIALS_FILE` ENV variable
+
+/// tab | cli
+```bash
+echo """
+SELECT
+  advertiser,
+  metric_clicks AS clicks
+FROM standard
+WHERE advertiser = 1
+  AND dataRange = LAST_7_DAYS
+  " > query.sql
+garf query.sql --source bid-manager \
+  --output csv
+```
+///
+
+/// tab | python
+
+```python
+import os
+
+from garf_io import writer
+from garf_bid_manager import BidManagerApiReportFetcher
+
+query = """
+SELECT
+  advertiser,
+  metric_clicks AS clicks
+FROM standard
+WHERE advertiser = 1
+  AND dataRange = LAST_7_DAYS
+"""
+
+fetched_report = (
+  BidManagerApiReportFetcher(
+    credentials_file=os.getenv('GARF_BID_MANAGER_CREDENTIALS_FILE')
+  )
+  .fetch(query)
+)
+
+csv_writer = writer.create_writer('csv')
+csv_writer.write(fetched_report, 'query')
+```
+///
+
+###  Available source parameters
+
+| name | values| comments |
+|----- | ----- | -------- |
+| `credentials_file`   | File with Oauth or service account credentials | You can expose `credentials_file` as `GARF_BID_MANAGER_CREDENTIALS_FILE` ENV variable|

docs/fetchers/overview.md

@@ -0,0 +1,7 @@
+# Supported APIs
+
+* [YouTube Data API](youtube-data-api.md)
+* [YouTube Reporting API](youtube-reporting-api.md)
+* [Google Analytics](google-analytics-api.md)
+* [Google Merchant Center](merchant-center-api.md)
+* [Bid Manager](bid-manager.md)

mkdocs.yml

@@ -73,8 +73,10 @@ nav:
     - Create API response parser: development/create-api-response-parser.md
     - Create a library: development/create-garf-library.md
   - Fetchers:
+    - fetchers/overview.md
     - YouTube:
       - Data API: fetchers/youtube-data-api.md
       - Reporting API: fetchers/youtube-reporting-api.md
     - Merchant Center: fetchers/merchant-center-api.md
     - Google Analytics: fetchers/google-analytics-api.md
+    - Bid Manager: fetchers/bid-manager.md