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

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

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

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

ישויות של מחלקות – כמו שירות, משאב, 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

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

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

שימוש בסיסי

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

אימות והרשאה

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

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

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

כלי תחזוקה

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

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

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