Google Ads API Python 客户端库使用教程
项目目录结构及介绍
Google Ads API Python 客户端库的项目目录结构如下:
google-ads-python/
├── google
│ └── ads
│ └── googleads
│ ├── common/
│ ├── errors/
│ ├── oauth2/
│ ├── services/
│ ├── util/
│ └── client.py
├── examples/
├── tests/
├── setup.py
├── README.md
└── requirements.txt
目录介绍
google/ads/googleads/
: 包含客户端库的核心代码。common/
: 包含通用工具和辅助函数。errors/
: 包含错误处理相关的代码。oauth2/
: 包含 OAuth2 认证相关的代码。services/
: 包含与 Google Ads API 服务交互的代码。util/
: 包含各种实用工具和辅助函数。client.py
: 客户端库的主入口文件。
examples/
: 包含使用客户端库的示例代码。tests/
: 包含测试代码。setup.py
: 用于安装项目的脚本。README.md
: 项目说明文档。requirements.txt
: 项目依赖文件。
项目启动文件介绍
项目的启动文件是 google/ads/googleads/client.py
。这个文件包含了客户端库的主要功能和初始化逻辑。
主要功能
- 初始化客户端对象。
- 配置认证信息。
- 提供与 Google Ads API 交互的方法。
示例代码
from google.ads.googleads.client import GoogleAdsClient
# 初始化客户端
client = GoogleAdsClient.load_from_storage()
# 使用客户端进行 API 调用
项目配置文件介绍
项目的配置文件通常是一个 YAML 或 JSON 文件,用于存储认证信息和 API 配置。
配置文件示例
# google-ads.yaml
developer_token: 'YOUR_DEVELOPER_TOKEN'
client_id: 'YOUR_CLIENT_ID'
client_secret: 'YOUR_CLIENT_SECRET'
refresh_token: 'YOUR_REFRESH_TOKEN'
login_customer_id: 'YOUR_LOGIN_CUSTOMER_ID'
配置文件加载
from google.ads.googleads.client import GoogleAdsClient
# 从配置文件加载客户端
client = GoogleAdsClient.load_from_storage('path/to/google-ads.yaml')
通过以上步骤,您可以成功配置和启动 Google Ads API Python 客户端库,并开始进行 API 调用。