پیکربندی کتابخانه کارخواه جاوا

کتابخانه به‌دنبال فایل پیکربندی در 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

ترکیب رویکردهای پیکربندی

‫SearchAds360Client و سازنده آن از ترکیب استراتژی‌های پیکربندی مختلف پشتیبانی می‌کنند. برای مثال، می‌توانید از فایل ویژگی‌ها برای پیکربندی اعتبارنامه نمونه و برای سایر مشخصه‌ها بااستفاده از قطعه کد زیر استفاده کنید.

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

می‌توانید بااستفاده از دیگر روش‌های پیکربندی سازنده، تغییرات بیشتری در زمان اجرا قبل‌از فراخوانی build() ایجاد کنید.

اگر به‌عنوان حساب مدیر اصالت‌سنجی می‌کنید، باید موارد زیر را نیز مشخص کنید:

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