API hatalarını işleme

Google Ads API'ye istek gönderdiğinizde bu istek çeşitli nedenlerle başarısız olabilir. Örneğin, geçersiz bir bağımsız değişken sağlayabilir veya hesabınız yeni kampanya oluşturma sınırına ulaşmış olabilir. Bu gibi durumlarda API, neyin yanlış gittiğini bildirerek hata döndürür.

Bu kılavuzda, daha sağlam uygulamalar oluşturabilmeniz için API hatalarının nasıl okunacağı ve işleneceği açıklanmaktadır.

Hata yapısı

İstemci kitaplıklarımızdan birini kullanıyorsanız API hataları istisna olarak gösterilir. Bu istisnalar, hatanın neden oluştuğunu anlamanıza yardımcı olacak ayrıntılar içerir.

Google Ads API, hata bilgilerini standart bir biçimde döndürür. Bir hata oluşursa yanıt, GoogleAdsFailure nesnesini içerir. Bu nesne, her biri belirli bir hatayı ayrıntılandıran bağımsız GoogleAdsError nesnelerinin listesini içerir.

Her GoogleAdsError nesnesi şunları sağlar:

• error_code: Hata türünü (ör. AuthenticationError.NOT_ADS_USER) belirten belirli bir hata kodu.
• message: Hataya neden olan durumun kullanıcılar tarafından okunabilen açıklaması.
• trigger: Hataya neden olan değer (ör. "1234").
• location: İsteğin hangi bölümünün hataya neden olduğuna dair ayrıntılar (ör. belirli bir alan adı).

Hata listesine ek olarak, GoogleAdsFailure, hata veren API isteğinin benzersiz tanımlayıcısı olan requestId içerir.

Örnek hata

Aşağıda, JSON biçimindeki bir hata örneği verilmiştir. Bu hata, dizin 0'deki ad_group öğesinin name alanının istekte eksik olduğunu gösterir.

{
  "code": 3,
  "message": "Request contains an invalid argument.",
  "details": [
    {
      "@type": "type.googleapis.com/google.ads.googleads.v22.errors.GoogleAdsFailure",
      "errors": [
        {
          "errorCode": {
            "requestError": "REQUIRED_FIELD_MISSING"
          },
          "message": "Required field is missing",
          "location": {
            "fieldPathElements": [
              {
                "fieldName": "ad_group",
                "index": 0
              },
              {
                "fieldName": "name"
              }
            ]
          }
        }
      ],
      "requestId": "unique_request_id_12345"
    }
  ]
}

Hataları ele alma

Bir hatayla karşılaşırsanız aşağıdaki adımları uygulayın:

1. errors listesini inceleyin: GoogleAdsFailure nesnesindeki her bir GoogleAdsError öğesine bakın. error_code ve message simgeleri, sorunun ne olduğunu gösterir.
2. location location alanını kontrol edin: Bu alan, isteğinizin hangi bölümünde sorun oluştuğunu belirlemenize yardımcı olabilir.
3. Dokümanlara bakın: Belirli hata kodlarıyla ilgili olarak yaygın hatalar sayfasını veya hatayla ilgili daha fazla bilgi ve hatanın nasıl düzeltileceği hakkında ayrıntılı bilgi için hata kodu referansının tamamını inceleyin.
4. İsteğinizi ayarlayın: Hata mesajına göre API isteğinizi düzeltin. Örneğin, REQUIRED_FIELD_MISSING simgesini görüyorsanız isteğinizde bu alanı sağladığınızdan emin olun.
5. request_id günlüğünü oluşturun: Bir hatayı nasıl çözeceğinizi bulamıyorsanız ve forum üzerinden destek ekibiyle iletişime geçmeniz gerekiyorsa request_id günlüğünü ekleyin. Bu kimlik, Google mühendislerinin sorununuzu araştırmasına yardımcı olur.

Sonraki adımlar

• Sık karşılaşılan sorunların ve çözümlerinin listesi için Sık Karşılaşılan Hatalar bölümünü inceleyin.
• Yeniden deneme mantığı ve kısmi hata dahil olmak üzere daha gelişmiş hata işleme teknikleri için API Hatalarını Anlama başlıklı makaleyi inceleyin.