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

تبحث المكتبة عن ملف إعداد في 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 من خلال تشغيل النص البرمجي المقدَّم لإنشاء بيانات اعتماد المستخدم أو باستخدام الأداة OAuth Playground.

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

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

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

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

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

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