שימוש בסיסי

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

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

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

אפשר להשתמש ברשימת החומרים (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'