async-amazon-ads-api-v1 0.3.0__tar.gz

async_amazon_ads_api_v1-0.3.0/.github/workflows/publish.yml

@@ -0,0 +1,43 @@
+name: Publish to PyPI
+
+on:
+  release:
+    types: [published]
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.13"
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v4
+
+      - name: Install dependencies
+        run: uv sync
+
+      - name: Build package
+        run: uv run hatchling build
+
+      - uses: actions/upload-artifact@v4
+        with:
+          name: dist
+          path: dist/
+
+  publish:
+    needs: build
+    runs-on: ubuntu-latest
+    environment: pypi
+    permissions:
+      id-token: write
+    steps:
+      - uses: actions/download-artifact@v4
+        with:
+          name: dist
+          path: dist/
+
+      - uses: pypa/gh-action-pypi-publish@release/v1

async_amazon_ads_api_v1-0.3.0/.gitignore

@@ -0,0 +1,34 @@
+# Claude Code settings（本地，不提交）
+.claude/
+
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+
+# Caches
+.mypy_cache/
+.ruff_cache/
+.pytest_cache/
+
+# IDE
+.idea/
+
+# Virtual environments
+.venv/
+venv/
+ENV/
+
+# uv.lock 由 uv 管理，需提交
+
+# OS
+.DS_Store
+*.swp
+*.swo
+
+# Distribution / build
+*.egg-info/
+dist/
+build/
+
+.dist/

async_amazon_ads_api_v1-0.3.0/AGENTS.md

@@ -0,0 +1,152 @@
+# Amazon Ads SDK
+
+Pure async Python SDK for the Amazon Advertising API — Sponsored Products / Sponsored Brands / Sponsored Display.
+
+## 项目结构
+
+```
+.
+├── scripts/
+│   ├── AmazonAdsAPISPMerged_prod_3p.json   # SP OpenAPI 规范（不修改）
+│   ├── AmazonAdsAPISBMerged_prod_3p.json   # SB OpenAPI 规范
+│   ├── AmazonAdsAPISDMerged_prod_3p.json   # SD OpenAPI 规范
+│   ├── download_spec.py                    # 下载 OpenAPI 规范
+│   ├── generate_all.py                     # 一键生成所有产品模型
+│   ├── generate_file_structure.py          # 通用 schema 分类器（无硬编码）
+│   └── generate_models.py                  # 从 JSON Schema 生成 Pydantic 模型
+├── README.md
+├── AGENTS.md                               # 本文件
+├── LICENSE                                 # MIT 许可证
+├── pyproject.toml                          # uv 项目配置
+├── uv.lock                                 # 依赖锁定
+└── src/async_amazon_ads_api_v1/
+    ├── __init__.py                         # 导出所有公开 API
+    ├── _base.py                            # ClientContext + _ResourceBase + _ResourceSpec
+    ├── errors.py                           # 共享 HTTP 错误模型 (ErrorCode, Error, ErrorsIndex ...)
+    ├── py.typed                            # PEP 561 类型标记
+    ├── config/
+    │   ├── __init__.py
+    │   ├── loader.py                       # from_toml() 配置加载
+    │   ├── region.py                       # Region 枚举 + ENDPOINT_MAP
+    │   ├── settings.py                     # AmazonAdsConfig / CacheBackend
+    │   ├── token_cache.py                  # BaseTokenCache / FileTokenCache / RedisTokenCache
+    │   └── token_manager.py               # TokenManager / TokenCredentials
+    ├── models/
+    │   ├── base.py
+    │   ├── sp/                             # SP 模型（自动生成）
+    │   ├── sb/                             # SB 模型（自动生成）
+    │   └── sd/                             # SD 模型（自动生成）
+    └── client/
+        ├── sp/                             # SPClient + 5 资源类
+        ├── sb/                             # SBClient + 11 资源类
+        └── sd/                             # SDClient + 4 资源类
+```
+
+## 项目概述
+
+核心使用 **httpx** 构建 Amazon Ads API 纯异步 SDK，支持三种广告产品。
+
+## 核心环境要求 (CRITICAL)
+
+- **环境管理**: **必须**使用 `uv` 进行依赖管理、虚拟环境创建及任务执行。
+- **Python 版本**:
+    - 最小支持版本为 **Python 3.13**。
+    - **优先兼容 Python 3.13+** 及后续更高版本。
+    - **禁止**考虑对 Python 3.12 及以下版本的向后兼容性。
+- **特性使用**: 鼓励使用 Python 3.13+ 引入的新特性。
+
+## 代码质量 (MUST)
+
+- **格式化**: 必须使用 `black` 格式化代码。
+- **静态检查**: 必须使用 `ruff check --fix` 移除未使用的 imports/variables。
+- 保存前执行这两条命令。
+
+## Git 提交规范
+
+- **语言**: `git commit` 信息尽量使用**中文**。
+- **术语**: 术语如 `uv`, `Python 3.14`, `asyncio`, `httpx`, `Pydantic` 等保持**英文**。
+- **格式示例**: `feat: 使用 uv 同步依赖，支持 Python 3.14 特性`
+
+## 常用命令
+
+- 同步环境: `uv sync`
+- 添加依赖: `uv add <package>`
+- 执行脚本: `uv run python <script>` — **禁止**直接使用 `python3` / `python` 调用 Python
+- 测试: `uv run pytest`
+- Lint: `uv run ruff check --fix src/`
+- 格式化: `uv run black src/ scripts/`
+- 类型检查: `uv run mypy src/`
+
+## 代码生成
+
+模型基于 OpenAPI 规范自动生成：
+
+```bash
+uv run python scripts/generate_models.py --product sp --output-dir src/async_amazon_ads_api_v1/models/sp/
+uv run python scripts/generate_models.py --product sb --output-dir src/async_amazon_ads_api_v1/models/sb/
+uv run python scripts/generate_models.py --product sd --output-dir src/async_amazon_ads_api_v1/models/sd/
+uv run ruff check --fix src/
+uv run black src/
+```
+
+- `generate_file_structure.py` 提供通用的图分类算法，不依赖硬编码
+- 每次修改上游 JSON Schema 后，重新运行生成脚本
+- 枚举使用 `StrEnum`，可选字段使用 Python 3.14 `X | None` 语法
+
+## 环境变量
+
+```bash
+AMAZON_ACCESS_TOKEN     # OAuth bearer token（必填，或使用 refresh_token 自动获取）
+AMAZON_CLIENT_ID        # OAuth client ID（使用 refresh_token 时必填）
+AMAZON_REFRESH_TOKEN    # OAuth refresh token（可选，用于自动续期）
+AMAZON_CLIENT_SECRET    # OAuth client secret（使用 refresh_token 时必填）
+AMAZON_REGION           # na | eu | fe（默认 na）
+AMAZON_PROFILE_ID       # 可选，数字类型
+AMAZON_TOKEN_URL        # 可选，自定义 token 端点
+AMAZON_TOKEN_CACHE_DIR  # 可选，token 缓存目录
+AMAZON_CACHE_BACKEND    # 可选，file | redis
+AMAZON_REDIS_URL        # 可选，Redis 连接 URL（使用 redis 缓存时需要）
+AMAZON_ENDPOINT_NA      # 可选，覆盖 NA 端点
+AMAZON_ENDPOINT_EU      # 可选，覆盖 EU 端点
+AMAZON_ENDPOINT_FE      # 可选，覆盖 FE 端点
+```
+
+## 使用示例
+
+```python
+from async_amazon_ads_api_v1 import AmazonAdsConfig, Region, SPClient, SBClient, SDClient
+
+config = AmazonAdsConfig(access_token="...", region=Region.NA)
+
+async with SPClient(config) as sp:
+    resp = await sp.campaigns.query({"stateFilter": {"include": ["enabled"]}})
+    print(resp.model_dump_json(indent=2))
+
+async with SBClient(config) as sb:
+    resp = await sb.campaigns.query({...})
+    resp = await sb.advertising_deals.query({...})
+
+async with SDClient(config) as sd:
+    resp = await sd.campaigns.query({...})
+```
+
+## 公开导出
+
+`__init__.py` 导出以下 API：
+
+```python
+from async_amazon_ads_api_v1 import (
+    AmazonAdsConfig,      # 核心配置
+    Region,               # 区域枚举 (NA/EU/FE)
+    CacheBackend,         # 缓存后端枚举 (FILE/REDIS)
+    SPClient,             # Sponsored Products 客户端
+    SBClient,             # Sponsored Brands 客户端
+    SDClient,             # Sponsored Display 客户端
+    TokenManager,         # OAuth token 生命周期管理
+    TokenCredentials,     # token 刷新凭据
+    BaseTokenCache,       # 缓存抽象基类
+    FileTokenCache,       # 文件缓存实现
+    RedisTokenCache,      # Redis 缓存实现
+    close_all_redis,      # 关闭所有 Redis 连接
+)
+```

async_amazon_ads_api_v1-0.3.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Amazon Ads
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

async_amazon_ads_api_v1-0.3.0/PKG-INFO

@@ -0,0 +1,197 @@
+Metadata-Version: 2.4
+Name: async-amazon-ads-api-v1
+Version: 0.3.0
+Summary: Pure async Amazon Ads API v1 client — Sponsored Products, Sponsored Brands, Sponsored Display
+Author: Amazon Ads
+License-Expression: MIT
+License-File: LICENSE
+Keywords: ads,advertising,amazon,api-v1,async,sponsored-brands,sponsored-display,sponsored-products
+Classifier: Development Status :: 4 - Beta
+Classifier: Framework :: AsyncIO
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Typing :: Typed
+Requires-Python: >=3.13
+Requires-Dist: httpx>=0.28.0
+Requires-Dist: pydantic>=2.10.0
+Provides-Extra: redis
+Requires-Dist: redis>=5.0.0; extra == 'redis'
+Description-Content-Type: text/markdown
+
+# async-amazon-ads-api-v1
+
+[![PyPI version](https://img.shields.io/pypi/v/async-amazon-ads-api-v1)](https://pypi.org/project/async-amazon-ads-api-v1/)
+[![Python versions](https://img.shields.io/pypi/pyversions/async-amazon-ads-api-v1)](https://pypi.org/project/async-amazon-ads-api-v1/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
+
+Pure async Amazon Ads API v1 client — Sponsored Products, Sponsored Brands, Sponsored Display.
+
+## Installation
+
+```bash
+pip install async-amazon-ads-api-v1
+# 或
+uv add async-amazon-ads-api-v1
+```
+
+Redis 缓存支持：
+
+```bash
+pip install "async-amazon-ads-api-v1[redis]"
+# 或
+uv add "async-amazon-ads-api-v1[redis]"
+```
+
+## Quick Start
+
+### 使用 Access Token（直接提供）
+
+```python
+import asyncio
+from async_amazon_ads_api_v1 import AmazonAdsConfig, Region, SPClient
+
+async def main():
+    config = AmazonAdsConfig(
+        access_token="your-access-token",
+        client_id="your-client-id",
+        region=Region.NA,
+    )
+
+    async with SPClient(config) as sp:
+        resp = await sp.campaigns.query({"stateFilter": {"include": ["enabled"]}})
+        print(resp.model_dump_json(indent=2))
+
+asyncio.run(main())
+```
+
+### 使用 Refresh Token（自动续期）
+
+```python
+import asyncio
+from async_amazon_ads_api_v1 import AmazonAdsConfig, Region, SPClient
+
+async def main():
+    config = AmazonAdsConfig(
+        access_token="your-access-token",   # 可选，提供后直接使用
+        client_id="your-client-id",
+        refresh_token="your-refresh-token", # access_token 过期后自动刷新
+        client_secret="your-client-secret",
+        region=Region.NA,
+    )
+
+    async with SPClient(config) as sp:
+        resp = await sp.campaigns.query({"stateFilter": {"include": ["enabled"]}})
+        print(resp.model_dump_json(indent=2))
+
+asyncio.run(main())
+```
+
+### 从环境变量加载
+
+```bash
+export AMAZON_ACCESS_TOKEN=...
+export AMAZON_CLIENT_ID=...
+export AMAZON_REFRESH_TOKEN=...     # 可选，用于自动续期
+export AMAZON_CLIENT_SECRET=...     # 可选，refresh_token 时需要
+export AMAZON_REGION=na             # na | eu | fe，默认 na
+export AMAZON_PROFILE_ID=...        # 可选
+```
+
+```python
+from async_amazon_ads_api_v1.config.loader import from_toml
+
+config = from_toml()
+```
+
+## Environment Variables
+
+| 变量 | 必填 | 说明 |
+|---|---|---|
+| `AMAZON_ACCESS_TOKEN` | 条件 | OAuth bearer token（或使用 refresh_token 自动获取） |
+| `AMAZON_CLIENT_ID` | 条件 | OAuth client ID（使用 refresh_token 时必填） |
+| `AMAZON_REFRESH_TOKEN` | 否 | OAuth refresh token，用于自动续期 |
+| `AMAZON_CLIENT_SECRET` | 条件 | OAuth client secret（使用 refresh_token 时必填） |
+| `AMAZON_REGION` | 否 | `na` \| `eu` \| `fe`，默认 `na` |
+| `AMAZON_PROFILE_ID` | 否 | 广告主 profile ID |
+| `AMAZON_TOKEN_URL` | 否 | 自定义 token 端点 |
+| `AMAZON_TOKEN_CACHE_DIR` | 否 | 文件缓存目录（默认系统临时目录） |
+| `AMAZON_CACHE_BACKEND` | 否 | `file` \| `redis`，默认 `file` |
+| `AMAZON_REDIS_URL` | 否 | Redis 连接 URL（使用 redis 缓存时需要） |
+| `AMAZON_ENDPOINT_NA` | 否 | 覆盖 NA 端点 |
+| `AMAZON_ENDPOINT_EU` | 否 | 覆盖 EU 端点 |
+| `AMAZON_ENDPOINT_FE` | 否 | 覆盖 FE 端点 |
+
+## Token Management
+
+SDK 内置 OAuth token 生命周期管理，支持自动续期和缓存：
+
+```python
+from async_amazon_ads_api_v1 import (
+    AmazonAdsConfig, Region,
+    TokenManager, TokenCredentials,
+    FileTokenCache, RedisTokenCache,
+)
+
+# 自动续期 + 文件缓存（默认）
+config = AmazonAdsConfig(
+    client_id="your-client-id",
+    client_secret="your-client-secret",
+    refresh_token="your-refresh-token",
+    region=Region.NA,
+)
+
+# 自动续期 + Redis 缓存
+config = AmazonAdsConfig(
+    client_id="your-client-id",
+    client_secret="your-client-secret",
+    refresh_token="your-refresh-token",
+    region=Region.NA,
+    cache_backend="redis",
+    redis_url="redis://localhost:6379",
+)
+```
+
+## API Reference
+
+### `SPClient` — Sponsored Products
+
+| 资源 | 方法 |
+|---|---|
+| `client.campaigns` | `create()`, `query()`, `update()`, `delete()` |
+| `client.ad_groups` | `create()`, `query()`, `update()`, `delete()` |
+| `client.ads` | `create()`, `query()`, `update()`, `delete()` |
+| `client.targets` | `create()`, `query()`, `update()`, `delete()` |
+| `client.ad_extensions` | `create()`, `query()`, `update()` |
+
+### `SBClient` — Sponsored Brands
+
+| 资源 | 方法 |
+|---|---|
+| `client.campaigns` | `create()`, `query()`, `update()`, `delete()` |
+| `client.ad_groups` | `create()`, `query()`, `update()`, `delete()` |
+| `client.ads` | `create()`, `query()`, `update()`, `delete()` |
+| `client.targets` | `create()`, `query()`, `update()`, `delete()` |
+| `client.ad_extensions` | `create()`, `query()`, `update()` |
+| `client.advertising_deals` | `create()`, `query()`, `update()`, `delete()` |
+| `client.advertising_deal_targets` | `create()`, `query()`, `delete()` |
+| `client.branded_keywords_pricings` | `create()` |
+| `client.keyword_reservation_validations` | `create()` |
+| `client.recommendations` | `create()` |
+| `client.recommendation_types` | `query()` |
+
+### `SDClient` — Sponsored Display
+
+| 资源 | 方法 |
+|---|---|
+| `client.campaigns` | `create()`, `query()`, `update()`, `delete()` |
+| `client.ad_groups` | `create()`, `query()`, `update()`, `delete()` |
+| `client.ads` | `create()`, `query()`, `update()`, `delete()` |
+| `client.targets` | `create()`, `query()`, `update()`, `delete()` |
+
+## License
+
+[MIT](LICENSE)

async_amazon_ads_api_v1-0.3.0/README.md

@@ -0,0 +1,173 @@
+# async-amazon-ads-api-v1
+
+[![PyPI version](https://img.shields.io/pypi/v/async-amazon-ads-api-v1)](https://pypi.org/project/async-amazon-ads-api-v1/)
+[![Python versions](https://img.shields.io/pypi/pyversions/async-amazon-ads-api-v1)](https://pypi.org/project/async-amazon-ads-api-v1/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
+
+Pure async Amazon Ads API v1 client — Sponsored Products, Sponsored Brands, Sponsored Display.
+
+## Installation
+
+```bash
+pip install async-amazon-ads-api-v1
+# 或
+uv add async-amazon-ads-api-v1
+```
+
+Redis 缓存支持：
+
+```bash
+pip install "async-amazon-ads-api-v1[redis]"
+# 或
+uv add "async-amazon-ads-api-v1[redis]"
+```
+
+## Quick Start
+
+### 使用 Access Token（直接提供）
+
+```python
+import asyncio
+from async_amazon_ads_api_v1 import AmazonAdsConfig, Region, SPClient
+
+async def main():
+    config = AmazonAdsConfig(
+        access_token="your-access-token",
+        client_id="your-client-id",
+        region=Region.NA,
+    )
+
+    async with SPClient(config) as sp:
+        resp = await sp.campaigns.query({"stateFilter": {"include": ["enabled"]}})
+        print(resp.model_dump_json(indent=2))
+
+asyncio.run(main())
+```
+
+### 使用 Refresh Token（自动续期）
+
+```python
+import asyncio
+from async_amazon_ads_api_v1 import AmazonAdsConfig, Region, SPClient
+
+async def main():
+    config = AmazonAdsConfig(
+        access_token="your-access-token",   # 可选，提供后直接使用
+        client_id="your-client-id",
+        refresh_token="your-refresh-token", # access_token 过期后自动刷新
+        client_secret="your-client-secret",
+        region=Region.NA,
+    )
+
+    async with SPClient(config) as sp:
+        resp = await sp.campaigns.query({"stateFilter": {"include": ["enabled"]}})
+        print(resp.model_dump_json(indent=2))
+
+asyncio.run(main())
+```
+
+### 从环境变量加载
+
+```bash
+export AMAZON_ACCESS_TOKEN=...
+export AMAZON_CLIENT_ID=...
+export AMAZON_REFRESH_TOKEN=...     # 可选，用于自动续期
+export AMAZON_CLIENT_SECRET=...     # 可选，refresh_token 时需要
+export AMAZON_REGION=na             # na | eu | fe，默认 na
+export AMAZON_PROFILE_ID=...        # 可选
+```
+
+```python
+from async_amazon_ads_api_v1.config.loader import from_toml
+
+config = from_toml()
+```
+
+## Environment Variables
+
+| 变量 | 必填 | 说明 |
+|---|---|---|
+| `AMAZON_ACCESS_TOKEN` | 条件 | OAuth bearer token（或使用 refresh_token 自动获取） |
+| `AMAZON_CLIENT_ID` | 条件 | OAuth client ID（使用 refresh_token 时必填） |
+| `AMAZON_REFRESH_TOKEN` | 否 | OAuth refresh token，用于自动续期 |
+| `AMAZON_CLIENT_SECRET` | 条件 | OAuth client secret（使用 refresh_token 时必填） |
+| `AMAZON_REGION` | 否 | `na` \| `eu` \| `fe`，默认 `na` |
+| `AMAZON_PROFILE_ID` | 否 | 广告主 profile ID |
+| `AMAZON_TOKEN_URL` | 否 | 自定义 token 端点 |
+| `AMAZON_TOKEN_CACHE_DIR` | 否 | 文件缓存目录（默认系统临时目录） |
+| `AMAZON_CACHE_BACKEND` | 否 | `file` \| `redis`，默认 `file` |
+| `AMAZON_REDIS_URL` | 否 | Redis 连接 URL（使用 redis 缓存时需要） |
+| `AMAZON_ENDPOINT_NA` | 否 | 覆盖 NA 端点 |
+| `AMAZON_ENDPOINT_EU` | 否 | 覆盖 EU 端点 |
+| `AMAZON_ENDPOINT_FE` | 否 | 覆盖 FE 端点 |
+
+## Token Management
+
+SDK 内置 OAuth token 生命周期管理，支持自动续期和缓存：
+
+```python
+from async_amazon_ads_api_v1 import (
+    AmazonAdsConfig, Region,
+    TokenManager, TokenCredentials,
+    FileTokenCache, RedisTokenCache,
+)
+
+# 自动续期 + 文件缓存（默认）
+config = AmazonAdsConfig(
+    client_id="your-client-id",
+    client_secret="your-client-secret",
+    refresh_token="your-refresh-token",
+    region=Region.NA,
+)
+
+# 自动续期 + Redis 缓存
+config = AmazonAdsConfig(
+    client_id="your-client-id",
+    client_secret="your-client-secret",
+    refresh_token="your-refresh-token",
+    region=Region.NA,
+    cache_backend="redis",
+    redis_url="redis://localhost:6379",
+)
+```
+
+## API Reference
+
+### `SPClient` — Sponsored Products
+
+| 资源 | 方法 |
+|---|---|
+| `client.campaigns` | `create()`, `query()`, `update()`, `delete()` |
+| `client.ad_groups` | `create()`, `query()`, `update()`, `delete()` |
+| `client.ads` | `create()`, `query()`, `update()`, `delete()` |
+| `client.targets` | `create()`, `query()`, `update()`, `delete()` |
+| `client.ad_extensions` | `create()`, `query()`, `update()` |
+
+### `SBClient` — Sponsored Brands
+
+| 资源 | 方法 |
+|---|---|
+| `client.campaigns` | `create()`, `query()`, `update()`, `delete()` |
+| `client.ad_groups` | `create()`, `query()`, `update()`, `delete()` |
+| `client.ads` | `create()`, `query()`, `update()`, `delete()` |
+| `client.targets` | `create()`, `query()`, `update()`, `delete()` |
+| `client.ad_extensions` | `create()`, `query()`, `update()` |
+| `client.advertising_deals` | `create()`, `query()`, `update()`, `delete()` |
+| `client.advertising_deal_targets` | `create()`, `query()`, `delete()` |
+| `client.branded_keywords_pricings` | `create()` |
+| `client.keyword_reservation_validations` | `create()` |
+| `client.recommendations` | `create()` |
+| `client.recommendation_types` | `query()` |
+
+### `SDClient` — Sponsored Display
+
+| 资源 | 方法 |
+|---|---|
+| `client.campaigns` | `create()`, `query()`, `update()`, `delete()` |
+| `client.ad_groups` | `create()`, `query()`, `update()`, `delete()` |
+| `client.ads` | `create()`, `query()`, `update()`, `delete()` |
+| `client.targets` | `create()`, `query()`, `update()`, `delete()` |
+
+## License
+
+[MIT](LICENSE)