Python

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

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

pip install google-ads-admanager

認証情報の構成

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

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)

他のメソッドやリソースの例については、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