Bu sayfa, Cloud Translation API ile çevrilmiştir.

Başlayın

Envanteri yöneten, sipariş oluşturan, rapor çeken ve daha fazlasını yapan uygulamalar derlemek için Google Ad Manager API'sini kullanabilirsiniz.

Ad Manager API'si SOAP'ı kullanır. Başlamanıza yardımcı olmak için Java, .NET, Python, PHP ve Ruby için istemci kitaplıkları sunuyoruz.

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

Henüz bir hesabınız yoksa Ad Manager hesabı için kaydolun. API'yi ayrı bir ortamda test etmek istiyorsanız test ağı da oluşturabilirsiniz. Test amacıyla AdSense hesabına ihtiyacınızın olmadığını unutmayın.

Ağ kodunuzu not edin. Bu bilgiyi, ağınızda oturum açtığınızda URL içinde bulabilirsiniz. Örneğin, https://admanager.google.com/1234#home URL'sinde 1234 ağ kodunuzdur.

Kimlik doğrulama kimlik bilgileri oluşturun

Tüm Ad Manager API isteklerinin kimliğini OAuth 2.0 kullanarak doğrulamanız gerekir. Aşağıdaki adımlar, kendi Ad Manager verilerinize erişmeyle ilgili kullanım alanını kapsar. Diğer ayrıntılar ve diğer seçenekler için Kimlik Doğrulama bölümüne bakın.

Google API Konsolu Kimlik Bilgileri sayfasını açın.
Proje menüsünden Proje oluştur'u seçin, proje için bir ad girin ve isteğe bağlı olarak sağlanan proje kimliğini düzenleyin. Oluştur'u tıklayın.
Kimlik bilgileri sayfasında Kimlik bilgisi oluştur'u ve ardından Hizmet hesabı anahtarı'nı seçin.
Yeni hizmet hesabı'nı ve anahtar türü olarak JSON'yi seçin.
Özel anahtar içeren bir dosya indirmek için Oluştur'u tıklayın.

Ad Manager ağınızı yapılandırma

Google Ad Manager'da oturum açın.
Kenar çubuğunda Yönetici > Genel ayarlar'ı tıklayın.
Genel ayarlar > API erişimi altında, kaydırma çubuğunu Etkin'e getirin.
Sayfanın alt kısmındaki Kaydet düğmesini tıklayın.

İstemcinizi ayarlayın

Ad Manager istemci kitaplıklarından birini indirin. Kitaplıklar, uygulama geliştirmeyi kolaylaştıran ve hızlandıran sarmalayıcı işlevleri ve özellikleri sunar.

Aşağıdaki sekmeler, istemci kitaplığı olan dillerin her birinde kodlama için hızlı başlangıç kılavuzları sağlar.

Java

Java istemci kitaplığının nasıl kullanılacağını gösteren temel bir örneği burada bulabilirsiniz. Daha ayrıntılı kullanım bilgileri için istemci kitaplığı dağıtımındaki BENİOKU dosyasına bakın.

Kimlik bilgilerinizi ayarlayın

Kabukta aşağıdaki komutu çalıştırın:

curl https://raw.githubusercontent.com/googleads/googleads-java-lib/main/examples/admanager_axis/src/main/resources/ads.properties -o ~/ads.properties

~/ads.properties dosyasını açın ve aşağıdaki alanları doldurun:

[...]
api.admanager.applicationName=INSERT_APPLICATION_NAME_HERE
api.admanager.jsonKeyFilePath=INSERT_PATH_TO_JSON_KEY_FILE_HERE
api.admanager.networkCode=INSERT_NETWORK_CODE_HERE
[...]

Bağımlılıkları belirtme

pom.xml dosyanızı düzenleyin ve aşağıdaki kodu dependencies etiketine ekleyin. En son sürüm numarasını GitHub'da bulabilirsiniz.

<dependency>
  <groupId>com.google.api-ads</groupId>
  <artifactId>ads-lib</artifactId>
  <version>RELEASE</version>
</dependency>
<dependency>
  <groupId>com.google.api-ads</groupId>
  <artifactId>dfp-axis</artifactId>
  <version>RELEASE</version>
</dependency>

Kod yazın ve istekte bulunun.

import com.google.api.ads.common.lib.auth.OfflineCredentials;
import com.google.api.ads.common.lib.auth.OfflineCredentials.Api;
import com.google.api.ads.admanager.axis.factory.AdManagerServices;
import com.google.api.ads.admanager.axis.v202311.Network;
import com.google.api.ads.admanager.axis.v202311.NetworkServiceInterface;
import com.google.api.ads.admanager.lib.client.AdManagerSession;
import com.google.api.client.auth.oauth2.Credential;

public class App {
  public static void main(String[] args) throws Exception {
    Credential oAuth2Credential = new OfflineCredentials.Builder()
        .forApi(Api.AD_MANAGER)
        .fromFile()
        .build()
        .generateCredential();

    // Construct an AdManagerSession.
    AdManagerSession session = new AdManagerSession.Builder()
        .fromFile()
        .withOAuth2Credential(oAuth2Credential)
        .build();

    // Construct a Google Ad Manager service factory, which can only be used once per
    // thread, but should be reused as much as possible.
    AdManagerServices adManagerServices = new AdManagerServices();

    // Retrieve the appropriate service
    NetworkServiceInterface networkService = adManagerServices.get(session,
        NetworkServiceInterface.class);

    // Make a request
    Network network = networkService.getCurrentNetwork();

    System.out.printf("Current network has network code '%s' and display" +
        " name '%s'.%n", network.getNetworkCode(), network.getDisplayName());
  }
}

GitHub'da göster

Python

Python istemci kitaplığının nasıl kullanılacağını gösteren temel bir örneği aşağıda bulabilirsiniz. Python İstemci Kitaplığı, Python v3.6 ve sonraki sürümleri destekler. Daha ayrıntılı kullanım bilgileri için istemci kitaplığı dağıtımındaki BENİOKU dosyasına bakın.

Kitaplığı yükleyin ve kimlik bilgilerinizi ayarlayın.

Kabukta aşağıdaki komutları çalıştırın:

pip install googleads
curl https://raw.githubusercontent.com/googleads/googleads-python-lib/main/googleads.yaml \
     -o ~/googleads.yaml

~/googleads.yaml dosyanızı oluşturun.

Aşağıdaki alanları doldurun:

ad_manager:
  application_name: INSERT_APPLICATION_NAME_HERE
  network_code: INSERT_NETWORK_CODE_HERE
  path_to_private_key_file: INSERT_PATH_TO_FILE_HERE

Kod çalıştırın ve istekte bulunun.

# Import the library.
from googleads import ad_manager

# Initialize a client object, by default uses the credentials in ~/googleads.yaml.
client = ad_manager.AdManagerClient.LoadFromStorage()

# Initialize a service.
network_service = client.GetService('NetworkService', version='v202311')

# Make a request.
current_network = network_service.getCurrentNetwork()

print("Current network has network code '%s' and display name '%s'." %
        (current_network['networkCode'], current_network['displayName']))

GitHub'da göster

PHP

PHP istemci kitaplığının nasıl kullanılacağını gösteren temel bir örneği burada bulabilirsiniz.

Kitaplığı yükleyin ve kimlik bilgilerinizi ayarlayın.
İstemci kitaplığını yüklemek ve adsapi_php.ini dosyasını ana dizininize indirmek için bir kabukta aşağıdaki komutları çalıştırın:
```
composer require googleads/googleads-php-lib
curl https://raw.githubusercontent.com/googleads/googleads-php-lib/main/examples/AdManager/adsapi_php.ini -o ~/adsapi_php.ini
```

~/adsapi_php.ini dosyanızı ayarlayın.

Aşağıdaki alanları doldurun:

[AD_MANAGER]
networkCode = "INSERT_NETWORK_CODE_HERE"
applicationName = "INSERT_APPLICATION_NAME_HERE"

[OAUTH2]
jsonKeyFilePath = "INSERT_ABSOLUTE_PATH_TO_OAUTH2_JSON_KEY_FILE_HERE"
scopes = "https://www.googleapis.com/auth/dfp"

Kod çalıştırın ve istekte bulunun.

Bu örnek kod, tarayıcıdan değil, komut satırından çalıştırılmalıdır. Bu kodu içeren dosya, composer require uygulamasının çalıştırıldığı proje dizininin kök dizininde bulunmalıdır.

<?php
require 'vendor/autoload.php';
use Google\AdsApi\AdManager\AdManagerSession;
use Google\AdsApi\AdManager\AdManagerSessionBuilder;
use Google\AdsApi\AdManager\v202311\ApiException;
use Google\AdsApi\AdManager\v202311\ServiceFactory;
use Google\AdsApi\Common\OAuth2TokenBuilder;

// Generate a refreshable OAuth2 credential for authentication.
$oAuth2Credential = (new OAuth2TokenBuilder())
    ->fromFile()
    ->build();
// Construct an API session configured from a properties file and the OAuth2
// credentials above.
$session = (new AdManagerSessionBuilder())
    ->fromFile()
    ->withOAuth2Credential($oAuth2Credential)
    ->build();

// Get a service.
$serviceFactory = new ServiceFactory();
$networkService = $serviceFactory->createNetworkService($session);

// Make a request
$network = $networkService->getCurrentNetwork();
printf(
    "Network with code %d and display name '%s' was found.\n",
    $network->getNetworkCode(),
    $network->getDisplayName()
);

GitHub'da göster

.NET

.NET istemci kitaplığının nasıl kullanılacağını gösteren temel bir örneği aşağıda bulabilirsiniz

Yeni proje oluşturma
Visual Studio'yu açın ve yeni bir proje (Console Uygulaması) oluşturun.
Projenize gerekli kitaplık referanslarını ekleyin
Google.Dfp için bir nuget bağımlılığı ekleyin.
App.config dosyanızı ayarlama
src\App.config dosyasını proje dizininize kopyalayıp projenize ekleyin. Uygulamanızın kendi App.config dosyası varsa aşağıdaki düğümleri App.config dosyanıza kopyalayabilirsiniz:
- yapılandırma/AdManagerApi
- configuration/configSections/section[name="AdManagerApi"]
- Configuration/system.net

Kimlik bilgilerini ayarlayın

App.config uygulamasını açın ve aşağıdaki anahtarları düzenleyin:

<add key="ApplicationName" value="INSERT_YOUR_APPLICATION_NAME_HERE" />
<add key="NetworkCode" value="INSERT_YOUR_NETWORK_CODE_HERE" />
<add key="OAuth2Mode" value="SERVICE_ACCOUNT" />
<add key="OAuth2SecretsJsonPath" value="INSERT_OAUTH2_SECRETS_JSON_FILE_PATH_HERE" />

Kitaplığa arama yapma

Kitaplığı, aşağıdaki C# kod snippet'inde gösterildiği gibi çağırabilirsiniz

GitHub'da göster

AdManagerUser user = new AdManagerUser();
      using (InventoryService inventoryService = user.GetService<InventoryService>())
            {
                // Create a statement to select ad units.
                int pageSize = StatementBuilder.SUGGESTED_PAGE_LIMIT;
                StatementBuilder statementBuilder =
                    new StatementBuilder().OrderBy("id ASC").Limit(pageSize);

                // Retrieve a small amount of ad units at a time, paging through until all
                // ad units have been retrieved.
                int totalResultSetSize = 0;
                do
                {
                    AdUnitPage page =
                        inventoryService.getAdUnitsByStatement(statementBuilder.ToStatement());

                    // Print out some information for each ad unit.
                    if (page.results != null)
                    {
                        totalResultSetSize = page.totalResultSetSize;
                        int i = page.startIndex;
                        foreach (AdUnit adUnit in page.results)
                        {
                            Console.WriteLine(
                                "{0}) Ad unit with ID \"{1}\" and name \"{2}\" was found.", i++,
                                adUnit.id, adUnit.name);
                        }
                    }

                    statementBuilder.IncreaseOffsetBy(pageSize);
                } while (statementBuilder.GetOffset() < totalResultSetSize);

                Console.WriteLine("Number of results found: {0}", totalResultSetSize);
            }

App.config dosyanızda kimlik bilgilerinizi ayarlamak istemiyorsanız AdManagerUser sınıfını kullanmanın alternatif yolları için bu wiki makalesine bakın. .NET İstemci Kitaplığı'nı kullanma hakkında daha ayrıntılı bilgi için BENİOKU sayfasına bakın. İstemci kitaplığı olmadan .NET'te geliştirme yapmak istiyorsanız lütfen NoClientKitaplık wiki makalesine bakın.

Ruby

Ruby istemci kitaplığının nasıl kullanılacağını gösteren temel bir örneği burada bulabilirsiniz. Ruby istemci kitaplığı, Ruby 2.1 veya sonraki sürümleri gerektirir.

Ruby gem'ini yükleyin ve yapılandırma dosyasını alın.
Kabukta aşağıdaki komutları çalıştırın:
```
gem install google-dfp-api
curl https://raw.githubusercontent.com/googleads/google-api-ads-ruby/main/ad_manager_api/ad_manager_api.yml -o ~/ad_manager_api.yml
```
Mücevherlerinizi yüklerken herhangi bir noktada "cannot load such file -- mkmf (LoadError)" gibi bir hatayla karşılaşırsanız kendi ortamınız için ruby-dev, ruby-devel, xcode-select gibi ek Ruby geliştirme kitaplıkları yüklemeniz gerekebilir.
Kimlik bilgilerinizi ayarlayın
~/ad_manager_api.yml dosyasındaki zorunlu alanları doldurun. Halihazırda bir OAuth2 anahtar dosyanız yoksa OAuth2 kimlik bilgilerinizi oluşturma adımlarını uygulamanız gerekir.
```
:authentication:
  :oauth2_keyfile: INSERT_PATH_TO_JSON_KEY_FILE_HERE
  :application_name: INSERT_APPLICATION_NAME_HERE
  :network_code: INSERT_NETWORK_CODE_HERE
```

Kod yazın ve istekte bulunun.

# Import the library.
require 'ad_manager_api'

# Initialize an Ad Manager client instance (uses credentials in ~/ad_manager_api.yml by default).
ad_manager = AdManagerApi::Api.new

# Get a service instance.
network_service = ad_manager.service(:NetworkService, :v202311)

# Make a request.
network = network_service.get_current_network()

puts "The current network is %s (%d)." %
        [network[:display_name], network[:network_code]]

GitHub'da göster

Başlamak için daha ayrıntılı adımları, Ruby istemci kitaplığı ile dağıtılan README dosyasında bulabilirsiniz. Ayrıca, Ruby için tam örnek kitaplığımıza göz atın.

Sonraki adımlar

Çalışır durumda bir istemci kitaplığınız olduğunda, verilen örnekleri değiştirerek bunları ihtiyaçlarınıza göre genişletebilirsiniz.

API hakkında daha fazla bilgi edinmek için referans belgelere göz atın.

Yardıma ihtiyacınız varsa Destek sayfamızı ziyaret edin.

Başlayın

Ad Manager ağına erişim elde etme

Kimlik doğrulama kimlik bilgileri oluşturun

Ad Manager ağınızı yapılandırma

İstemcinizi ayarlayın

Java

Python

PHP

.NET

Ruby

Sonraki adımlar