Python连接Google Ads API遇阻，求基于YAML凭证的连接指导

1. 安装依赖 #

先确保安装官方的Google Ads Python库：

pip install google-ads

2. 配置YAML凭证文件 #

创建google-ads.yaml文件，把你的凭证按以下格式填入（替换为实际值）：

developer_token: "你的_DEVELOPER_TOKEN"
client_id: "你的_CLIENT_ID"  # 和CLIENT_SECRET配对的OAuth客户端ID
client_secret: "你的_CLIENT_SECRET"
refresh_token: "你的_REFRESH_TOKEN"
login_customer_id: "你的_CUSTOMER_ID"  # 格式必须为 xxx-xxx-xxxx（带横杠）

若你是从JSON密钥文件获取的CLIENT_SECRET，直接提取文件内client_secret字段的值填入即可。

3. 最简连接测试脚本 #

用极简脚本验证连接，避开官方示例的冗余代码：

from google.ads.googleads.client import GoogleAdsClient
from google.ads.googleads.errors import GoogleAdsException

def main():
    try:
        # 加载YAML配置初始化客户端
        client = GoogleAdsClient.load_from_storage("google-ads.yaml")
        
        # 调用账户服务接口验证连接
        customer_service = client.get_service("CustomerService")
        customer = customer_service.get_customer(client_id="你的_CUSTOMER_ID")
        
        print(f"连接成功！账户名称：{customer.descriptive_name}，状态：{customer.status}")
    except GoogleAdsException as ex:
        print(f"连接失败，错误信息：")
        for error in ex.failure.errors:
            print(f"错误代码：{error.error_code}，描述：{error.message}")

if __name__ == "__main__":
    main()

脚本里的你的_CUSTOMER_ID要和YAML文件中的格式保持一致。

4. 常见问题排查 #

• Customer ID格式错误：必须使用xxx-xxx-xxxx格式，纯数字会触发认证失败。
• Refresh Token失效：长时间未使用或权限变更时，需重新生成Refresh Token。
• Developer Token权限：确认你的Developer Token已通过Google Ads权限审核并处于启用状态。
• YAML格式错误：YAML对格式敏感，用空格缩进而非Tab，检查引号是否配对。

内容的提问来源于stack exchange，提问作者Francisco Eljuri