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

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

הפורמט של קובץ התצורה הוא קובץ 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).