تستخدم Google تكنولوجيا الذكاء الاصطناعي لترجمة المحتوى إلى لغتك المفضّلة، وقد تتضمّن بعض الأخطاء.

ضبط التسجيل

يتم ضبط عملية تسجيل الدخول في مكتبة عميل Java باستخدام SLF4J، وهي واجهة عامة لتسجيل الدخول في Java تتيح توجيه السجلّات إلى العديد من عمليات تنفيذ تسجيل الدخول المختلفة، مثل Log4j 2 أو Logback أو java.util.logging (JUL). نوفّر ملفات إعداد نموذجية لكل من Log4j 2 وJUL.

تنسيق السجلّ ووظائفه

يتم تسجيل الطلبات مع ملخّص من سطر واحد ونص وعناوين الطلب والاستجابة الكاملة.

نوع السجلّ	اسم السجلّ	مستوى النجاح	مستوى الخطأ
الملخّص	com.google.ads.googleads.lib.request.summary	معلومات	WARN
التفصيل	com.google.ads.googleads.lib.request.detail	تصحيح الأخطاء	معلومات

اقتطاع سجلّ التفاصيل

يتم تلقائيًا اقتطاع السجلّات التفصيلية لتجنُّب إنشاء سجلّات كبيرة. لتغيير طول السجلات التي يتم اقتطاعها، اضبط خاصية JVM -Dapi.googleads.maxLogMessageLength=<number>. يؤدي ضبط -1 إلى إيقاف اقتطاع السجلّ.

Log4j 2

أضِف عنصرًا تابعًا لمكتبة log4j-slf4j2-impl، واستبدِل 2.x.y بإصدار Log4j 2 الذي تستخدمه في مشروعك:

<dependency>
  <groupId>org.apache.logging.log4j</groupId>
  <artifactId>log4j-slf4j2-impl</artifactId>
  <version>2.x.y</version>
</dependency>

(اختياري) أنشئ ملف إعداد log4j2.xml في دليل الموارد (على سبيل المثال، src/main/resources في Maven). يحمّل Log4j 2 ملف الإعدادات من مسار الفئة، وليس من دليل العمل، لذا احرص على إنشائه في دليل الموارد.
نفِّذ تطبيقك مع تحديد -Dlog4j.configurationFile=<CONFIG_FILE_PATH>. يمكنك تحديد CONFIG_FILE_PATH=googleads-logging/log4j2.xml لاستخدام ملف الإعداد التلقائي المضمّن في مكتبة العميل.

‫Log4j 1.2 (الإصدار القديم)

أضِف تبعية إلى مكتبة slf4j-log4j12، واستبدِل 1.x.y بإصدار Log4j 1.2 الذي تستخدمه في مشروعك:
```
<dependency>
  <groupId>org.slf4j</groupId>
  <artifactId>slf4j-log4j12</artifactId>
  <version>1.x.y</version>
</dependency>
```
(اختياري) أنشئ ملف إعدادات في دليل موارد مشروعك، مثل src/main/resources في Maven. يحمّل Log4j 1.2 ملف الإعدادات من مسار الفئة، وليس من دليل العمل، لذا احرص على نسخه إلى دليل الموارد.
شغِّل تطبيقك مع تحديد -Dlog4j.configuration=<CONFIG_FILE_PATH>. يمكنك تحديد CONFIG_FILE_PATH=googleads-logging/log4j.properties لاستخدام ملف الإعداد التلقائي المضمّن في مكتبة العميل.

Java Util Logging

أضِف تبعية إلى مكتبة slf4j-jdk14، واستبدِل 2.x.y بإصدار SLF4J المستخدَم في مشروعك:

<dependency>
  <groupId>org.slf4j</groupId>
  <artifactId>slf4j-jdk14</artifactId>
  <version>2.x.y</version>
</dependency>

أنشئ ملف إعداد JUL في نظام الملفات في مسار يمكن قراءته من تطبيقك (على سبيل المثال، ./jdk-logger.properties). يتوفّر نموذج في google-ads/src/main/resources/googleads-logging/jdk-logger.properties. يقرأ JUL من نظام الملفات فقط، لذا لا تنسخها إلى دليل موارد classpath فقط.
نفِّذ تطبيقك مع تحديد -Djava.util.logging.config.file=./jdk-logger.properties.