אפשרויות הגדרה

ספריית הלקוח של 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
});

במקרה כזה, הלקוח יחפש את הקובץ בנתיב הזה.

הדרך הכי קלה ליצור את הקובץ הזה היא להעתיק את googleads.properties ממאגר GitHub ולשנות אותו כך שיכלול את מזהה הלקוח, את הסוד של הלקוח ואת טוקן הרענון.

הגדרה דינמית

אפשר להגדיר את התצורה באופן דינמי כשיוצרים מופע של הספרייה, או אפילו אחרי זה:

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

אפשר אפילו לשנות את ההגדרה אחרי יצירת המופע:

$api_client->set_login_customer_id("INSERT_LOGIN_CUSTOMER_ID_HERE");

אפשר גם לקבל אובייקט OAuth2ApplicationsHandler מ-API Client ולשנות את מזהה הלקוח, הסוד של הלקוח וטוקן הרענון בזמן הריצה:

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.

שדות שנשמרים בלקוח API: