শুরু করুন

Java

Java ক্লায়েন্ট লাইব্রেরি কীভাবে ব্যবহার করতে হয় তার একটি প্রাথমিক উদাহরণ এখানে দেওয়া হল। ব্যবহার সংক্রান্ত আরও বিস্তারিত তথ্যের জন্য, ক্লায়েন্ট লাইব্রেরি ডিস্ট্রিবিউশনে README ফাইল দেখুন।

1. আপনার ক্রেডেনশিয়াল সেট-আপ করুন

   শেল-এ এই কমান্ড রান করুন:

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

   ~/ads.properties ফাইলটি খুলুন এবং নিম্নলিখিত ফিল্ডগুলি পূরণ করুন:

   [...]
   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. নির্ভরশীলতা নির্দিষ্ট করুন

   আপনার pom.xml ফাইল এডিট করুন এবং dependencies ট্যাগে নিম্নলিখিতগুলি যোগ করুন। আপনি Github-এ লেটেস্ট ভার্সন নম্বর দেখতে পাবেন।

   <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. কিছু কোড লিখে অনুরোধ করুন!

   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.v202608.Network;
   import com.google.api.ads.admanager.axis.v202608.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-এ দেখুন

Python

Python ক্লায়েন্ট লাইব্রেরি কীভাবে ব্যবহার করতে হয় তার একটি প্রাথমিক উদাহরণ এখানে দেওয়া হল। Python ক্লায়েন্ট লাইব্রেরি Python v3.6+ ভার্সনে কাজ করে। ব্যবহার সংক্রান্ত আরও বিস্তারিত তথ্যের জন্য ক্লায়েন্ট লাইব্রেরি ডিস্ট্রিবিউশনে README ফাইল দেখুন।

1. লাইব্রেরি ইনস্টল করুন এবং আপনার ক্রেডেনশিয়াল সেট-আপ করুন।

   শেল-এ নিম্নলিখিত কমান্ড রান করুন:

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

2. আপনার ~/googleads.yaml ফাইল সেট-আপ করুন।

   নিম্নলিখিত ফিল্ড পূরণ করুন:

   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. কিছু কোড রান করে অনুরোধ করুন।

   # 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='v202608')
   
   # 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-এ দেখুন

PHP

PHP ক্লায়েন্ট লাইব্রেরি কীভাবে ব্যবহার করতে হয় তার একটি প্রাথমিক উদাহরণ এখানে দেওয়া হল।

1. লাইব্রেরি ইনস্টল করুন এবং আপনার ক্রেডেনশিয়াল সেট-আপ করুন।

   ক্লায়েন্ট লাইব্রেরি ইনস্টল করতে এবং আপনার হোম ডিরেক্টরিতে adsapi_php.ini ফাইল ডাউনলোড করতে, শেলে নিম্নলিখিত কমান্ড রান করুন:

   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 ফাইল সেট-আপ করুন।

   নিম্নলিখিত ফিল্ড পূরণ করুন:

   [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. কিছু কোড রান করে অনুরোধ করুন!

   <?php
   require 'vendor/autoload.php';
   use Google\AdsApi\AdManager\AdManagerSession;
   use Google\AdsApi\AdManager\AdManagerSessionBuilder;
   use Google\AdsApi\AdManager\v202608\ApiException;
   use Google\AdsApi\AdManager\v202608\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-এ দেখুন

.NET

.NET ক্লায়েন্ট লাইব্রেরি কীভাবে ব্যবহার করতে হয় তার একটি প্রাথমিক উদাহরণ এখানে দেওয়া হল

1. নতুন প্রোজেক্ট তৈরি করা

   Visual Studio খুলে নতুন প্রোজেক্ট (Console Application) তৈরি করুন।

2. আপনার প্রোজেক্টে প্রয়োজনীয় লাইব্রেরি রেফারেন্স যোগ করুন

   Google.Dfp-এর জন্য একটি nuget ডিপেন্ডেন্সি যোগ করুন।

3. আপনার App.config সেট-আপ করুন

   আপনার প্রোজেক্ট ডিরেক্টরিতে src\App.config কপি করুন এবং আপনার প্রোজেক্টে এটি যোগ করুন। আপনার অ্যাপ্লিকেশনের নিজস্ব App.config থাকলে, আপনি নিম্নলিখিত নোডগুলি আপনার App.config-এ কপি করতে পারেন:

   • configuration/AdManagerApi
   • configuration/configSections/section[name="AdManagerApi"]
   • configuration/system.net
4. ক্রেডেনশিয়াল সেট-আপ করুন

   App.config খুলুন এবং নিম্নলিখিত কীগুলি এডিট করুন:

   <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. লাইব্রেরিতে কল করুন

   নিচে দেখানো C# কোড স্নিপেট অনুযায়ী আপনি লাইব্রেরি কল করতে পারবেন

   GitHub-এ দেখুন

   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-এ নিজের ক্রেডেনশিয়াল সেট করতে না চান, তাহলে AdManagerUser ক্লাস ব্যবহার করার বিকল্প উপায় জানতে এই উইকি নিবন্ধ দেখুন। .NET ক্লায়েন্ট লাইব্রেরি ব্যবহার করার ব্যাপারে আরও বিস্তারিত তথ্যের জন্য, README দেখুন। আপনি যদি ক্লায়েন্ট লাইব্রেরি ছাড়া .NET-এ ডেভেলপ করতে চান, তাহলে NoClientLibrary উইকি নিবন্ধ দেখুন।

Ruby

Ruby ক্লায়েন্ট লাইব্রেরি কীভাবে ব্যবহার করতে হয় তার একটি প্রাথমিক উদাহরণ এখানে দেওয়া হল। Ruby ক্লায়েন্ট লাইব্রেরির জন্য Ruby 2.1 বা তার পরবর্তী যেকোনও ভার্সন প্রয়োজন।

1. Ruby gem ইনস্টল করুন এবং কনফিগারেশন ফাইল পান।

   শেল-এ নিম্নলিখিত কমান্ড রান করুন:

   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. আপনার ক্রেডেনশিয়াল সেট-আপ করুন

   ~/ad_manager_api.yml ফাইলে প্রয়োজনীয় ফিল্ড পূরণ করুন। আপনার কাছে আগে থেকে OAuth2 কীফাইল না থাকলে, আপনার OAuth2 ক্রেডেনশিয়াল তৈরি করতে আপনাকে ধাপগুলি অনুসরণ করতে হবে।

   :authentication:
     :oauth2_keyfile: INSERT_PATH_TO_JSON_KEY_FILE_HERE
     :application_name: INSERT_APPLICATION_NAME_HERE
     :network_code: INSERT_NETWORK_CODE_HERE

3. কিছু কোড লিখে অনুরোধ করুন!

   # 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, :v202608)
   
   # Make a request.
   network = network_service.get_current_network()
   
   puts "The current network is %s (%d)." %
           [network[:display_name], network[:network_code]]

   GitHub-এ দেখুন

শুরু করার জন্য আরও বিস্তারিত ধাপ README ফাইলে পাওয়া যাবে যা Ruby ক্লায়েন্ট লাইব্রেরির সাথে ডিস্ট্রিবিউট করা হয়। এছাড়াও, Ruby-এর জন্য আমাদের সম্পূর্ণ উদাহরণ লাইব্রেরি চেক করুন।