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ı talep ve yanıtların yanı sıra daha kısa özet mesajları da kaydedebilirsiniz. Bu ayarlar, istemci kitaplığı yapılandırması tarafından yönetilir. Aşağıda, kullanılabilen farklı yapılandırma seçenekleri hakkındaki ayrıntılara yer verilmiştir.

Kitaplık, varsayılan olarak Python'un yerleşik günlük kaydı çerçevesini ve günlüklerini stderr için kullanır. Dahil edilmesi durumunda, yapılandırmanızda tanımlanan logging nesnesi doğrudan logging.config.dictConfig öğesine dict olarak geçirilir.

Ayrıca, istemciyi 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 alabilir ve 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 kaydedicisinin 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 istemci başlatılmadan önce yukarıdaki satırları çağırdığınızdan emin olun.

Günlük düzeyleri

İstemci birkaç farklı düzeyde günlükler oluşturur. Yapılandırmanızı, aşağıdakilerden bazılarını veya tümünü görecek şekilde ayarlayabilirsiniz:

Seviye	Başarılı İstek	Başarısız İstek
DEBUG	JSON biçiminde eksiksiz 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	Özel istek bilgilerini, istisna durumunu ve mesajı içeren kısa bir özet.

Python günlük kaydı çerçevesi, yapılandırılan düzeyden daha düşük öneme sahip günlük mesajlarını yok saydığından WARNING olarak ayarlamak yalnızca başarısız isteklerle ilgili kısa mesajları göreceğiniz anlamına gelir. DEBUG olarak ayarlamak ise yukarıdaki tabloda yer alan tüm olası günlük türlerini göreceğiniz anlamına gelir.

Dosyaya günlük kaydı yapılıyor

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 aracıları kullanır. Özel mantıkla bir gRPC önleme aracı oluşturarak kendi özel günlük kaydınızı ayarlayabilirsiniz. Daha fazla ayrıntı ve özel bir günlük kaydı engelleyici örneği için Günlük kaydı kılavuzuna bakın.