תצורת ספריית לקוח Java

הספרייה מחפשת קובץ תצורה ב-System.getProperty("user.home") + "/searchads360.properties".

הפורמט של קובץ התצורה הוא זה של קובץ מאפייני Java שכולל צמדי ערכי מפתח. המפתחות הנתמכים משתנים בהתאם לתהליך האימות שנבחר.

מפתחות נתמכים לתהליכי עבודה בשולחן העבודה ובאפליקציית אינטרנט

אם משתמשים בתהליך של אפליקציית מחשב או אינטרנט, המפתחות הנתמכים הם:

# Credential for accessing Google's OAuth servers.
# Provided by console.cloud.google.com.
api.searchads360.clientId=INSERT_CLIENT_ID_HERE

# Credential for accessing Google's OAuth servers.
# Provided by console.cloud.google.com.
api.searchads360.clientSecret=INSERT_CLIENT_SECRET_HERE

# Renewable OAuth credential associated with 1 or more Search Ads accounts.
api.searchads360.refreshToken=INSERT_REFRESH_TOKEN_HERE

# Required for manager accounts only: Specify the login customer ID used to
# authenticate API calls. This will be the customer ID of the authenticated
# manager account. You can also specify this later in code if your application
# uses multiple manager account + OAuth pairs.
#
# api.searchads360.loginCustomerId=INSERT_LOGIN_CUSTOMER_ID_HERE

הערה: ניתן ליצור אסימון רענון של OAuth על ידי הרצת הסקריפט ליצירת פרטי כניסה של משתמש שסופק, או באמצעות הכלי OAuth Playground.

שילוב גישות של תצורה

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

SearchAds360Client searchAds360Client = SearchAds360Client.newBuilder()
    .fromPropertiesFile()
    .build();

אפשר לבצע שינויים נוספים בזמן הריצה באמצעות שיטות ההגדרה האחרות של ה-builder לפני שמפעילים את build().

אם אתם מבצעים אימות בתור חשבון ניהול, בנוסף צריך לציין את הפרטים הבאים:

api.searchads360.loginCustomerId --> Manager account ID (with hyphens removed).