Bạn có thể thiết lập thư viện này để 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 nhật ký 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à các nhật ký vào stderr. Nếu có, đối tượng logging đã xác định trong cấu hình của bạn sẽ được chuyể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 theo dõi ứng dụng rồi đị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 chạy. 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 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 cấp độ 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 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 với các đối tượng yêu cầu hoàn chỉnh và các đối tượng ngoại lệ dưới dạng JSON. |
INFO |
Một 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 hoàn chỉnh và các đối tượng ngoại lệ dưới dạng JSON. |
WARNING |
Không có | Tóm tắt ngắn gọn với 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 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 báo ngắn gọn liên quan đến các yêu cầu không thành công, nhưng đặ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.
Đ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ý đến 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ý thông tin chi tiết về yêu cầu và phản hồi. Bạn có thể thiết lập 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. 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.