השימוש הבסיסי בספריית הלקוח של Java הוא כדלקמן:
יצירת פרויקט חדש של Maven או Gradle
יוצרים פרויקט חדש של Maven או Gradle בסביבת הפיתוח המשולבת (IDE) לפי בחירתכם. הארטיפקטים שלנו מתפרסמים במאגר Maven המרכזי.
מומלץ להשתמש ברשימת החומרים (BOM) של Google Ads API כדי לנהל גרסאות של יחסי תלות.
אפשר גם לבנות ממקור. לצורך המדריך הזה, נניח שיש לכם פרויקט מוגדר עם התלויות הנדרשות.
אם אתם בונים מתוך קוד המקור, אתם צריכים לוודא שהפעלתם את עיבוד ההערות בסביבת הפיתוח המשולבת (IDE).
הגדרת גישה ל-API
כדי להתחבר אל Google Ads API, צריך לספק פרטי אימות והרשאה. במדריך בנושא אימות והרשאה מוסבר אילו פרטי כניסה נדרשים ואיך מגדירים את ספריית הלקוח.
ביצוע השיחה הראשונה
אחרי שמגדירים את פרטי הכניסה, אפשר לבצע את הקריאה הראשונה ל-API.
כדי לאמת את פרטי הכניסה ולבצע את הקריאה הראשונה, נריץ את הדוגמה GetCampaigns.
קודם מנווטים לספרייה google-ads-examples.
cd google-ads-examples
בדוגמה הזו נדרש פרמטר --customerId שהערך שלו הוא מספר הלקוח שלכם בחשבון Google Ads ללא מקפים.
כדי להריץ עם Gradle:
./gradlew -q runExample --example="basicoperations.GetCampaigns --customerId INSERT_CUSTOMER_ID_HERE"
דוגמאות נוספות
חבילת examples ב-google-ads-examples
כוללת כמה דוגמאות שימושיות. לרוב הדוגמאות נדרשים פרמטרים. אפשר להעביר את הפרמטרים כארגומנטים (מומלץ) או לערוך את הערכים של INSERT_XXXXX_HERE בקוד המקור. כדי לראות דוגמה של הצהרת שימוש, מעבירים את --help כארגומנט היחיד.
עם Gradle:
./gradlew -q runExample --example="basicoperations.GetCampaigns --help"
אפשר גם להשתמש במשימה listExamples ב-Gradle כדי להציג רשימה של כל הדוגמאות, של דוגמאות בספריית משנה או של דוגמאות שהתיאור שלהן כולל מונח חיפוש.
# List all examples:
./gradlew -q listExamples
# List examples in the 'basicoperations' subdirectory:
./gradlew -q listExamples --subdirectory='basicoperations'
# Search for examples where the description includes 'Performance Max':
./gradlew -q listExamples --searchTerm='Performance Max'