Hatalar
HTTP durum kodları ve nasıl ele alınacağı.
API standart HTTP durum kodları döner. 2xx başarı, 4xx istek hatası, 5xx sunucu
hatasıdır. Hatalı yanıtlar genelde sorunu açıklayan bir JSON gövdesi içerir.
Durum kodları
| Kod | Anlamı | Ne yapmalı |
|---|---|---|
200 OK | Başarılı | — |
400 Bad Request | Geçersiz parametre (eksik from/to/metrics, hatalı tarih, 90 günü aşan aralık, geçersiz boyut/metrik kombinasyonu) | İstek parametrelerini düzelt |
401 Unauthorized | Anahtar eksik, geçersiz veya süresi dolmuş | Authorization header'ını kontrol et |
403 Forbidden | Anahtar geçerli ama kaynağa erişim yok | Sahip olduğun campaign_id/ad_id kullan |
404 Not Found | Yol yok veya kaynak bulunamadı | URL'yi kontrol et |
429 Too Many Requests | Hız limiti aşıldı | Backoff ile tekrar dene |
5xx | Geçici sunucu/edge hatası | Kısa beklemeyle tekrar dene |
Sık yapılan hatalar
400— tarih aralığı çok geniş:from–toarası en fazla 90 gün.400—keyword+date: anahtar kelime yalnızca toplamdır,dateile birleştirilemez.400—keyword+conversions/revenue: anahtar kelime yalnızcaviews/spending/clicksdestekler.401—Bearereksik: header formatıAuthorization: Bearer <API_KEY>olmalı.
Öneriler
4xxhatalarını tekrar deneme — istek hatalıdır, parametreyi düzelt.429ve5xxiçin exponential backoff ile tekrar dene.- Yanıt gövdesindeki mesajı logla; hata ayıklamayı kolaylaştırır.
Limitler & Önbellek
Edge önbellekleme davranışı, hız limitleri ve 429 yönetimi.
Birleşik istatistik raporu GET
Tek uç nokta, tek satır biçimi: `{ dimensions, metrics }`. - metrics: views, spending, clicks (geçerli/bot-filtrelenmiş), conversions, revenue. - dimensions: genel toplam için boş bırakın; `date` granülerliğe göre kovalara ayırır; bir varlık boyutu (campaign|ad|keyword) isteğe bağlı olarak date ile birleştirilebilir. - keyword yalnızca toplamdır ve views/spending/clicks destekler (conversions/revenue değil). - `date` unix epoch saniyedir (UTC, kova başlangıcı). Topluluk verisi kapsam dışıdır.