שימוש בסיסי

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

יצירת פרויקט חדש ב-Maven או ב-Gradle

יוצרים פרויקט חדש של Maven או Gradle בסביבת הפיתוח המשולבת (IDE) לפי בחירתכם. הארטיפקטים מתפרסמים ב-Maven Central repository.

אפשר להשתמש ברשימת החומרים (BOM) של Google Ads API כדי לנהל את גרסאות התלות.

אם רוצים להריץ את דוגמאות הקוד שכלולות במודול google-ads-examples, צריך לשכפל את המאגר google-ads-java מ-GitHub או לבצע build ממקור. אם אתם בונים מתוך מקור, אתם צריכים לוודא שהפעלתם את עיבוד ההערות בסביבת הפיתוח המשולבת (IDE).

הגדרת גישה ל-API

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

ביצוע השיחה הראשונה

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

כדי לאמת את פרטי הכניסה ולבצע את הקריאה הראשונה באמצעות מאגר google-ads-java המשוכפל, מריצים את הדוגמה GetCampaigns.

קודם נכנסים לספרייה google-ads-examples:

cd google-ads-examples

בדוגמה הזו נדרש פרמטר --customerId שהערך שלו הוא מספר הלקוח שלכם ב-Google Ads בלי מקפים (-).

כדי להריץ עם Gradle:

./gradlew -q runExample \
  --example="basicoperations.GetCampaigns --customerId INSERT_CUSTOMER_ID_HERE"

כדי להריץ עם Maven:

mvn exec:java \
  -Dexec.mainClass="com.google.ads.googleads.examples.basicoperations.GetCampaigns" \
  -Dexec.args="--customerId INSERT_CUSTOMER_ID_HERE"

דוגמאות נוספות

חבילת הדוגמאות ב-google-ads-examples כוללת כמה דוגמאות שימושיות. לרוב הדוגמאות נדרשים פרמטרים. אפשר להעביר את הפרמטרים כארגומנטים (מומלץ) או לערוך את ערכי הפלייסולדר INSERT_..._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'