Python

Google は、Ad Manager API を操作するための Python クライアントライブラリを提供しています。PyPI のクライアントライブラリを使用することをおすすめします。

まず、お好みの IDE で新しいプロジェクトを作成するか、追加することもできます。Google はクライアントライブラリのアーティファクトを google-ads-admanager としての PyPI。

pip install google-ads-admanager

認証情報の構成

Python クライアントライブラリは、OAuth2 とアプリケーションのデフォルト認証情報（ADC）を使用して認証を行います。

ADC は、次の場所で認証情報を順番に検索します。

GOOGLE_APPLICATION_CREDENTIALS 環境変数。
Google Cloud CLI（gcloud CLI）で設定されたユーザー認証情報。
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="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 をご覧ください。

エラーを処理する

すべての 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'])

プロキシを構成する

Python クライアントライブラリは、環境変数の設定 http_proxy に従います。および https_proxy。