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

ספריית הלקוח של 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 שמשמשת לחיבור לאינטרנט.