Kitaplık, Google Ads API ile etkileşimleri çeşitli şekillerde günlüğe kaydedecek şekilde yapılandırılabilir. Ayrıntılı istek ve yanıtların yanı sıra daha kısa ve öz özet mesajları günlüğe kaydedebilirsiniz. Bu ayarlar, istemci kitaplığı yapılandırması tarafından yönetilir. Aşağıda, kullanılabilen farklı yapılandırma seçeneği türleri ile ilgili ayrıntılar verilmiştir.
Kitaplık, Python'un yerleşik günlük kaydı çerçevesi ve günlüklerini varsayılan olarak stderr
kullanır. Eklenmesi durumunda yapılandırmanızda tanımlanan logging
nesnesi, dict
olarak doğrudan logging.config.dictConfig
'e iletilir.
İstemciyi başlatmadan önce bir günlük kaydı yapılandırması ayarlayarak günlük kaydını programatik olarak yapılandırabilirsiniz. Clientlogger örneğini alıp aşağıdaki örnekle yapılandırabilirsiniz:
import logging
logging.basicConfig(level=logging.INFO, format='[%(asctime)s - %(levelname)s] %(message).5000s')
logging.getLogger('google.ads.googleads.client').setLevel(logging.INFO)
İstemci başlatıldığında istemci günlük kaydedicinin yapılandırıldığını unutmayın. Günlük kaydı yapılandırmasında daha sonra yapılacak değişiklikler yoksayılır. YAML dosyasındaki günlük kaydı yapılandırmasını programatik olarak geçersiz kılmak için yukarıdaki satırları istemci başlatılmadan önce çağırdığınızdan emin olun.
Günlük seviyeleri
İstemci birkaç farklı düzeyde günlük oluşturur. Yapılandırmanızı aşağıdakilerin bir kısmını veya tamamını gösterecek şekilde ayarlayabilirsiniz:
Seviye | İstek Başarılı | Başarısız İstek |
---|---|---|
DEBUG |
JSON biçiminde tam istek ve yanıt nesnelerini içeren ayrıntılı bir günlük. | JSON biçiminde tam istek ve istisna nesnelerini içeren ayrıntılı bir günlük. |
INFO |
Belirli istek ve yanıt alanlarını içeren kısa bir özet. | JSON biçiminde tam istek ve istisna nesnelerini içeren ayrıntılı bir günlük. |
WARNING |
Yok | Belirli istek bilgilerini, istisna durumunu ve mesajı içeren kısa bir özet. |
Python günlük kaydı çerçevesi, yapılandırılmış düzeyden daha önemsiz olan günlük mesajlarını yoksaydığından, WARNING
olarak ayarlamak yalnızca başarısız isteklerle ilgili kısa mesajları göreceğiniz anlamına gelir. DEBUG
olarak ayarlandığında ise yukarıdaki tabloda olası tüm günlük türlerini görürsünüz.
Dosyaya kaydediliyor
Günlük mesajlarını kolayca bir dosyaya bağlayabilirsiniz. Örneğin, get_campaigns
örneğini çalıştırırken:
python get_campaigns.py -c $CLIENT_ID 2> example.log
Günlük kaydı önleyicileri
Python istemci kitaplığı, istek ve yanıt ayrıntılarına erişmek ve bunları günlüğe kaydetmek için gRPC engelleyicileri kullanır. Özel mantıksal bir gRPC önleyicisi oluşturarak kendi özel günlük kaydınızı ayarlayabilirsiniz. Daha ayrıntılı bilgi ve özel bir günlük kaydı müdahalesi örneği için Günlük kaydı kılavuzuna bakın.