Display & Video 360 API ile çalışırken hatalarla karşılaşabileceğiniz birçok senaryo vardır. Bunlar, kodunuzdaki bir hatayla, geçersiz kullanıcı girişiyle veya API'nin kendisiyle ilgili bir sorunla ilgili olabilir. Sebebi ne olursa olsun, hatalarla ilgili sorunları gidermeyi 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ı verilmektedir.
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şiminizin olduğundan emin olun.
- Yanıtınız HTTP hataları içeriyorsa bunları dikkatlice incelediğinizden ve isteğin doğru API'ye ve hizmete gönderildiğinden 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 bilgilerini oluşturma hakkında ayrıntılı bilgi için Uygulamanızı Ayarlama Kılavuzu'na bakın. Erişim jetonunuzun doğru API projesine verildiğini ve doğru kapsamlar için yetkilendirildiğini doğrulamak üzere Google OAuth2 API'nin tokeninfo 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 normalde bir error nesnesi içeren bir JSON yanıtı döndürür. Bu nesne, karşılaşılan hatayla ilgili ek bağlam bilgisi sağlar.
{
"error": {
"code": 404,
"message": "Resource type LINE_ITEM does not exist: advertisers/1/lineItems/1",
"status": "NOT_FOUND"
}
}
Genellikle error nesnesinin içeriği, hatanın nerede olduğunu belirlemenize yardımcı olacak yeterli bilgiyi içerir. Aksi takdirde, hatanın ne anlama geldiğini öğrenmek için daha fazla araştırma yapmanız gerekebilir.
Hataları araştırma
En sık karşılaşılan hatalardan bazılarının ayrıntılarını içeren sık karşılaşılan hatalar bölümüne bakın.
Hata, sık karşılaşılan hatalar bölümünde yer almıyorsa referans dokümanlarına göz atın ve hata kodunu, durumunu ve mesajını aramayı deneyin.
Belgelenmemiş herhangi bir hatayla karşılaşırsanız lütfen bize bildirin.
Temel nedeni belirleme
Bu aşamada hatayı tespit etmiş ve ne anlama geldiğini anlamışsınızdır. Aksi takdirde, hataları anlama bölümüne geri dönün veya API'de kendiniz düzeltemeyeceğiniz bir hatayla karşılaştıysanız yardım alma bölümüne atlayın.
Hatayı düzeltmeden önce hataya neyin neden olduğunu belirlemeniz gerekir. Bu genellikle kodunuzdaki bir hata veya geçersiz bir giriş değeridir.
Sorunun, kodunuzdaki bir hatayla ilgili olup olmadığını belirlemek için öncelikle kodunuzun amaçlandığı gibi çalıştığını doğrulamanız gerekir. İlk adım olarak, bariz sorunları kontrol etmek için başarısız isteği göndermekten sorumlu kod bölümünü inceleyebilirsiniz. Bazı durumlarda, kodun doğru çalıştığından emin olmak için kod satırlarını tek tek inceleyen bir hata ayıklama aracı kullanmanız gerekebilir.
HTTP isteklerini incelemek, olası hataları ve geçersiz giriş durumlarını tespit etmenin bir diğer faydalı yoludur. Resmi istemci kitaplıklarının çoğu, HTTP isteklerini ve yanıtlarını günlüğe kaydetmek için yapılandırılabilir. Daha fazla bilgi için tercih ettiğiniz kitaplığın belgelerini inceleyin. Charles, Squid veya Fiddler gibi bir HTTP proxy'si de istek ve yanıt günlüklerini yakalamak için 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 günlükleri inceleyin.
Hataya neden olan hatayı veya geçersiz girişi belirledikten sonra düzeltme muhtemelen açıktır. Ancak, takılırsanız veya sorunu en iyi şekilde nasıl çözeceğinizden emin değilseniz yardım alırken şu ana kadar topladığınız bilgileri kullanabilirsiniz.
Yardım alma
Bir hatayı kendiniz çözemiyorsanız Display & Video 360 yardım merkezindeki bu form aracılığıyla destek ekibimizle iletişime geçebilirsiniz.
Bu formu doldururken, karşılaştığınız sorun ve uyguladığınız sorun giderme adımları hakkında mümkün olduğunca fazla bilgi eklemeniz gerekir. Dahil edebileceğiniz yararlı bilgiler:
- HTTP istek ve yanıt günlükleri. OAuth 2.0 erişim jetonları, e-posta adresleri gibi hassas bilgileri çıkarttığınızdan emin olun.
- Kod snippet'i. Sorunu kodun belirli bir bölümüne ayırabiliyorsanız veya sorunun dile özgü olduğundan şüpheleniyorsanız ne yaptığınızı açıklamak için küçük bir snippet ekleyin.
- Sorunu yeniden oluşturmaya çalışan diğer kullanıcılar için yararlı olabilecek ek bilgiler (ör. çalışma zamanı/yorumlayıcı sürümü ve platform).
Sorunu düzeltme
Sorunun nedenini belirledikten ve bir çözüm bulduktan sonra çözümü uygulama zamanı gelmiştir. Mümkünse düzeltmenizi, üretime dağıtmadan önce kontrollü bir ortamda (özellikle test için yapılandırılmış bir iş ortağı veya reklamveren gibi) hem iyi hem de kötü girişler için test edin.