Python

Google 提供 Python 用戶端程式庫，可用於與 Ad Manager API 互動。建議您搭配 PyPI 使用用戶端程式庫。

如要開始使用，請在所選 IDE 中建立新專案，或將依附元件新增至現有專案。Google 會將用戶端程式庫構件發布至 PyPI，並以 google-ads-admanager 的形式發布。

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 物件，其中包含每個 REST 方法的同步和非同步方法。以下範例會同步讀取 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="networks/[NETWORK_CODE]",
    )

    # 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。

記錄 HTTP 要求和回應

Python 用戶端程式庫會使用標準 Python logging 程式庫記錄 HTTP 要求和回應。根據預設，記錄功能會停用。

如要啟用記錄功能，請設定環境變數 GOOGLE_SDK_PYTHON_LOGGING_SCOPE。這個環境變數會設定處理等級 logging.DEBUG 以上記錄事件的方式。

# Log only Ad Manager API events
export GOOGLE_SDK_PYTHON_LOGGING_SCOPE=google.ads.admanager_v1

# Log all Google library events
export GOOGLE_SDK_PYTHON_LOGGING_SCOPE=google

或者，您也可以使用 Python logging 模組：

import logging

from google.ads import admanager_v1

logger = logging.getLogger("google.ads.admanager_v1")
logger.addHandler(logging.StreamHandler())
logger.setLevel(logging.DEBUG)

處理錯誤

所有 API 錯誤都會擴充基礎類別 GoogleAPIError。

錯誤原因欄位可用於識別錯誤類型。使用這個欄位來決定如何處理錯誤。

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

Ad Manager API 錯誤也會包含專屬的 requestId，您可以將這項資訊提供給支援團隊，協助排解問題。以下範例會從 GoogleAPIError 中擷取 requestId：

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'])

指定 Proxy 設定

Python 用戶端程式庫會遵循環境變數設定 http_proxy 和 https_proxy。