कॉन्फ़िगरेशन

Ads API क्लाइंट लाइब्रेरी में कई कॉन्फ़िगरेशन सेटिंग होती हैं. इनका इस्तेमाल करके, लाइब्रेरी के काम करने के तरीके को पसंद के मुताबिक बनाया जा सकता है.

कॉन्फ़िगरेशन फ़ाइल

क्लाइंट को इंस्टैंशिएट करते समय, आपके पास googleads.properties फ़ाइल के बारे में बताने का विकल्प होता है.

अगर इंस्टैंशिएट करते समय किसी आर्ग्युमेंट का इस्तेमाल नहीं किया जाता है, तो:

my $api_client = Google::Ads::GoogleAds::Client->new();

तो लाइब्रेरी, फ़ाइल के लिए आपकी HOME डायरेक्ट्री में दिखेगी.

वैकल्पिक रूप से, आप एक पथ बना सकते हैं:

my $properties_file = "/path/to/googleads.properties";

my $api_client = Google::Ads::GoogleAds::Client->new({
  properties_file => $properties_file
});

इस मामले में, क्लाइंट उस फ़ाइल पाथ पर फ़ाइल खोजेगा.

इस फ़ाइल को जनरेट करने का सबसे आसान तरीका, GitHub रिपॉज़िटरी से googleads.properties को कॉपी करना है. साथ ही, इसमें अपना क्लाइंट आईडी, क्लाइंट सीक्रेट, और रीफ़्रेश टोकन शामिल करने के लिए बदलाव करना है.

डाइनैमिक कॉन्फ़िगरेशन

लाइब्रेरी को इंस्टैंशिएट करते समय, डाइनैमिक तौर पर कॉन्फ़िगरेशन सेट अप किया जा सकता है. इसके बाद भी ऐसा किया जा सकता है:

my $api_client = Google::Ads::GoogleAds::Client->new({
  developer_token   => "INSERT_DEVELOPER_TOKEN_HERE",
  login_customer_id => "INSERT_LOGIN_CUSTOMER_ID_HERE"
});

इंस्टैंशिएट करने के बाद भी, कॉन्फ़िगरेशन में बदलाव किया जा सकता है:

$api_client->set_login_customer_id("INSERT_LOGIN_CUSTOMER_ID_HERE");

आपके पास API Client से OAuth2ApplicationsHandler ऑब्जेक्ट को पाने का विकल्प भी है. साथ ही, रनटाइम के दौरान क्लाइंट आईडी, क्लाइंट सीक्रेट, और रीफ़्रेश टोकन में बदलाव भी किया जा सकता है:

my $oauth2_applications_handler = $api_client->get_oauth2_applications_handler();
$oauth2_applications_handler->set_client_id("INSERT_CLIENT_ID");
$oauth2_applications_handler->set_client_secret("INSERT_CLIENT_SECRET");
$oauth2_applications_handler->set_refresh_token("INSERT_REFRESH_TOKEN");

कॉन्फ़िगरेशन एनवायरमेंट वैरिएबल

क्लाइंट को इंस्टैंशिएट करते समय, एनवायरमेंट वैरिएबल से कुछ कॉन्फ़िगरेशन सेटिंग सेट की जा सकती हैं (पूरी सूची देखें).

क्लाइंट मॉड्यूल, एनवायरमेंट वैरिएबल से वैल्यू लोड करने के लिए configure_from_environment_variables फ़ंक्शन देता है:

# Get the Google Ads Client. By default, any credentials will be read from
# ~/googleads.properties, or, if set, from the file specified in the
# GOOGLE_ADS_CONFIGURATION_FILE_PATH environment variable.
my $api_client = Google::Ads::GoogleAds::Client->new();

# Load the configuration from any set environment variables.
$api_client->configure_from_environment_variables();

कॉन्फ़िगरेशन फ़ील्ड

कॉन्फ़िगरेशन प्रॉपर्टी के साथ ये फ़ील्ड काम करते हैं:

OAuth2ApplicationsHandler में मौजूद फ़ील्ड:

  • client_id: आपका OAuth2 क्लाइंट आईडी.
  • client_secret: आपका OAuth2 क्लाइंट सीक्रेट.
  • refresh_token: आपका OAuth2 रीफ़्रेश टोकन.

एपीआई क्लाइंट में मौजूद फ़ील्ड:

  • developer_token: एपीआई ऐक्सेस करने के लिए आपका डेवलपर टोकन.
  • login_customer_id: login-customer-id दस्तावेज़ देखें.
  • proxy: इंटरनेट कनेक्टिविटी के लिए इस्तेमाल किए जाने वाले प्रॉक्सी सर्वर का यूआरएल.