【亲测免费】 Google Ads Python 客户端库使用教程

1. 项目目录结构及介绍

Google Ads Python 客户端库的目录结构如下：

googleads-python-lib/
├── examples/
│   ├── ad_manager/
│   └── ad_manager/
├── googleads/
├── tests/
├── CONTRIBUTING.md
├── ChangeLog
├── LICENSE
├── README.md
├── googleads.yaml
└── setup.py

目录结构介绍

• examples/: 包含示例代码，帮助用户快速上手使用 Google Ads API。
  • ad_manager/: 包含与 Google Ad Manager API 相关的示例代码。
• googleads/: 包含客户端库的核心代码，提供了与 Google Ads API 交互的功能。
• tests/: 包含单元测试代码，用于验证客户端库的功能。
• CONTRIBUTING.md: 贡献指南，指导开发者如何为项目贡献代码。
• ChangeLog: 记录项目的变更历史。
• LICENSE: 项目的开源许可证，采用 Apache-2.0 许可证。
• README.md: 项目的介绍文档，包含安装和使用说明。
• googleads.yaml: 配置文件，用于存储 OAuth2 凭证和其他设置。
• setup.py: 项目的安装脚本，用于安装客户端库及其依赖项。

2. 项目启动文件介绍

项目的启动文件主要是 setup.py，它负责安装客户端库及其依赖项。用户可以通过以下命令安装客户端库：

$ pip install googleads

或者，用户可以下载项目的源代码，然后通过以下命令手动安装：

$ python setup.py build install

3. 项目的配置文件介绍

项目的配置文件是 googleads.yaml，它用于存储 OAuth2 凭证和其他设置。用户需要将此文件复制到主目录中，并根据需要填写相关字段。

配置文件示例

# OAuth2 设置
oauth2:
  client_id: 'your_client_id'
  client_secret: 'your_client_secret'
  refresh_token: 'your_refresh_token'

# Ad Manager 设置
ad_manager:
  application_name: 'your_application_name'
  network_code: 'your_network_code'

配置文件的使用

用户可以通过以下代码加载配置文件：

from googleads import ad_manager

# 使用默认位置 - 主目录
ad_manager_client = ad_manager.AdManagerClient.LoadFromStorage()

# 或者，传递配置文件的路径
ad_manager_client = ad_manager.AdManagerClient.LoadFromStorage('C:\\My\\Directory\\googleads.yaml')

通过配置文件，用户可以方便地管理 OAuth2 凭证和其他设置，从而简化与 Google Ads API 的交互过程。