ספריית לקוח של 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>48.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

כדי להשתמש ב-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 אסינכרוניות.

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

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