תצורה

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

אפשר גם לקבל אובייקט 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");

משתני סביבה של תצורה

אפשר להגדיר חלק מההגדרות באמצעות משתני סביבה בזמן יצירת הלקוחות (רשימת ההגדרות המלאה).

המודול Client מספק את הפונקציה 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: