ספריית לקוח של Google Ads API ל-Java

ספריית הלקוח של Java מתארחת ב-GitHub ומופצת דרך Maven Central. הספרייה כוללת כמה תכונות שיעזרו לכם להשתמש בממשק ה-API, כולל ניהול קל יותר של פרטי הכניסה ויצירה של לקוחות שירות של Google Ads API.

הספרייה דורשת Java 8 ואילך.

התקנה

כדי לנהל גרסאות של תלות, משתמשים ב-Google Ads API Bill of Materials (BOM) בקובץ pom.xml או build.gradle:

<!-- Import the Bill of Materials (BOM) to ensure you're using compatible
     versions of all google-ads libraries. -->
<dependencyManagement>
  <dependencies>
    <dependency>
      <groupId>com.google.api-ads</groupId>
      <artifactId>google-ads-bom</artifactId>
      <version>47.0.0</version>
      <type>pom</type>
      <scope>import</scope>
    </dependency>
  </dependencies>
</dependencyManagement>

<!-- Add the google-ads dependency, without a version. The version is
     managed by the BOM. -->
<dependency>
  <groupId>com.google.api-ads</groupId>
  <artifactId>google-ads</artifactId>
</dependency>

אפשר גם לבנות את הספרייה מהמקור.

ביצוע הקריאה הראשונה ל-API

ספריית הסרטונים: תחילת העבודה עם ספריית הלקוח של Java

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

שימוש בסיסי

במדריך לשימוש בסיסי מוסבר איך להגדיר פרויקט, ליצור מופעים של לקוחות שירות ולהריץ דוגמאות קוד באמצעות ספריית הלקוח של Java.

אימות והרשאה

ספריית הלקוח של Java תומכת בכמה גישות לאימות ולהרשאה, כולל תהליכי OAuth 2.0 לאפליקציות אינטרנט ולאפליקציות למחשב, חשבונות שירות ו-Application Default Credentials ‏(ADC). מידע נוסף זמין במדריך לאימות והרשאה.

הגדרות ורישום ביומן

ספריית הלקוח של Java תומכת בכמה אפשרויות הגדרה (כולל קובצי ads.properties, משתני סביבה והגדרה באמצעות תכנות) וביכולות רישום ביומן למעקב אחרי בקשות ותגובות של API.

כלי תחזוקה

ספריית הלקוח של Java כוללת מחלקות כלי עזר לשיפור השימושיות של ה-API. במדריכים הבאים אפשר למצוא מידע נוסף:

  • ‫FieldMasks: כלים לעזרה ביצירה ובחישוב של מסכות שדות לעדכון.
  • ‫ResourceNames: כלי עזר לעיצוב מחרוזות של שמות משאבים של ישויות.
  • פעולות ממושכות: כלים לעזרה במעקב אחרי פעולות אסינכרוניות של API ובניהול שלהן.

שיפור האפליקציה

במדריך לשימוש מתקדם יש המלצות לאופטימיזציה של הגדרות הזמן הקצוב לתפוגה, הניסיון החוזר, זמן האחזור של ההפעלה וניהול התלות באפליקציה.