תצורה

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