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

کتابخانه به دنبال یک فایل پیکربندی در System.getProperty("user.home") + "/searchads360.properties" می گردد.

فرمت فایل پیکربندی فرمت یک فایل Java Properties از جفت مقادیر کلید است. کلیدهای پشتیبانی شده بسته به جریان احراز هویت انتخاب شده متفاوت است.

کلیدهای پشتیبانی شده برای جریان های دسکتاپ و برنامه های وب

اگر از دسکتاپ یا جریان برنامه وب استفاده می کنید، کلیدهای پشتیبانی شده به شرح زیر است:

# 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 Playground، یک نشانه به‌روزرسانی OAuth ایجاد کنید.

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

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

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

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

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

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