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

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

الجمع بين مناهج التهيئة

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

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

يمكنك إجراء المزيد من التغييرات في وقت التشغيل باستخدام طرق الإعداد الأخرى في أداة الإنشاء قبل طلب build().

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

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