Bạn có thể định cấu hình thư viện này để ghi nhật ký các hoạt động tương tác với API Google Ads theo nhiều cách. Bạn có thể ghi lại các yêu cầu và phản hồi chi tiết, cũng như các thông báo tóm tắt ngắn gọn hơn. Các chế độ cài đặt này do cấu hình thư viện ứng dụng quản lý. Dưới đây là thông tin chi tiết về các loại tuỳ chọn cấu hình có sẵn.
Theo mặc định, thư viện này sử dụng khung ghi nhật ký tích hợp sẵn của Python và ghi nhật ký vào stderr. Nếu được đưa vào, đối tượng logging được xác định trong cấu hình của bạn sẽ được truyền trực tiếp đến logging.config.dictConfig dưới dạng dict.
Bạn cũng có thể định cấu hình tính năng ghi nhật ký theo phương thức lập trình bằng cách đặt cấu hình ghi nhật ký trước khi khởi chạy ứng dụng. Bạn có thể truy xuất thực thể trình ghi nhật ký ứng dụng và định cấu hình thực thể đó bằng ví dụ sau:
import logging
logging.basicConfig(level=logging.INFO, format='[%(asctime)s - %(levelname)s] %(message).5000s')
logging.getLogger('google.ads.googleads.client').setLevel(logging.INFO)
Lưu ý rằng trình ghi nhật ký ứng dụng được định cấu hình khi khởi động ứng dụng. Mọi thay đổi tiếp theo đối với cấu hình ghi nhật ký sẽ bị bỏ qua. Để ghi đè cấu hình ghi nhật ký trong tệp YAML theo phương thức lập trình, hãy nhớ gọi các dòng trên trước khi ứng dụng được khởi chạy.
Các cấp độ nhật ký
Ứng dụng sẽ tạo nhật ký ở một số cấp độ và bạn có thể đặt cấu hình để xem một số hoặc tất cả các cấp bên dưới:
| Cấp | Yêu cầu thành công | Yêu cầu không thành công |
|---|---|---|
DEBUG |
Nhật ký chi tiết chứa các đối tượng yêu cầu và phản hồi hoàn chỉnh ở dạng JSON. | Nhật ký chi tiết chứa các đối tượng ngoại lệ và yêu cầu đầy đủ dưới dạng JSON. |
INFO |
Bản tóm tắt ngắn gọn có các trường yêu cầu và phản hồi cụ thể. | Nhật ký chi tiết chứa các đối tượng ngoại lệ và yêu cầu đầy đủ dưới dạng JSON. |
WARNING |
Không có | Bản tóm tắt ngắn gọn có thông tin cụ thể về yêu cầu, trạng thái ngoại lệ và thông báo. |
Vì khung ghi nhật ký Python bỏ qua thông điệp nhật ký ít nghiêm trọng hơn cấp độ đã định cấu hình, nên việc đặt thành WARNING có nghĩa là bạn sẽ chỉ thấy thông điệp ngắn gọn liên quan đến các yêu cầu không thành công. Tuy nhiên, nếu đặt thành DEBUG, bạn sẽ thấy mọi loại nhật ký có thể có trong bảng trên.
Đang ghi nhật ký vào tệp
Bạn có thể dễ dàng chuyển thông điệp nhật ký vào một tệp; ví dụ: khi chạy ví dụ về get_campaigns:
python get_campaigns.py -c $CLIENT_ID 2> example.log
Ghi nhật ký trình chặn
Thư viện ứng dụng Python sử dụng các trình chặn gRPC để truy cập và ghi nhật ký thông tin chi tiết về yêu cầu và phản hồi. Bạn có thể thiết lập tính năng ghi nhật ký tuỳ chỉnh của riêng mình bằng cách tạo một trình chặn gRPC với logic tuỳ chỉnh. Vui lòng xem Hướng dẫn ghi nhật ký để biết thêm thông tin chi tiết và ví dụ về trình chặn ghi nhật ký tuỳ chỉnh.