ספריית הלקוח של Perl

ספריית הלקוח של Perl מתארחת ב-GitHub, והחבילה זמינה ב-CPAN.

הספרייה תומכת ב-Perl מגרסה 5.28.1 ואילך.

פרוטוקול API בארכיטקטורת REST

הערה: Google Ads API חושף גם נקודות קצה סטנדרטיות של JSON REST וגם ממשק gRPC עם ביצועים גבוהים. ‫Perl היא לא שפה נתמכת במערך gRPC, ולכן ספריית הלקוח הזו מיושמת בפרוטוקול JSON REST דרך HTTP 1.1.

ישויות של מחלקות – כמו שירות, משאב, enum ושגיאה – בספריית הלקוח של Perl נוצרות על ידי ניתוח של הגדרות מאגר אחסון לפרוטוקולים. מידע נוסף על סריאליזציה של נתונים מובְנים זמין במאמרי העזרה של מאגר אחסון לפרוטוקולים.

כדי להתחבר אל Google Ads API, ספריית הלקוח יוצרת בקשת HTTP בפורמט JSON, שולחת אותה לנקודת הקצה של REST באמצעות HTTP 1.1, מבצעת דה-סריאליזציה של התגובה כאובייקט JSON ומפרשת את התוצאות.

התקנת הספרייה

ספריית הלקוח של Perl מתארחת ב-GitHub ומופצת באמצעות CPAN.

1. משכפלים את הספרייה מ-GitHub:

   git clone https://github.com/googleads/google-ads-perl.git
   

2. עוברים לספרייה google-ads-perl:

   cd google-ads-perl
   

   יוצגו כמה קבצים ותיקיות משנה:

   • ‫Build.PL: קובץ ה-build של Perl, שמכיל את התלות ואת סוגי הבדיקות של הפרויקט הזה.
   • ‫lib: קוד המקור של הספרייה.
   • ‫t: תרחישי בדיקה של קוד הספרייה.
   • ‫examples: דוגמאות רבות שמדגימות איך להשתמש בספרייה כדי להריץ תרחישי שימוש נפוצים באמצעות Google Ads API.
   • ‫googleads.properties: קובץ התצורה לדוגמה של הספרייה.
   • ‫log4perl.conf: קובץ ההגדרות לדוגמה של הרישום ביומן.

3. מתקינים את יחסי התלות הנדרשים ובונים את הספרייה. בBuild.PL הקובץ מפורטים כל הרכיבים התלויים שנדרשים לספרייה. כדי להתקין אותם, מריצים את הפקודות הבאות:

   cpan install Module::Build
   perl Build.PL
   ./Build installdeps
   ./Build
   ./Build install
   

הערה: כל מהדורת Google::Ads::GoogleAds::Client כוללת מודולים של גרסאות ספציפיות של Google Ads API בתיקייה lib/Google/Ads/GoogleAds/ (שבה מהדורות משניות של API כמו v25.1 נכללות במודול של הגרסה הראשית שלהן, V25). בטבלה גרסאות ה-API הנתמכות מפורטת תאימות הגרסאות.

ביצוע הקריאה הראשונה ל-API

כדי להשתמש ב-Google Ads API, צריך לבצע כמה שלבים כדי לקבל גישה ל-API ולהגדיר את חשבונות Google Ads. כדאי לעיין במדריך לתחילת העבודה, שכולל את כל השלבים החשובים, כולל הגדרת חשבונות Google Ads.

שימוש בסיסי

מידע נוסף על השימוש בספריית הלקוח של Perl מופיע במדריך לשימוש בסיסי.

אימות והרשאה

ספריית הלקוח של Perl תומכת בכמה גישות לאימות ולהרשאה. מידע נוסף זמין במדריך בנושא אימות והרשאה.

הגדרות ורישום ביומן

ספריית הלקוח של Perl משתמשת ב-googleads.properties להגדרה וב-log4perl.conf לרישום ביומן. אפשר לשנות את הקבצים האלה כדי להתאים אישית את ההתנהגות של הספרייה. מידע נוסף מופיע במדריכים בנושא הגדרה ורישום ביומן.

כלי תחזוקה

ספריית הלקוח של Perl כוללת מחלקות כלי עזר לשיפור השימושיות של ה-API. במדריכים הבאים אפשר למצוא מידע נוסף:

• מסכות שדות
• שמות משאבים

שיפור הביצועים של האפליקציה

כדאי לעיין במדריך לשיפור הביצועים כדי לקבל המלצות לאופטימיזציה של הביצועים של האפליקציה.