Bạn có thể định cấu hình thư viện để ghi lại các lượt 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 hiện có.
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 thiết lập 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)
Xin lưu ý rằng trình ghi nhật ký ứng dụng được định cấu hình khi ứng dụng được khởi tạo. Mọi thay đổi sau đó đố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 khởi chạy ứng dụng.
Các cấp độ nhật ký
Ứng dụng tạo nhật ký ở một vài cấp độ và bạn có thể thiết lập cấu hình để xem một số hoặc tất cả các nhật ký dưới đây:
| 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 với các đối tượng yêu cầu và phản hồi hoàn chỉnh dưới dạng JSON. | Nhật ký chi tiết với các đối tượng yêu cầu và ngoại lệ hoàn chỉnh dưới dạng JSON. |
INFO |
Bản tóm tắt ngắn gọn với các trường yêu cầu và phản hồi cụ thể. | Nhật ký chi tiết với các đối tượng yêu cầu và ngoại lệ hoàn chỉnh dưới dạng JSON. |
WARNING |
Không có | Bản tóm tắt ngắn gọn có thông tin yêu cầu cụ thể, trạng thái ngoại lệ và thông báo. |
Vì khung ghi nhật ký Python bỏ qua các 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 các thông điệp ngắn gọn liên quan đến các yêu cầu không thành công, nhưng việc đặt thành DEBUG có nghĩa là bạn sẽ thấy tất cả các loại nhật ký có thể có trong bảng trên.
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
Trình chặn ghi nhật ký
Thư viện ứng dụng Python sử dụng trình chặn gRPC để truy cập và ghi nhật ký yêu cầu cũng như thông tin chi tiết 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 trình chặn gRPC có logic tuỳ chỉnh. Hãy 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.