Google Ads API Kaynak Kullanımı Politikası Güncellemesi

1 Mayıs 2024, Çarşamba

Neler değişiyor?

Aşırı miktarda API kaynağı tüketen GoogleAdsService.Search ve GoogleAdsService.SearchStream sorgu kalıplarını kısıtlamak için Google Ads API kaynak kullanımı politikasını güncelliyoruz. Belirli bir sorgu kalıbı kısıtlanırsa diğer hizmetler, yöntemler ve sorgu kalıpları etkilenmeden çalışmaya devam eder.

17 Haziran 2024 haftasından itibaren ve yalnızca kısıtlanmış sorgu kalıpları için istekler aşağıdaki şekilde etkilenecek:

  • API'nin v17 veya daha eski bir sürümünü kullanıyorsanız QuotaError.RESOURCE_EXHAUSTED hatası alırsınız.
  • API'nin v18 veya daha yeni bir sürümünü kullanıyorsanız aşırı kaynak tüketiminin kısa bir süre (birkaç dakika) veya uzun bir süre boyunca gerçekleşmesine bağlı olarak QuotaError.EXCESSIVE_SHORT_TERM_QUERY_RESOURCE_CONSUMPTION ya da QuotaError.EXCESSIVE_LONG_TERM_QUERY_RESOURCE_CONSUMPTION hatası alırsınız.

Yüksek maliyetli raporlarınızı belirlemenize ve izlemenize yardımcı olmak için her bir raporun maliyet metriğini de döndüreceğiz. Başarılı raporların maliyetini görüntülemek için aşağıdaki alanlara bakın:

Bu değişiklik neden yapıldı?

Bu değişikliği, API'nin güvenilirliğini ve kararlılığını korumak için yapıyoruz.

Ne yapmanız gerekiyor?

17 Haziran 2024'ten önce uygulamalarınızı aşağıdaki işlemleri yapacak şekilde güncelleyin:

  • GoogleAdsService::Search or GoogleAdsService::SearchStream çağrıları yaparken yeni hata kodlarını işleme
    • Google Ads API'nin v17 veya daha eski bir sürümünü kullanıyorsanız QuotaError.RESOURCE_EXHAUSTED hatalarını işleyin.
    • API'nin v18 veya sonraki bir sürümünü kullanıyorsanız QuotaError.EXCESSIVE_SHORT_TERM_QUERY_RESOURCE_CONSUMPTION ve QuotaError.EXCESSIVE_LONG_TERM_QUERY_RESOURCE_CONSUMPTION hatalarını ele alın.
  • Raporlama sorgusu kalıplarınızdan biri veya daha fazlası kısıtlanıyorsa sorgu kalıbını inceleyip düzeltmeniz gerekir. Sorgu performansını iyileştirmenin bazı yolları şunlardır:
    • Sorguyu daha seyrek çalıştırın.
    • Daha az maliyetli bir sorgu kalıbı veya görünümü kullanın.

Sorgularınızı optimize etme hakkında daha fazla bilgi edinmek için Veri verimliliğini yönetme başlıklı makaleyi inceleyin.

  • [İsteğe bağlı] Yeni pahalı sorguları tespit edip işlemek için yeni query_resource_consumption metriğini izleme sistemlerinize dahil edin.

Nasıl yardım alabilirim?

Bu değişiklikle ilgili herhangi bir sorunuz varsa veya belirli sorgu kalıplarını optimize etme konusunda yardıma ihtiyaç duyarsanız seçenekler için Google Ads API destek sayfasını inceleyin.

- David Stevens, Google Ads API Ürün Müdürü

Etiketler: google-ads-api