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

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: इंटरनेट कनेक्टिविटी के लिए इस्तेमाल किया जाने वाला प्रॉक्सी सर्वर यूआरएल.