Python

Google 提供了一个用于与 Ad Manager API 进行交互的 Python 客户端库。 我们建议将客户端库与 PyPI 搭配使用。

首先，在您选择的 IDE 中创建一个新项目，或将 现有项目依赖项Google 将客户端库工件发布到 以 google-ads-admanager 形式指定 PyPI。

pip install google-ads-admanager

配置凭据

Python 客户端库使用 OAuth2 和应用默认凭据 (ADC) 进行身份验证。

ADC 会按顺序在以下位置搜索凭据：

  1. GOOGLE_APPLICATION_CREDENTIALS 环境变量。
  2. 通过 Google Cloud CLI (gcloud CLI) 设置的用户凭据。
  3. 在 Google Cloud 上运行时，是指关联到 Google Cloud 资源的服务账号。

如需了解如何创建和配置 ADC 凭据，请参阅 身份验证。

发出第一个请求

每项服务都有一个同时包含同步和异步数据的 ServiceClient 对象 方法。以下示例读取了一个 Network 。

from google.ads import admanager_v1


def sample_get_network():
    # Create a client
    client = admanager_v1.NetworkServiceClient()

    # Initialize request argument(s)
    request = admanager_v1.GetNetworkRequest(
        name="name_value",
    )

    # Make the request
    response = client.get_network(request=request)

    # Handle the response
    print(response)
admanager_v1_generated_network_service_get_network_sync.py

如需查看其他方法和资源的示例，请参阅 GitHub 代码库 googleapis/google-cloud-python。

处理错误

所有 API 错误都会扩展基类 GoogleAPIError。

错误原因字段唯一标识错误类型。使用 以确定如何处理错误。

try:
  network = client.get_network(request=request)
  print(network)
except GoogleAPIError as e:
  # Handle error
  print(e.reason)

Ad Manager API 错误还包含一个唯一的 requestId，您可以 向支持团队提供以下方面的帮助： 问题排查。以下示例提取了 requestId（来自 GoogleAPIError）；

except GoogleAPIError as e:
  requestInfoType = "type.googleapis.com/google.rpc.RequestInfo"
  requestInfo = [detail for detail in e.details if detail['@type'] == requestInfoType][0]
  print(requestInfo['requestId'])

配置代理设置

Python 客户端库遵循环境变量设置 http_proxy 和https_proxy。