本頁面由 Cloud Translation API 翻譯而成。

開始使用

使用 Google Ad Manager API (Beta 版) 讀取 Ad Manager 資料並執行報表。

如要提出第一個 API 要求，請完成下列步驟：

取得 Ad Manager 聯播網存取權

如果您還沒有 Ad Manager 帳戶，請註冊。

啟用 Ad Manager API

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

驗證

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

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

PHP

從 Composer 安裝用戶端程式庫。

composer require googleads/ad-manager

Ruby

從 RubyGems 安裝用戶端程式庫。

Gemfile：

gem 'google-ads-ad_manager', '~> 0.2.0'

安裝：

gem install google-ads-ad_manager

Node.js

從 npm 安裝用戶端程式庫。

使用指令列：

npm install @google-ads/admanager

做為套件參考資料：

// package.json
"dependencies": {
  "@google-ads/admanager": "^0.1.0"
}

提出第一個要求

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);
    }
  }
}SyncGetNetwork.java

如需更多範例，請前往 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="networks/NETWORK_CODE",
    )

    # Make the request
    response = client.get_network(request=request)

    # Handle the response
    print(response)admanager_v1_generated_network_service_get_network_sync.py

如需更多範例，請前往 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);
    }
}NetworkServiceClient.GetNetworkSnippet.g.cs

如需更多範例，請前往 GitHub。如需其他用戶端程式庫資訊，請參閱 .NET 指南。

PHP

<?php

use Google\Ads\AdManager\V1\Client\NetworkServiceClient;
use Google\Ads\AdManager\V1\GetNetworkRequest;
use Google\Ads\AdManager\V1\Network;
use Google\ApiCore\ApiException;

/**
 * API to retrieve a Network object.
 *
 * @param string $formattedName Resource name of Network.
 *                              Format: networks/{network_code}
 *                              Please see {@see NetworkServiceClient::networkName()} for help formatting this field.
 */
function get_network_sample(string $formattedName): void
{
    // Create a client.
    $networkServiceClient = new NetworkServiceClient();

    // Prepare the request message.
    $request = (new GetNetworkRequest())
        ->setName($formattedName);

    // Call the API and handle any network failures.
    try {
        /** @var Network $response */
        $response = $networkServiceClient->getNetwork($request);
        printf('Response data: %s' . PHP_EOL, $response->serializeToJsonString());
    } catch (ApiException $ex) {
        printf('Call failed with message: %s' . PHP_EOL, $ex->getMessage());
    }
}

/**
 * Helper to execute the sample.
 *
 */
function callSample(): void
{
    $formattedName = NetworkServiceClient::networkName('NETWORK_CODE');

    get_network_sample($formattedName);
}get_network.php

如需更多範例，請前往 GitHub。

Ruby

require "google/ads/ad_manager/v1"

def get_network
  # Create a client object. The client can be reused for multiple calls.
  client = Google::Ads::AdManager::V1::NetworkService::Rest::Client.new

  # Create a request. To set request fields, pass in keyword arguments.
  request = Google::Ads::AdManager::V1::GetNetworkRequest.new(:name => 'networks/NETWORK_CODE)'

  # Call the get_network method.
  result = client.get_network request

  # The returned object is of type Google::Ads::AdManager::V1::Network.
  p result
endget_network.rb

如需更多範例，請前往 GitHub。

Node.js

// Resource name of the Network
const name = 'networks/NETWORK_CODE'

// Imports the Admanager library
const {NetworkServiceClient} = require('@google-ads/admanager').v1;

// Instantiates a client
const admanagerClient = new NetworkServiceClient();

async function callGetNetwork() {
  // Construct request
  const request = {
    name,
  };

  // Run request
  const response = await admanagerClient.getNetwork(request);
  console.log(response);
}

callGetNetwork();network_service.get_network.js

如需更多範例，請前往 GitHub。

cURL

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