Python

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

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

pip install google-ads-admanager

認証情報の構成

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

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="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 もあり、その場合はサポートに提供し、トラブルシューティングを行います次の例では 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。