はじめる

アド マネージャー データを読み取り、レポートを作成するには、Google Ad Manager REST API を使用します。

簡単に始められるように、Google では Java 用のクライアント ライブラリを提供しています。 他の言語にも対応予定です。最初の API リクエストを行う手順は次のとおりです。

アド マネージャー ネットワークへのアクセス権を取得する

まだお持ちでない場合は アド マネージャーに申し込む あります。

Ad Manager API を有効にする

[ Ad Manager API を使用する Google API Console プロジェクト。

認証

すべての API リクエストは、OAuth2 を使用して認証する必要があります。

アド マネージャー REST API クライアント ライブラリは、 アプリケーションのデフォルト認証情報。これらを設定するには、 環境変数や （gcloud の手順に沿って操作します）

サービス アカウント

export GOOGLE_APPLICATION_CREDENTIALS=/path/to/keyfile.json

ユーザー認証情報

gcloud auth application-default login --scopes="https://www.googleapis.com/auth/admanager"
# End user credentials must specify the cloud project where the API is enabled.
gcloud auth application-default set-quota-project PROJECT_ID

クライアント ライブラリを設定する

Java

Maven の場合:

<!-- pom.xml -->
<dependency>
   <groupId>com.google.api-ads</groupId>
   <artifactId>ad-manager</artifactId>
   <version>0.1.0</version>
</dependency>

Gradle の場合:

implementation 'com.google.api-ads:ad-manager:0.1.0'

Python

PyPi からクライアント ライブラリをインストールします。

pip install google-ads-admanager

最初のリクエストを行う

Java

import com.google.ads.admanager.v1.GetNetworkRequest;
import com.google.ads.admanager.v1.Network;
import com.google.ads.admanager.v1.NetworkName;
import com.google.ads.admanager.v1.NetworkServiceClient;

public class SyncGetNetwork {

   public static void main(String[] args) throws Exception {
      syncGetNetwork();
   }

   public static void syncGetNetwork() throws Exception {
      try (NetworkServiceClient networkServiceClient = NetworkServiceClient.create()) {
         GetNetworkRequest request =
            GetNetworkRequest.newBuilder()
               .setName(NetworkName.of("NETWORK_CODE").toString())
               .build();
         Network response = networkServiceClient.getNetwork(request);
      }
   }
}

その他の例については、GitHub をご覧ください。

Python

from google.ads import admanager

client = admanager.NetworkServiceClient()

request = admanager.GetNetworkRequest(
     name="networks/NETWORK_CODE",
)

response = client.get_network(request=request)

print(response)

その他の例については、GitHub をご覧ください。

cURL

curl -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
 https://admanager.googleapis.com/v1/networks/NETWORK_CODE