Başlama

Koleksiyonlar ile düzeninizi koruyun İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.

Java

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

1. Kimlik bilgilerinizi ayarlama

   Bir 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çıp 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ını belirtme

   pom.xml dosyanızı düzenleyin ve aşağıdakileri dependencies etiketine ekleyin. 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. Biraz kod yazın ve istek gönderin.

   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.v202505.Network;
   import com.google.api.ads.admanager.axis.v202505.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 için bilgi edinmek için README dosyası'dır.

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

   Bir 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

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='v202505')
   
   # 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 örnek aşağıda verilmiştir.

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

   İstemci kitaplığını yüklemek ve adsapi_php.ini dosyasını ana dizininize indirmek için aşağıdaki komutları bir kabukta ç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

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. Biraz kod çalıştırın ve istek gönderin.

   <?php
   require 'vendor/autoload.php';
   use Google\AdsApi\AdManager\AdManagerSession;
   use Google\AdsApi\AdManager\AdManagerSessionBuilder;
   use Google\AdsApi\AdManager\v202505\ApiException;
   use Google\AdsApi\AdManager\v202505\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 örnek aşağıda verilmiştir.

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 dosyası varsa aşağıdaki düğümleri App.config dosyanıza kopyalayabilirsiniz:

   • configuration/AdManagerApi
   • configuration/configSections/section[name="AdManagerApi"]
   • 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.

   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 bu wiki makalesine kullanmanın alternatif yollarına göz atabilirsiniz. .NET istemci kitaplığını kullanma hakkında daha ayrıntılı bilgi için README dosyasını inceleyin. .NET'te istemci kitaplığı olmadan geliştirme yapmak istiyorsanız lütfen NoClientLibrary wiki makalesine bakın.

Ruby

Ruby istemci kitaplığının nasıl kullanılacağını gösteren temel bir örneği aşağıda bulabilirsiniz. Ruby istemci kitaplığı için Ruby 2.1 veya sonraki bir sürüm gereklidir.

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

   Bir 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

2. Kimlik bilgilerinizi ayarlayın

   ~/ad_manager_api.yml bölümündeki zorunlu alanları doldurun dosyası olarak kaydedebilirsiniz. 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

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, :v202505)
   
   # 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ığıyla birlikte dağıtılan README dosyasında bulabilirsiniz. Ayrıca, örnek kitaplığı oluşturun.