Başlama

Envanteri yöneten uygulamalar oluşturmak için Google Ad Manager API'sini kullanabilirsiniz. sipariş oluşturabilir, rapor alabilir ve daha fazlasını yapabilirsiniz.

Ad Manager API'si SOAP kullanır. Başlamanıza yardımcı olmak için müşteri desteği kitaplıklarını inceleyin.

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

Ad Manager ağına erişim elde etme

Henüz bir hesabınız yoksa Ad Manager hesap. Ayrıca bir test ağını kullanarak API'yi belirli bir ayrı bir ortamda kullanabilirsiniz. Test için AdSense hesabına ihtiyacınız yoktur amaçlar.

Ağ kodunuzu not edin. Bunu, oturum açtığınızda URL'de bulabilirsiniz ağınıza ekleyin. Örneğin, https://admanager.google.com/1234#home, 1234, ağ kodunuzdur.

Kimlik doğrulama kimlik bilgileri oluşturma

Tüm Ad Manager API isteklerinin kimliğini OAuth 2.0 kullanarak doğrulamanız gerekir. Adımlar aşağıda kendi Ad Manager verilerinize erişmenin kullanım örneğini görebilirsiniz. Ayrıntılı bilgi için ve diğer seçeneklere bakın. Kimlik Doğrulama sayfasına göz atın.

  1. Google API Konsolu'nu açın Kimlik bilgileri sayfası

  2. Proje menüsünden Proje oluştur'u seçin ve ve isteğe bağlı olarak sağlanan proje kimliğini düzenleyin. Oluştur'u tıklayın.

  3. Kimlik bilgileri sayfasında Kimlik bilgileri oluştur'u seçin ve ardından Hizmet hesabı anahtarı.

  4. Yeni hizmet hesap ve anahtar türü olarak JSON'i seçin.

  5. Özel anahtar içeren bir dosyayı indirmek için Oluştur'u tıklayın.

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

  1. Google Ads'de oturum açın Yönetici'yi seçin.

  2. Kenar çubuğunda Yönetici > Global ayarlar.

  3. Genel ayarlar > Api erişimi'nde kaydırma çubuğunu tıklayarak Etkin'e gidin.

  4. Sayfanın alt kısmındaki Kaydet düğmesini tıklayın.

İstemcinizi kurun

Ad Manager istemci kitaplıklarından birini indirin. İlgili içeriği oluşturmak için kullanılan kitaplıklar, kapsayıcı işlevleri ve özellikleri sunar. Bu işlev, uygulamalar geliştirir.

Aşağıdaki sekmeler, kullanılan dillerin her birinde kodlama için hızlı başlangıç kılavuzları istemci kitaplığı da bulunur.

Java

Java istemcisinin nasıl kullanılacağını gösteren temel bir örneği kitaplığı'nda bulabilirsiniz. Daha ayrıntılı kullanım bilgileri için README dosyası'dır.

  1. Kimlik bilgilerinizi ayarlayın

    Kabuk içinde 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
    [...]
  2. Bağımlılıkları belirtme

    pom.xml dosyanızı düzenleyin ve aşağıdakileri ekleyin: dependencies etiketi. En son sürüm numarasını adresinde bulabilirsiniz 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>

  3. Bir kod yazıp 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.v202408.Network;
    import com.google.api.ads.admanager.axis.v202408.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());
      }
    }
    

Python

Python istemci kitaplığının nasıl kullanılacağını gösteren temel bir örneği burada bulabilirsiniz. Python İstemci Kitaplığı, Python v3.6 ve sonraki sürümleri destekler. Daha ayrıntılı kullanım için bilgi edinmek için README dosyası'dır.

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

    Kabuk içinde 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
    
  2. ~/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
    
  3. Bir kod çalıştırıp 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='v202408')
    
    # 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']))
    

PHP

Burada, PHP istemci kitaplığı.

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

    İstemci kitaplığını yüklemek ve adsapi_php.ini dosyasını ana dizininize ekleyin:

    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
  2. ~/adsapi_php.ini dosyanızı oluşturun.

    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"
    
  3. Bir kod çalıştırıp istekte bulunun.
    <?php
    require 'vendor/autoload.php';
    use Google\AdsApi\AdManager\AdManagerSession;
    use Google\AdsApi\AdManager\AdManagerSessionBuilder;
    use Google\AdsApi\AdManager\v202408\ApiException;
    use Google\AdsApi\AdManager\v202408\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()
    );
    

.NET

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

  1. Yeni proje oluşturma

    Visual Studio'yu açın ve yeni bir proje (Konsol Uygulaması) oluşturun.

  2. Projenize gerekli kitaplık referanslarını ekleme

    Google.Dfp için bir nuget bağımlılığı ekleyin.

  3. App.config dosyanızı ayarlayın

    src\App.config dosyasını proje dizininize kopyalayın ve projenize ekleyin. Uygulamanızın kendi App.config'i varsa aşağıdaki düğümleri App.config'inize kopyalayabilirsiniz:

    • configuration/AdManagerApi
    • configuration/configSections/section[name=&quot;AdManagerApi&quot;]
    • configuration/system.net
  4. Kurulum kimlik bilgileri

    App.config'i 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" />
    
    .

  5. Kitaplığa arama yapma

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

    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 bu wiki makalesine kullanmanın alternatif yollarına göz atabilirsiniz. .NET İstemci Kitaplığı'nı kullanma hakkında daha ayrıntılı bilgi için BENİOKU) ziyaret edin. İstemci kitaplığı olmadan .NET'te geliştirme yapmak istiyorsanız lütfen NoClientLibrary daha fazla bilgi edinin.

Ruby

Burada, Ruby'nin nasıl kullanılacağını gösteren temel bir tıklayın. Ruby istemci kitaplığı için Ruby 2.1 veya sonraki sürümleri gerekir.

  1. Ruby gem'i yükleyin ve yapılandırma dosyasını alın.

    Kabuk içinde 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
    
    .
  2. Kimlik bilgilerinizi ayarlayın

    ~/ad_manager_api.yml bölümündeki zorunlu alanları doldurun dosyası olarak kaydedebilirsiniz. Henüz OAuth2 anahtar dosyanız yoksa şu adımları uygulamanız gerekir: OAuth2 oluşturma adımları kimlik bilgileri ekleyin.

    :authentication:
      :oauth2_keyfile: INSERT_PATH_TO_JSON_KEY_FILE_HERE
      :application_name: INSERT_APPLICATION_NAME_HERE
      :network_code: INSERT_NETWORK_CODE_HERE
    
  3. Bir kod yazıp 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, :v202408)
    
    # Make a request.
    network = network_service.get_current_network()
    
    puts "The current network is %s (%d)." %
            [network[:display_name], network[:network_code]]
    

Başlamak için daha ayrıntılı adımlar README bölümünde bulunabilir dosyası oluşturmanız gerekir. Ayrıca, örnek kitaplığı oluşturun.

Sonraki adımlar

Çalışır durumdaki bir istemci kitaplığınız olduğunda, sağlanan örnekleri şu şekilde değiştirin: ihtiyaçlarınıza uygun şekilde genişletebilirsiniz.

Daha fazla bilgi edinmek için referans belgelerine göz atın bazı bilgiler vereceğim.

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