השימוש הבסיסי בספריית הלקוח הוא כדלקמן:
התקנה
הדרך המומלצת להתקין את התוסף היא באמצעות 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, אתם יכולים להשתמש באחת מהאפשרויות הבאות:
- מתקינים את הספרייה הזו באמצעות gem:
terminal $ [sudo] gem install google-ads-googleads - מורידים את ה-gem מדף הגרסאות ומתקינים אותו מהקובץ המקומי:
terminal $ [sudo] gem install google-ads-googleads-[version].gem
הגדרת אימות
כדי לאמת את קריאות ה-API, פועלים לפי ההוראות בדף בנושא אימות והרשאה.
שימוש
כדי לכלול את אבן החן בקוד:
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