スタートガイド

Google Ad Manager API(ベータ版)を使用して、アド マネージャーのデータを読み取り、レポートを作成します。

最初の API リクエストを行うには、次の操作を行います。

アド マネージャー ネットワークにアクセスする

アド マネージャー アカウントをまだお持ちでない場合は、登録します。

Ad Manager API を有効にする

Google API Console プロジェクトで Ad Manager API を有効にします。

認証

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

アド マネージャー API クライアント ライブラリは、アプリケーションのデフォルト認証情報から認証情報を読み取ります。これらは、環境変数または gcloud を使用して設定できます。

サービス アカウント

Linux または macOS

export GOOGLE_APPLICATION_CREDENTIALS=KEY_FILE_PATH

Windows

set GOOGLE_APPLICATION_CREDENTIALS=KEY_FILE_PATH

ユーザー認証情報

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

.NET

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

.NET CLI から:

dotnet add package Google.Ads.AdManager.V1 --version 1.0.0-beta01

パッケージ リファレンスとして:

<PackageReference Include="Google.Ads.AdManager.V1" Version="1.0.0-beta01" />

最初のリクエストを送信する

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 をご覧ください。 クライアント ライブラリの詳細については、Java ガイドをご覧ください。

Python

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 をご覧ください。 クライアント ライブラリの詳細については、Python ガイドをご覧ください。

.NET

    using Google.Ads.AdManager.V1;

    public sealed partial class GeneratedNetworkServiceClientSnippets
    {
        public void GetNetwork()
        {
            // Create client
            NetworkServiceClient networkServiceClient = NetworkServiceClient.Create();
            // Initialize request argument(s)
            string name = "networks/[NETWORK_CODE]";
            // Make the request
            Network response = networkServiceClient.GetNetwork(name);
        }
    }

その他の例については、GitHub をご覧ください。クライアント ライブラリの詳細については、.NET ガイドをご覧ください。

cURL

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