تهيئة مكتبة عميل جافا

تبحث المكتبة عن ملف إعداد في 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

الجمع بين طرق الضبط

يتيح SearchAds360Client وأدوات إنشائه الجمع بين استراتيجية ملف التكوين المختلفة. على سبيل المثال، يمكنك استخدام ملف خصائص لضبط بيانات اعتماد المثيل وللسمات الأخرى باستخدام المقتطف التالي.

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

يمكنك إجراء تغييرات أخرى أثناء التشغيل باستخدام methods غيرها من إعدادات المُنشئ قبل استدعاء build().

في حال المصادقة بصفتك حسابًا إداريًا، عليك أيضًا تحديد ما يلي:

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