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

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

משתני סביבת ההגדרה

כשאתם מפעילים לקוחות, אתם יכולים לקבוע חלק מהגדרות התצורה ממשתני סביבה במהלך הפעלת הלקוחות (ברשימה המקיפה).

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

  • developer_token: קוד המפתח שלכם לגישה ל-API.
  • login_customer_id: אפשר לעיין במאמרי login-customer-id.
  • proxy: כתובת ה-URL של שרת ה-proxy שמשמשת לחיבור לאינטרנט.