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

ضبط التسجيل

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

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

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

نوع السجلّ	اسم السجلّ	مستوى النجاح	مستوى الخطأ
الملخّص	com.google.ads.googleads.lib.request.summary	معلومات	تحذير
التفصيل	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 من نظام الملفات فقط، لذا لا تنسخ الملف إلى دليل موارد مسار الفئة فقط.
شغِّل تطبيقك مع تحديد -Djava.util.logging.config.file=./jdk-logger.properties.