ספריית הלקוח של Perl מתארחת ב-GitHub, והחבילה זמינה ב-CPAN.
הספרייה תומכת ב-Perl מגרסה 5.28.1 ואילך.
פרוטוקול API בארכיטקטורת REST
ישויות של מחלקות – כמו שירות, משאב, enum ושגיאה – בספריית הלקוח של Perl נוצרות על ידי ניתוח של הגדרות מאגר האחסון לפרוטוקולים. למידע נוסף על האופן שבו נתונים מובְנים עוברים סריאליזציה, עיינו במסמכי התיעוד של מאגר האחסון לפרוטוקולים.
כדי להתחבר ל-Google Ads API, ספריית הלקוח יוצרת בקשת HTTP ב-JSON, שולחת אותה לנקודת הקצה של REST דרך HTTP 1.1, מבטלת את ההסדרה של התגובה כאובייקט JSON ומפרשת את התוצאות.
התקנת הספרייה
ספריית הלקוח של Perl מתארחת ב-GitHub ומופצת באמצעות CPAN.
התקנה מ-CPAN
מתקינים את ההפצה Google::Ads::GoogleAds::Client ישירות מ-CPAN באמצעות cpanm (או cpan):
cpanm Google::Ads::GoogleAds::Client
בנייה מקוד המקור והרצת דוגמאות
כדי להריץ את דוגמאות הקוד המצורפות או ליצור את הספרייה מהמקור:
משכפלים את הספרייה מ-GitHub:
git clone https://github.com/googleads/google-ads-perl.gitעוברים לספרייה
google-ads-perl:cd google-ads-perlיוצגו כמה קבצים וספריות משנה:
-
Build.PL: קובץ ה-build של Perl, שמכיל את יחסי התלות וסוגי הבדיקות של הפרויקט הזה. -
lib: קוד המקור של הספרייה. -
t: מקרי בדיקה של קוד הספרייה. -
examples: דוגמאות רבות שמראות איך להשתמש בספרייה כדי להפעיל תרחישים נפוצים באמצעות Google Ads API. -
googleads.properties: קובץ התצורה לדוגמה של הספרייה. log4perl.conf: קובץ התצורה לדוגמה של הרישום ביומן.
-
מתקינים את הרכיבים התלויים הנדרשים ויוצרים את הספרייה. בקובץ
Build.PLמפורטים כל הרכיבים התלויים שנדרשים לספרייה. כדי להתקין אותם, מריצים את הפקודות הבאות:cpan install Module::Build perl Build.PL ./Build installdeps ./Build ./Build install
שליחת הקריאה הראשונה ל-API
כדי להשתמש ב-Google Ads API, צריך לבצע כמה שלבים כדי לקבל גישה ל-API ולהגדיר את החשבונות ב-Google Ads. במדריך למתחילים מפורטים כל השלבים החשובים, כולל הגדרת חשבונות Google Ads.
שימוש בסיסי
מאתחלים את Google::Ads::GoogleAds::Client (שמטעין את פרטי הכניסה מ-~/googleads.properties או מ-GOOGLE_ADS_CONFIGURATION_FILE_PATH כברירת מחדל) ומעבירים בסטרימינג את שורות הקמפיין באמצעות SearchStreamHandler:
use strict;
use warnings;
use Google::Ads::GoogleAds::Client;
use Google::Ads::GoogleAds::Utils::SearchStreamHandler;
use Google::Ads::GoogleAds::V26::Services::GoogleAdsService::SearchGoogleAdsStreamRequest;
my $api_client = Google::Ads::GoogleAds::Client->new();
my $google_ads_service = $api_client->GoogleAdsService();
my $search_stream_request =
Google::Ads::GoogleAds::V26::Services::GoogleAdsService::SearchGoogleAdsStreamRequest
->new({
customerId => "INSERT_CUSTOMER_ID_HERE",
query =>
"SELECT campaign.id, campaign.name FROM campaign ORDER BY campaign.id"
});
my $search_stream_handler =
Google::Ads::GoogleAds::Utils::SearchStreamHandler->new({
service => $google_ads_service,
request => $search_stream_request
});
$search_stream_handler->process_contents(
sub {
my $google_ads_row = shift;
printf "Campaign with ID %d and name '%s' was found.\n",
$google_ads_row->{campaign}{id},
$google_ads_row->{campaign}{name};
});
במדריך השימוש הבסיסי מוסבר איך להשתמש בספריית הלקוח של Perl.
אימות והרשאה
ספריית הלקוח של Perl תומכת בכמה גישות לאימות ולהרשאה. למידע נוסף, קראו את המדריך אימות והרשאה.
הגדרות ורישום ביומן
ספריית הלקוח של Perl משתמשת ב-googleads.properties להגדרה וב-log4perl.conf לרישום ביומן. אפשר לשנות את הקבצים האלה כדי להתאים אישית את ההתנהגות של הספרייה. מידע נוסף זמין במדריכים בנושא הגדרה ורישום ביומן.
שירותים
ספריית הלקוח של Perl כוללת מחלקות של כלי שירות שמשפרות את נוחות השימוש ב-API. למידע נוסף, אפשר לעיין במדריכים הבאים:
שיפור ביצועי האפליקציה
במדריך לשיפור הביצועים מפורטות המלצות לשיפור הביצועים של האפליקציה.