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

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