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

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: लॉगिन-ग्राहक आईडी दस्तावेज़ देखें.
  • proxy: इंटरनेट कनेक्टिविटी के लिए इस्तेमाल किया जाने वाला प्रॉक्सी सर्वर यूआरएल.