Kitaplık, Google Ads API ile etkileşimleri çeşitli şekillerde günlüğe kaydetmek üzere yapılandırılabilir. Ayrıntılı istek ve yanıtların yanı sıra daha kısa özet mesajları da 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çenekleri türleriyle ilgili ayrıntılar verilmiştir.
Kitaplık, Python'un yerleşik günlük kaydı çerçevesini kullanır ve varsayılan olarak stderr dosyasına günlük kaydeder. Dahil edilirse yapılandırmanızda tanımlanan logging nesnesi doğrudan dict olarak 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 da yapılandırabilirsiniz. İstemci günlük kaydı ö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 günlüğünün, istemci ilk oluşturulduğunda yapılandırıldığını unutmayın. Günlüğe kaydetme yapılandırmasında daha sonra yapılan 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 istemci başlatılmadan önce yukarıdaki satırları çağırdığınızdan emin olun.
Günlük seviyeleri
Müşteri, birkaç farklı düzeyde günlük oluşturur ve yapılandırmanızı aşağıdakilerin bir kısmını veya tamamını görecek şekilde ayarlayabilirsiniz:
| Seviye | Başarılı İstek | Başarısız İstek |
|---|---|---|
DEBUG |
JSON olarak tam istek ve yanıt nesnelerini içeren ayrıntılı günlük. | JSON olarak tam istek ve istisna nesnelerini içeren ayrıntılı günlük. |
INFO |
Belirli istek ve yanıt alanlarını içeren kısa bir özet. | JSON olarak tam istek ve istisna nesnelerini içeren ayrıntılı günlük. |
WARNING |
Yok | Belirli istek bilgilerini, istisna durumunu ve mesajını içeren kısa bir özet. |
Python günlük kaydı çerçevesi, yapılandırılmış düzeyden daha az önemli olan günlük mesajlarını yoksayar. Bu nedenle, WARNING olarak ayarlandığında yalnızca başarısız isteklerle ilgili kısa mesajlar görürsünüz. DEBUG olarak ayarlandığında ise yukarıdaki tabloda gösterilen tüm günlük türlerini görürsünüz.
Dosyaya günlük kaydı
Günlük mesajlarını kolayca bir dosyaya aktarabilirsiniz. Örneğin, get_campaigns örneğini çalıştırırken:
python get_campaigns.py -c $CLIENT_ID 2> example.log
Günlük kaydeden müdahaleciler
Python istemci kitaplığı, istek ve yanıt ayrıntılarına erişmek ve bunları günlüğe kaydetmek için gRPC engelleyicilerini kullanır. Özel mantık içeren bir gRPC müdahaleci oluşturarak kendi özel günlük kaydınızı ayarlayabilirsiniz. Daha fazla bilgi ve özel günlük kaydı tutucu örneği için Günlük kaydı kılavuzuna bakın.