এবার শুরু করা যাক

আপনি Google Ad Manager API ব্যবহার করতে পারেন এমন অ্যাপ তৈরি করতে যা ইনভেন্টরি পরিচালনা করে, অর্ডার তৈরি করে, রিপোর্ট টান, এবং আরও অনেক কিছু।

Ad Manager API SOAP ব্যবহার করে। আপনাকে শুরু করতে সাহায্য করার জন্য, আমরা Java, .NET, Python, PHP, এবং Ruby-এর জন্য ক্লায়েন্ট লাইব্রেরি অফার করি।

আপনার প্রথম API অনুরোধ করতে, এই পদক্ষেপগুলি অনুসরণ করুন:

অ্যাড ম্যানেজার নেটওয়ার্কে অ্যাক্সেস পান

আপনার যদি ইতিমধ্যে একটি না থাকে তবে একটি অ্যাড ম্যানেজার অ্যাকাউন্টের জন্য সাইন আপ করুন৷ আপনি যদি আলাদা পরিবেশে API পরীক্ষা করতে চান তবে আপনি একটি পরীক্ষা নেটওয়ার্কও তৈরি করতে পারেন। মনে রাখবেন পরীক্ষার উদ্দেশ্যে আপনার কোনো AdSense অ্যাকাউন্টের প্রয়োজন নেই।

আপনার নেটওয়ার্ক কোড একটি নোট করুন. আপনি যখন আপনার নেটওয়ার্কে সাইন ইন করবেন তখন আপনি URL-এ এটি খুঁজে পেতে পারেন৷ উদাহরণস্বরূপ, URL-এ https://admanager.google.com/1234#home , 1234 হল আপনার নেটওয়ার্ক কোড৷

প্রমাণীকরণ শংসাপত্র তৈরি করুন

আপনাকে অবশ্যই OAuth 2.0 ব্যবহার করে সমস্ত Ad Manager API অনুরোধ প্রমাণীকরণ করতে হবে। নীচের ধাপগুলি আপনার নিজের অ্যাড ম্যানেজার ডেটা অ্যাক্সেস করার ক্ষেত্রে ব্যবহার করে। আরো বিস্তারিত এবং অন্যান্য বিকল্পের জন্য, প্রমাণীকরণ দেখুন।

  1. Google API কনসোল শংসাপত্র পৃষ্ঠা খুলুন

  2. প্রকল্প মেনু থেকে, প্রকল্প তৈরি করুন নির্বাচন করুন, প্রকল্পের জন্য একটি নাম লিখুন এবং ঐচ্ছিকভাবে, প্রদত্ত প্রকল্প আইডি সম্পাদনা করুন। তৈরি করুন ক্লিক করুন।

  3. শংসাপত্র পৃষ্ঠায়, শংসাপত্র তৈরি করুন নির্বাচন করুন, তারপরে পরিষেবা অ্যাকাউন্ট কী নির্বাচন করুন।

  4. নতুন পরিষেবা অ্যাকাউন্ট নির্বাচন করুন এবং কী প্রকার হিসাবে JSON নির্বাচন করুন।

  5. একটি ব্যক্তিগত কী ধারণকারী একটি ফাইল ডাউনলোড করতে তৈরি করুন ক্লিক করুন।

আপনার অ্যাড ম্যানেজার নেটওয়ার্ক কনফিগার করুন

  1. গুগল অ্যাড ম্যানেজারে সাইন ইন করুন

  2. সাইডবারে, অ্যাডমিন > গ্লোবাল সেটিংস-এ ক্লিক করুন।

  3. সাধারণ সেটিংসের অধীনে > Api অ্যাক্সেস সক্রিয় করতে স্লাইডারে ক্লিক করুন।

  4. পৃষ্ঠার নীচে সংরক্ষণ বোতামে ক্লিক করুন।

আপনার ক্লায়েন্ট সেট আপ করুন

অ্যাড ম্যানেজার ক্লায়েন্ট লাইব্রেরিগুলির একটি ডাউনলোড করুন। লাইব্রেরিগুলি র‍্যাপার ফাংশন এবং বৈশিষ্ট্যগুলি অফার করে যা অ্যাপ্লিকেশনগুলিকে বিকাশ করা সহজ এবং দ্রুত করে।

নীচের ট্যাবগুলি প্রতিটি ভাষায় কোডিং করার জন্য দ্রুত স্টার্ট প্রদান করে যার জন্য একটি ক্লায়েন্ট লাইব্রেরি রয়েছে।

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.v202402.Network;
    import com.google.api.ads.admanager.axis.v202402.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 ক্লায়েন্ট লাইব্রেরি Python v3.6+ সমর্থন করে। আরও বিস্তারিত ব্যবহারের তথ্যের জন্য, ক্লায়েন্ট লাইব্রেরি বিতরণে README ফাইলটি পড়ুন।

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

    একটি শেলে নিম্নলিখিত কমান্ডগুলি চালান:

    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='v202402')
    
    # 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

এখানে একটি মৌলিক উদাহরণ রয়েছে যা দেখায় কিভাবে পিএইচপি ক্লায়েন্ট লাইব্রেরি ব্যবহার করতে হয়।

  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\v202402\ApiException;
    use Google\AdsApi\AdManager\v202402\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 ক্লায়েন্ট লাইব্রেরি ব্যবহার করতে হয়

  1. একটি নতুন প্রকল্প তৈরি করুন

    ভিজ্যুয়াল স্টুডিও খুলুন এবং একটি নতুন প্রকল্প তৈরি করুন (কনসোল অ্যাপ্লিকেশন)।

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

    Google.Dfp- এর জন্য একটি নুগেট নির্ভরতা যোগ করুন।

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

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

    • কনফিগারেশন/AdManagerApi
    • কনফিগারেশন/কনফিগারেশন বিভাগ/বিভাগ[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# কোড স্নিপেটে দেখানো হিসাবে আপনি লাইব্রেরি কল করতে পারেন

    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

এখানে একটি মৌলিক উদাহরণ যা দেখায় কিভাবে রুবি ক্লায়েন্ট লাইব্রেরি ব্যবহার করতে হয়। রুবি ক্লায়েন্ট লাইব্রেরির রুবি 2.1 বা তার পরে প্রয়োজন।

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

    একটি শেলে নিম্নলিখিত কমান্ডগুলি চালান:

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

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

পরবর্তী পদক্ষেপ

যখন আপনার একটি ক্লায়েন্ট লাইব্রেরি চালু এবং চলমান থাকে, আপনার প্রয়োজনের জন্য সেগুলি প্রসারিত করতে প্রদত্ত উদাহরণগুলি সংশোধন করুন।

API সম্পর্কে আরও জানতে রেফারেন্স ডকুমেন্টেশন ব্রাউজ করুন।

আপনার সাহায্যের প্রয়োজন হলে, আমাদের সমর্থন পৃষ্ঠা দেখুন।