開始使用

使用 Google Ad Manager REST API 讀取您的 Ad Manager 資料並執行報表。

為了協助您踏出第一步，我們提供了 Java 的用戶端程式庫，以及敬請期待！如要提出第一個 API 要求，請按照下列步驟操作。

取得 Ad Manager 聯播網的存取權

如果您還沒有帳戶申請 Ad Manager 讓他們使用服務帳戶

啟用 Ad Manager API

啟用 Ad Manager API Google API 控制台專案。

驗證

所有 API 要求都必須使用 OAuth2 進行驗證。

Ad Manager 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