Günlük Kaydı

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.