שימוש בסיסי

השימוש הבסיסי בספריית הלקוח הוא כדלקמן:

התקנה

הדרך המומלצת להתקין את התוסף היא באמצעות bundler. מוסיפים שורה ל-Gemfile (מחליפים את x.y.z במספר הגרסה שמעניינת אתכם):

gem 'google-ads-googleads', '~> x.y.z'

ואז מריצים:

$ bundle install

הפקודה הזו משתמשת ב-bundler כדי לעדכן את Gemfile.lock, ולנעול את הגרסה המדויקת של ה-gem ואת כל התלויות של ה-gem שהותקנו. אופרטור הגרסה הפסימיסטי "~> x.y.z" גורם לכך ש-bundle update יתקין רק גרסאות חדשות בסדרה x.y.*, ולכן צריך לעדכן את Gemfile שוב כדי להסכים ידנית לגרסאות חדשות.

אפשרויות התקנה אחרות

אם אתם לא משתמשים ב-bundler, אתם יכולים להשתמש באחת מהאפשרויות הבאות:

1. כדי להתקין את הספרייה הזו באמצעות gem: terminal $ [sudo] gem install google-ads-googleads
2. מורידים את ה-gem מדף הגרסאות ומתקינים אותו מהקובץ המקומי: terminal $ [sudo] gem install google-ads-googleads-[version].gem

הגדרת אימות

כדי לאמת את הקריאות ל-API, פועלים לפי ההוראות בדף בנושא אימות והרשאה.

שימוש

כדי לכלול את ה-Gem בקוד:

require 'google/ads/google_ads'

כדי לאחזר שירות ספציפי, למשל CampaignService:

client = Google::Ads::GoogleAds::GoogleAdsClient.new
campaign_service = client.service.campaign

בדוגמאות ב-GitHub אפשר לראות הדגמות מפורטות יותר של אופן השימוש בספרייה.

אחרי שתכירו את הדוגמאות, מומלץ גם להכיר את הפקטורים, שמספקים קבוצה של שיטות נוחות ברמה גבוהה לעבודה עם Google Ads API.

טיפול בשגיאות

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

מופעלת מופע GoogleAdsException כשמתרחשת שגיאה ב-API. הוא כולל פרטים שיעזרו לכם להבין מה השתבש, ותוכלו להגדיר פונקציית עזר לטיפול בשגיאות. דוגמה לטיפול בשגיאות ב-GitHub