Başlarken

Ad Manager verilerinizi okumak ve rapor çalıştırmak için Google Ad Manager API'yi (Beta) kullanın.

İlk API isteğinizi göndermek için aşağıdaki adımları uygulayın:

Ad Manager ağına erişim

Henüz bir Ad Manager hesabınız yoksa kaydolun.

Ad Manager API'yi etkinleştirme

Google API Konsolu projenizde Ad Manager API'yi etkinleştirin.

Kimliği doğrula

Tüm API isteklerinin kimliği OAuth2 kullanılarak doğrulanmalıdır.

Ad Manager API istemci kitaplıkları, Uygulama Varsayılan Kimlik Bilgileri'nden kimlik bilgilerini okur. Bunları ortam değişkenlerini veya gcloud'u kullanarak ayarlayabilirsiniz.

Hizmet Hesabı

Linux veya macOS

export GOOGLE_APPLICATION_CREDENTIALS=KEY_FILE_PATH

Windows

set GOOGLE_APPLICATION_CREDENTIALS=KEY_FILE_PATH

Kullanıcı kimlik bilgileri 

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

Kimlik bilgisi türlerini seçme ve kimlik bilgisi oluşturma hakkında daha fazla bilgi için kimlik doğrulama kılavuzunu inceleyin.

İstemci kitaplığınızı ayarlama

Java

Maven için:

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

Gradle için:

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

Python

İstemci kitaplığını PyPi'den yükleyin.

pip install google-ads-admanager

.NET

İstemci kitaplığını NuGet'ten yükleyin.

.NET CLI'den:

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

Paket referansı olarak:

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

PHP

İstemci kitaplığını Composer'dan yükleyin.

composer require googleads/ad-manager

Ruby

İstemci kitaplığını RubyGems'den yükleyin.

Gemfile:

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

Yükleme:

gem install google-ads-ad_manager

Node.js

İstemci kitaplığını npm'den yükleyin.

Komut satırından:

npm install @google-ads/admanager

Paket referansı olarak:

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

İlk isteğinizi gönderin

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

Daha fazla örneği GitHub'da bulabilirsiniz. İstemci kitaplığı hakkında daha fazla bilgi için Java kılavuzuna bakın.

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

Daha fazla örneği GitHub'da bulabilirsiniz. İstemci kitaplığı hakkında daha fazla bilgi için Python kılavuzuna bakın.

.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

Daha fazla örneği GitHub'da bulabilirsiniz. İstemci kitaplığı hakkında daha fazla bilgi için .NET kılavuzuna bakın.

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

Daha fazla örneği GitHub'da bulabilirsiniz.

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
end
get_network.rb

Daha fazla örneği GitHub'da bulabilirsiniz.

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

Daha fazla örneği GitHub'da bulabilirsiniz.

cURL 

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