Google Ads API'nin 17. sürümü kullanıma sunuldu

5 Haziran 2024, Çarşamba

Bugün, Google Ads API'nin 17. sürümünü duyuruyoruz. Sürüm 17'deki bazı özellikleri kullanmak için istemci kitaplıklarınızı ve istemci kodunuzu yükseltmeniz gerekir. Güncellenen istemci kitaplıkları ve kod örnekleri önümüzdeki hafta yayınlanacak.

Öne çıkanlar şunlardır:

• 17 Haziran 2024'te gerçekleşecek kaynak kullanımı politikası değişikliğine hazırlanmak amacıyla, QuotaError için iki yeni değer ekledik. Bu değerler, GoogleAdsService.Search() ve GoogleAdsService.SearchStream() istekleri için bir sorgu kalıbı tarafından belirli bir süre boyunca aşırı kaynak tüketimi yapıldığında gösterilir.
• page_size alanı her zaman 10.000 olarak ayarlanır ve artık GoogleAdsService.Search'ye page_size iletemezsiniz. Aksi takdirde RequestError.PAGE_SIZE_NOT_SUPPORTED hatası alırsınız.
• Maksimum Performans ve Arama Ağı kampanyalarının daha fazla metriğini raporlamak için campaign_aggregate_asset_view ve channel_aggregate_asset_view eklendi.
• Toplu işlemede yapılan değişiklikler:
  • BatchJobService kullanılırken MutateOperation.asset_group_operation ayarı için destek eklendi. Bu sayede, Maksimum Performans kampanyalarının tamamını oluşturmak ve yönetmek için toplu işleme özelliğini kullanabilirsiniz.
  • 10.484.504 bayttan büyük bir AddBatchJobOperationsRequest gönderildiğinde ortaya çıkan BatchJobError.REQUEST_TOO_LARGE hatası eklendi. İşlemleri daha küçük gruplara bölüp ayrı bir istek olarak göndermeniz gerekir.
• Bir kampanyadaki tüm anahtar kelimeler için anahtar kelime eşleme türü ayarlanmasına olanak tanımak amacıyla Campaign.keyword_match_type eklendi.
• Hizmeti Google Ads API'deki diğer hizmetlerle uyumlu hale getirmek için AdService.getAd kaldırıldı. Kaynakları getirme ile ilgili öneriler için Nesneleri alma başlıklı makaleyi inceleyin.
• Reklam grubu ölçütünün yayınlanıp yayınlanmadığını veya yayınlanmama nedenlerini göstermek için AdGroupCriterion öğesine primary_status ve primary_status_reasons eklendi.
• Google Ads kullanıcı arayüzünün Ürünler sayfasına karşılık gelen yeni bir rapor (shopping_product) eklendi.
• ImageAdInfo.image_asset için boyutlar ve biçimle ilgili daha fazla doğrulama eklendi. Bu sayede, Google Ads API'deki diğer resim doğrulamalarıyla daha tutarlı hale getirildi.
• Son SkAdNetwork geri gönderme verileriyle ilgili bir makine öğrenimi modeline göre NULL değerlerini diğer değerlere yeniden dağıtan segments.sk_ad_network_redistributed_fine_conversion_value eklendi.
• Google Ads API'deki tüm kaynakların tüm alanlarında, enum'larında ve hatalarında Discovery, Talep Yaratma olarak yeniden adlandırıldı.
• Artık product_link sorgusu yaparken yalnızca bir bağlı ürünle ilgili alanları seçebilirsiniz. Aksi takdirde QueryError.PROHIBITED_FIELD_COMBINATION_IN_SELECT_CLAUSE hatası verilir.
• Kitle müşteri türlerini yapılandırmak için UserListCustomerTypeService.MutateUserListCustomerTypes() eklendi. Bu yöntem, CustomerLifecycleGoal.lifecycle_goal_customer_definition_settings kullanımının yerini alır.
• Reklamverenlerin, öğelerinin geçerlilik bitiş tarihini daha iyi izleyebilmesi için iki expiration_date_time alanı local_services_verification_artifact eklendi.

Nereden daha fazla bilgi edinebilirim?
Aşağıdaki kaynaklar, başlangıç aşamasında yardımcı olabilir:

• Sürüm Notları
• Kılavuzlar
• Reference
• v16 ile v17 arasındaki farklar

Sorularınız varsa veya daha fazla yardım almak istiyorsanız forum üzerinden bizimle iletişime geçin.

 - Thanet Knack Praneenararat, Google Ads API Ekibi adına

Etiketler: google-ads-api, release