Başlama

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());
     }
   }
   

   GitHub'da göster

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']))
   

   GitHub'da göster

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()
   );
   

   GitHub'da göster

.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="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 İ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]]
   

   GitHub'da göster

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.