入门

使用 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