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

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

ملاحظة: يمكنك إنشاء رمز مميَّز لإعادة تحميل OAuth عن طريق تشغيل النص البرمجي لإنشاء بيانات اعتماد المستخدم المقدَّم أو باستخدام أداة OAuth Playground.

الجمع بين نُهُج الضبط

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

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

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

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

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