שימוש בסיסי

כך משתמשים בספריית הלקוח של Java:

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

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

כדי לנהל את גרסאות התלות, משתמשים ב-Bill of Materials (BOM)‎ של Google Ads API.

אם אתם רוצים להריץ את דוגמאות הקוד שכלולות במודול google-ads-examples, אתם צריכים לשכפל את המאגר google-ads-java מ-GitHub או לבנות מקוד המקור. אם אתם בונים מקוד מקור, ודאו שהפעלתם עיבוד אנוטציות ב-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"

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

החבילה examples ב-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'