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 trong 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 như 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 được quản lý bằng cấu hình thư viện ứng dụng. Dưới đây là thông tin chi tiết về các loại tuỳ chọn cấu hình khác nhau có sẵn.
Thư viện này sử dụng tính năng ghi nhật ký tích hợp sẵn của Python
khung và nhật ký vào stderr theo mặc định. Nếu có, đối tượng logging
được xác định trong cấu hình 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 ghi nhật ký theo phương thức lập trình bằng cách đặt tính năng ghi nhật ký cấu hình trước khi khởi chạy ứng dụng. Bạn có thể truy xuất ứng dụng thực thể của trình ghi nhật ký và định cấu hình phiên bản đó trong 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. Bất kỳ hạng nào các 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ớ hãy 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 số cấp độ khác nhau và bạn có thể thiết lập để xem một số hoặc tất cả các mục 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 sẽ bỏ qua thông điệp nhật ký ít nghiêm trọng hơn
so với cấp độ đã định cấu hình, thì việc đặt thành WARNING có nghĩa là bạn sẽ chỉ thấy
thông báo ngắn gọn liên quan đến các yêu cầu không thực hiện được, 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.
Đ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 gRPC trình chặn để truy cập và ghi nhật ký yêu cầu và chi tiết câu trả lờ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 gRPC chặn bằng logic tuỳ chỉnh. Xem phần Ghi nhật ký hướng dẫn để 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.