Display & Video 360 API ile çalışırken hatalarla karşılaşabileceğiniz birçok senaryo vardır. Bunlar kodunuzdaki bir hata, geçersiz kullanıcı girişi ve hatta API'nin kendisiyle ilgili bir sorun ile ilgili olabilir. Nedeni ne olursa olsun, hataların nasıl giderileceğini bilmek geliştirme sürecinin önemli bir parçasıdır. Bu kılavuzda, başlamanıza yardımcı olacak bazı en iyi uygulama ipuçları sunulmaktadır.
Temel bilgileri inceleme
- Ön koşullar kılavuzunu inceleyin. Display & Video 360'a ve düzgün yapılandırılmış bir API projesine erişiminiz olduğundan emin olun.
- Yanıtınız HTTP hataları içeriyorsa bunları dikkatlice inceleyip isteğin doğru API ve hizmete yapıldığından emin olun.
- Yetkilendirme kılavuzunu inceleyin. İsteğinizin gerekli OAuth 2.0 kimlik bilgilerini içerdiğinden emin olun.
Doğru kimlik bilgilerini kullandığınızdan emin olun. Kimlik doğrulama kimlik bilgileri oluşturma hakkında ayrıntılı bilgi için Uygulamanızı Ayarlama kılavuzuna bakın. Ayrıca, erişim jetonunuzun doğru API projesine verildiğini ve doğru kapsamlar için yetkilendirildiğini doğrulamak amacıyla Google OAuth2 API'nin jeton bilgileri uç noktasına da iletebilirsiniz:
POST https://www.googleapis.com/oauth2/v2/tokeninfo?access_token={YOUR_ACCESS_TOKEN} 200 OK { "issued_to": "{API_PROJECT_CLIENT_ID}", "audience": "...", "scope": "{API_SCOPES}", "expires_in": ... }
Hataları anlama
API bir hatayla karşılaştığında genellikle error nesnesi içeren bir JSON yanıtı döndürür. Bu nesne, karşılaşılan belirli bir hata hakkında ek bağlam sağlar.
{
"error": {
"code": 404,
"message": "Resource type LINE_ITEM does not exist: advertisers/1/lineItems/1",
"status": "NOT_FOUND"
}
}
error nesnesinin içeriği genellikle neyin yanlış gittiğini belirlemenize yardımcı olacak kadar bilgi içerir. Durum böyle değilse hatanın ne anlama geldiğini
anlamak için ek araştırmalar yapmanız gerekebilir.
Hataları araştırma
En sık karşılaşılan hatalardan bazılarıyla ilgili ayrıntıların yer aldığı yaygın hatalar bölümüne bakın.
Hata, yaygın hatalar bölümünde yer almıyorsa referans belgelerine göz atın ve ilgili hata kodunu, durumunu ve mesajını aramayı deneyin.
Belgelenmemiş herhangi bir hata ile karşılaşırsanız lütfen bize bildirin.
Temel nedeni belirleme
Bu aşamada hatayı tespit etmiş ve ne anlama geldiğini anlamış olursunuz. Aksi takdirde, API'de kendi başınıza düzeltemeyeceğiniz bir hatayla karşılaştığınızı düşünüyorsanız hataları anlamaya geri dönün veya yardım alma adımına geçin.
Hatayı düzeltebilmeniz için öncelikle hatanın nedenini belirlemeniz gerekir. Bu durum genellikle kodunuzdaki bir hata veya geçersiz bir giriş değeri nedeniyle ortaya çıkar.
Sorunun, kodunuzdaki bir hata ile ilgili olup olmadığını belirlemek için öncelikle kodunuzun beklendiği gibi çalıştığını doğrulamanız gerekir. İlk adım olarak, bariz sorunları kontrol etmek üzere başarısız istekte bulunmaktan sorumlu kod bölümünü incelemeyi düşünün. Bazı durumlarda, kodun doğru çalıştığından emin olmak için kodu satır satır görmek için bir hata ayıklama aracı kullanmak gerekebilir.
HTTP isteklerini incelemek, olası hataları ve geçersiz giriş durumlarını tespit etmenin başka bir faydalı yoludur. Resmi istemci kitaplıklarının çoğu, HTTP isteklerini ve yanıtlarını günlüğe kaydedecek şekilde yapılandırılabilir. Daha fazla bilgi için seçtiğiniz kitaplığın belgelerini inceleyin. İstek ve yanıt günlüklerini yakalamak için Charles, Squid veya Fiddler gibi bir HTTP proxy de kullanılabilir. Bu günlükleri aldıktan sonra, uygulamanız tarafından sağlanan istek parametresi değerlerinin doğru olduğundan ve beklediğinizle eşleştiğinden emin olmak için bunları inceleyin.
Hataya neden olan hatayı veya geçersiz girişi tanımladıktan sonra, çözüm büyük olasılıkla görünür olacaktır. Bir noktada takılırsanız veya sorunu en iyi şekilde nasıl çözeceğinizden emin olamazsanız yardım alırken şimdiye kadar topladığınız bilgileri kullanabilirsiniz.
Yardım alma
Bir hatayı kendiniz çözemiyorsanız Display & Video 360 yardım merkezindeki bu formu kullanarak destek ekibimizle iletişime geçebilirsiniz.
Bu formu doldururken, karşılaştığınız sorun ve daha önce uyguladığınız sorun giderme adımları hakkında mümkün olduğunca fazla bilgi eklemelisiniz. Eklenecek yararlı bilgiler:
- HTTP istek ve yanıt günlükleri. OAuth 2.0 erişim jetonları, e-posta adresleri gibi hassas bilgileri çıkardığınızdan emin olun.
- Kod snippet'i. Sorunu belirli bir kod bölümüyle ayırabiliyor veya sorunun dile özgü olduğundan şüpheleniyorsanız yaptığınız işlemi göstermek için küçük bir snippet ekleyin.
- Sorunu yeniden oluşturmaya çalışan diğer kişiler için yararlı olabilecek çalışma zamanı/yorumlayıcı sürümü ve platform gibi ek bilgiler.
Sorunu düzeltme
Sorunun nedenini belirleyip çözüm bulduktan sonra sıra düzeltmeyi uygulamaya gelir. Mümkün olduğunda düzeltmenizi üretime dağıtmadan önce kontrollü bir ortamda (ör. test için özel olarak yapılandırılmış bir iş ortağı veya reklamveren) test edin.