YeniProduct Score, 4T Segmentation, Price War ve Broken Size yayında.Yenilikleri gör
Feedance
Makale

Google Content API 410 Hatalarını Düzeltme: Feed Veri Hattınızı Merchant API'ye Taşıma

Content API for Shopping artık 410 hatası döndürüyor. Kalan çağrılarınızı bulun, Merchant API'ye eşleyin ve ürünlerinizi Merchant Center'da doğrulayın.

Cagdas PolatCagdas Polat
8 dk okuma
Google Content API 410 Hatalarını Düzeltme: Feed Veri Hattınızı Merchant API'ye Taşıma

Google'ın Content API for Shopping hizmeti 18 Ağustos 2026'da kullanımdan kaldırıldı. 1 Eylül'den bu yana onaylı bir uzatması olmayan projelerden gelen istekler aralıklı olarak HTTP 410 hatasıyla başarısız oluyor ve uç noktalar 2027'nin başlarında tamamen kapanıyor (Google'ın kullanımdan kaldırma bildirimi). Bir betik, eklenti veya şirket içi bağlayıcı ürünlerinizi hâlâ eski API üzerinden Merchant Center'a gönderiyorsa, bu güncellemelerin bir kısmı şu anda zaten kayboluyor.

Bu rehber, bu veri hattını kendisi yöneten geliştiriciler ve feed sahipleri içindir. Rehberin sonunda kalan her Content API çağrısını bulabilecek, her birini Merchant API karşılığına eşleyebilecek, yeni API'nin gerektirdiği veri kaynağını oluşturabilecek ve ürünlerin ve fiyatların hâlâ ulaştığını Merchant Center'da doğrulayabileceksiniz.

Kullanımdan kaldırmadan etkilenip etkilenmediğinizi nasıl anlarsınız?

Hata aralıklı olduğu için gözden kaçırması kolaydır. Google, hata gövdesini "Content API for Shopping was sunset on August 18, 2026" ile başlayan bir mesaj içeren 410 olarak belgeler; mesaj Google Cloud proje kimliğinizi, proje numaranızı ve bir yardım merkezi bağlantısını içerir. Entegrasyon günlüklerinizde bu ifadeyi ve shoppingcontent.googleapis.com adresini arayın.

Genellikle kimse bir günlüğü okumadan önce üç belirti ortaya çıkar:

  • Fiyat veya stok durumu değişiklikleri Google'a saatler sonra ya da yalnızca bazı çalıştırmalarda ulaşır.
  • Günlük bir iş, grupların çoğunda başarı, birkaçında ise başarısızlık bildirir.
  • Mağazanız doğru fiyatı gösterirken Merchant Center eskimiş verileri gösterir.

Son belirtinin ikinci bir olası nedeni vardır: Google'ın kendi otomatik ürün güncellemelerinin değerlerinizi geçersiz kılması. Bunu Google'ın feed'inizdeki fiyat ve stok durumunu sessizce geçersiz kılmasını durdurma yazımızda ayrıca ele alıyoruz. Doğrulaması daha kolay olduğu için önce 410 hatalarını ekarte edin.

1. Adım: Eski API'yi çağıran her şeyin envanterini çıkarın

Google'ın kendi önerisi, Content API uç noktalarına yapılan doğrudan çağrılar için uygulama kodunuzu gözden geçirmenizdir. Pratikte çağrılar dört yerde saklanır: mağaza platformunun Google eklentisi, önceki bir geliştiricinin yazdığı özel bir betik, bir feed veya ERP ara katman yazılımı ve birinin yıllar önce planladığı bir Google Ads betiği ya da Apps Script.

Her çağıran için bir satır içeren kısa bir kayıt oluşturun. Ne yaptığını, hangi Google Cloud projesiyle kimlik doğruladığını ve sahibinin kim olduğunu not edin. Uzatmalar ve 410 mesajı proje kimliğine bağlı olduğundan proje kimliği önemlidir.

ÇağıranNe gönderiyor?SahibiEylem
Mağaza eklentisiTam katalog, günlükPlatform sağlayıcısıŞu anda hangi API sürümünü kullandığını sorun
Stok betiğiFiyat ve stok, saatlikGeliştiricinizMerchant API'ye taşıyın
Feed yönetim aracıOptimize edilmiş feedAraç sağlayıcısıGeçiş onayını yazılı olarak isteyin

Bağlantıyı bir sağlayıcı yönetiyorsa sizin işiniz yeniden inşa etmek değil, sormaktır. Productsup ve Feedonomics geçiş yazıları yayımladı ve olgun bir sağlayıcı geçişi zaten yapmış olacaktır. Listenizdeki her sağlayıcıya aynı soruyu sorun ve yanıtları saklayın.

2. Adım: Uzatmaya ihtiyacınız olup olmadığına karar verin

Google, daha fazla zamana ihtiyaç duyan kuruluşlar için bir Content API uzatma talep formu sunar. Onaylanan uzatmalar, bir projeyi onaylanan süre boyunca planlı hata yanıtlarından korur ve 2027 başındaki nihai devre dışı bırakmanın ötesine uzanmaz. Google kimlerin uygun olduğunu belirtmiyor.

Şu karar kuralını kullanın: Her çağıran birkaç hafta içinde taşınıp test edilebiliyorsa uzatmayı atlayın ve zamanı geçişe harcayın. Bir çağıran, geçişi onaylanmış ancak takvime bağlanmamış bir sağlayıcıya aitse yalnızca o proje için uzatma talep edin. Uzatma bir plan değil, bir tampondur.

3. Adım: Her çağrıyı Merchant API karşılığına eşleyin

Merchant API, eski tek parça yapıyı alt API'lere böler ve URL'yi sürümlendirir (/products/v1/). v1 sürümü Temmuz 2025'te genel kullanıma sunuldu ve v1beta 28 Şubat 2026'da kullanımdan kaldırıldı; bu nedenle v1'e göre geliştirme yapın ve bulduğunuz v1beta eğitimlerini görmezden gelin (Merchant API sürüm notları).

Content APIMerchant APINe değişiyor?
products.insertproductInputs.insertBir dataSource sorgu parametresi gerektirir
products.updateproductInputs.patchTek bir ürün girdisinin kalıcı güncellemesi
products.deleteproductInputs.deleteBir dataSource parametresi gerektirir
products.get / listproducts.get / listİşlenmiş ürünü salt okunur olarak döndürür
productstatuses.get / listproducts.get / listDurum artık Product kaynağının bir parçasıdır
custombatchParalel asenkron çağrılarcustomBatch yöntemi yoktur
datafeedsdataSourcesHer veri kaynağı tek bir feed etiketini ve dili hedefler

Kaynak: Google'ın ürün geçiş eşlemesi ve veri kaynağı eşlemesi. Kavramsal değişim, yazdığınız ham veri olan ProductInput ile yalnızca okuyabildiğiniz işlenmiş sonuç olan Product arasındaki ayrımdır. İşlenmiş bir ürün, feed kuralları çalıştıktan sonra bir birincil girdi ve varsa tamamlayıcı girdilerden oluşturulur (ürünlere genel bakış).

4. Adım: Herhangi bir şey eklemeden önce API veri kaynağını oluşturun

İlk geçişlerin çoğunu bozan adım budur. Content API, ilk eklemenizde otomatik olarak bir "Content API" veri kaynağı oluşturuyordu. Merchant API bunu yapmaz. Google, API türünde en az bir veri kaynağı oluşturmanız gerektiğini ve Products alt API'sinin yalnızca bu türdeki veri kaynaklarına yazabildiğini belirtir (veri kaynağı geçişi).

Her veri kaynağı artık tek bir feedLabel ve contentLanguage kombinasyonuna karşılık gelir. Türkiye'ye Türkçe, BAE'ye İngilizce olarak çok hedefli tek bir feed'den hizmet veriyorduysanız, artık ayrı veri kaynaklarına ihtiyacınız var. Bunları Data Sources alt API'si üzerinden veya Merchant Center'da oluşturun, ardından ortaya çıkan accounts/{ACCOUNT_ID}/dataSources/{DATASOURCE_ID} biçimindeki kaynak adını her yazma işleminde kullanın.

5. Adım: Yükü yeniden yazın (uygulamalı bir örnekle)

Hataların çoğuna üç alan değişikliği neden olur. Fiyat, ondalık bir dizeden tam sayı mikro birimlere geçer; bir milyon mikro bir para birimine eşittir. Ürün özellikleri bir productAttributes nesnesine taşınır. targetCountry yerini feedLabel alanına bırakırken channel ortadan kalkar.

Eski ürün tanımlayıcısı aşağıdaki gibiydi; yenisi tilde işaretleri kullanır ve kanalı çıkarır:

Content API:  online:en:US:SKU12345
Merchant API: en~US~SKU12345

Google'ın kendi rehberinde örnek olarak kullandığı bir ürün girdisi şöyle görünür (POST https://merchantapi.googleapis.com/products/v1/accounts/{ACCOUNT_ID}/productInputs:insert?dataSource=accounts/{ACCOUNT_ID}/dataSources/{DATASOURCE_ID} ile eklenir):

{
  "offerId": "SKU12345",
  "contentLanguage": "en",
  "feedLabel": "US",
  "productAttributes": {
    "title": "Classic Cotton T-Shirt",
    "link": "https://www.example.com/p/SKU12345",
    "imageLink": "https://www.example.com/img/SKU12345.jpg",
    "availability": "IN_STOCK",
    "price": { "amountMicros": "15990000", "currencyCode": "USD" },
    "condition": "NEW",
    "gtins": ["9780007350896"]
  }
}

Bunu eski yapıyla karşılaştırın: "price": {"value": "15.99", "currency": "USD"} ifadesi amountMicros ve currencyCode olur, stok durumu ise bir enum'a dönüşür; yani in stock değeri IN_STOCK olur. Kaynak: Google'ın ürün ekleme ve yönetme rehberi.

Türk lirası için 1.249,90 TRY, "amountMicros": "1249900000" demektir. Mikro değerleri bir kayan noktalı sayıyı çarparak değil, küçük para birimi üzerinde tam sayı aritmetiğiyle hesaplayın; aksi takdirde 1249899999 gönderirsiniz ve fiyatların neden kıl payı farklı olduğunu merak edersiniz.

Birden fazla iş aynı ürüne yazıyorsa yeni versionNumber alanını da kullanın. Bu alan, istekler sırasız ulaştığında eski bir güncellemenin daha yeni bir güncellemenin üzerine yazmasını önler.

6. Adım: Toplu işlemeyi değiştirin ve durumu üründen okuyun

customBatch yoktur. Bunun yerine paralel asenkron istekler kullanın ve eşzamanlılığınızı sınırlayın, ardından yalnızca başarısız olanları yeniden deneyin. Kısmi bir başarısızlığın sessizce eskimiş bir kataloğa dönüşmemesi için teklif bazında bir sonuç günlüğü tutun.

Durum için productstatuses çağırmayı bırakın. Bunun yerine durumunu taşıyan işlenmiş Product kaynağını okuyun. Google, bir ekleme veya güncelleme ile nihai ürünün kullanılabilir hale gelmesi arasında birkaç dakikalık bir gecikme olabileceğini belirtir; bu nedenle bir yazma işleminin hemen ardından yapılan okuma, başarısızlığın bir testi değildir.

7. Adım: Eski yolu kapatmadan önce doğrulayın

Yeni yolu önce küçük ve düşük riskli bir dilim üzerinde çalıştırın; örneğin tek bir feed etiketindeki 50 ürün. Ardından geçişi bu kontrol listesiyle puanlayın. Eski çağıranı devreden çıkarmadan önce her satırın yanıtı evet olmalıdır.

  • Çağıran, kaydettiğiniz projeyle kimlik doğruluyor ve art arda yedi gün boyunca hiç 410 döndürmüyor.
  • Hizmet verdiğiniz her feed etiketi ve dil çifti için bir API veri kaynağı mevcut.
  • Test dilimi için işlenmiş ürün; fiyat, stok durumu ve bağlantı açısından tek doğru kaynağınızla eşleşiyor.
  • Aynı teklif kimliklerine eski veri kaynağından yazan başka hiçbir şey kalmadı.
  • Başarısız teklifler atılmıyor, yeniden deneme ile günlüğe kaydediliyor.
  • Kaydınızdaki sağlayıcı tarafından yönetilen tüm çağıranların yazılı bir geçiş onayı var.

Dördüncü madde dikkat gerektirir. Aynı teklif kimliği için ikinci bir yazıcı (örneğin eski çağıran ve yeni bir API veri kaynağı), çelişkili değerlerin ortaya çıkmasının nedenidir. Her ürünün sahibinin hangi kaynak olduğuna karar verin ve diğerini kaldırın.

Bu rehberin sınırları

Bu rehberi Google'ın yayımlanmış belgelerine dayanarak yazdık ve sizin kod tabanınızı taşımadık. Birkaç konu kapsamın dışında kalıyor. Google uzatma uygunluğunu belirtmediğinden belirli bir projenin onaylanıp onaylanmayacağını söyleyemeyiz. Ürünlere genel bakış belgesi "birkaç dakika" dışında bir süre belirtmez; dolayısıyla daha katı gecikme beklentilerini ölçmek size kalmıştır. Yerel envanter, bölgesel envanter, promosyonlar ve değerlendirmelerin her birinin kendi Merchant API alt kaynakları vardır ve bunların eşlemelerini burada ele almadık.

Bir API entegrasyonunun sahibi olmak hiç istemiyorsanız, yeniden yazmaktan daha iyi yanıt yönetilen bir feed platformudur. Productsup ve Feedonomics'in her ikisi de Merchant API geçiş rehberleri yayımlıyor ve olağandışı veri modellerine sahip kurumsal bir ekip için ikisi de bizim kurulumumuzdan daha uygun olabilir. Özellikle Google Shopping için kendi kurulumumuz Google Merchant Center entegrasyon sayfasında açıklanmaktadır.

Sıkça sorulan sorular

Content API for Shopping hâlâ çalışıyor mu?

Güvenilir şekilde çalışmıyor. Google, hizmetin 18 Ağustos 2026'da kullanımdan kaldırıldığını, aktif uzatması olmayan isteklerin 1 Eylül 2026'dan itibaren aralıklı olarak HTTP 410 ile başarısız olmaya başladığını ve tüm uç noktaların 2027 başında kapandığını belirtiyor.

Content API 410 hatası ne diyor?

Mesaj "Content API for Shopping was sunset on August 18, 2026" ile başlar. Yanıt, GCP proje kimliğinizi, proje numaranızı ve bir yardım merkezi bağlantısını içerir; bu da hangi projeyi taşımanız veya uzatmanız gerektiğini gösterir.

Uzatma ile daha fazla zaman alabilir miyim?

Google bir Content API uzatma talep formu sunar. Onaylanan uzatmalar projenizi yalnızca onaylanan süre boyunca planlı hatalardan korur ve 2027 başındaki devre dışı bırakmanın ötesine geçmez.

productInputs.insert neden bir dataSource istiyor?

Merchant API'deki yazma işlemleri açık bir veri kaynağına aittir. Eski API'nin aksine ilk eklemenizde bir "Content API" veri kaynağı oluşturmaz; bu nedenle API türünde bir veri kaynağı oluşturmanız ve kaynak adını iletmeniz gerekir.

Merchant API'de fiyatları nasıl gönderirim?

amountMicros değerini tam sayı dizesi olarak ve currencyCode değerini ISO 4217 biçiminde kullanın. Bir milyon mikro bir para birimine eşittir; dolayısıyla 15,99 USD, 15990000'dir.

Merchant API toplu işlemeyi destekliyor mu?

customBatch yöntemi yoktur. Google'ın önerisi asenkron paralel çağrılar kullanmaktır; bu da kendi eşzamanlılık sınırınızı ve teklif bazında yeniden denemelerinizi eklemeniz gerektiği anlamına gelir.

productstatuses nereye gitti?

Durum artık işlenmiş Product kaynağının bir parçasıdır. Okumak için products.get veya products.list kullanın; işlemenin bir eklemeden birkaç dakika geride kalabileceğini unutmayın.

Hangi Merchant API sürümüne göre geliştirme yapmalıyım?

Temmuz 2025'te genel kullanıma sunulan v1'e göre geliştirme yapın. v1beta sürümü 28 Şubat 2026'da kullanımdan kaldırıldı; bu nedenle ona göre yazılmış eğitimler başarısız olur.

Google'ın gerçekte ne gördüğünü kontrol edin

Geçişten sonra en hızlı sağlamlık kontrolü, kaynak feed'inizi Merchant Center'ın işlediğiyle karşılaştırmaktır. Eksiksizlik ve kalite puanı almak için canlı feed'inizi ücretsiz ürün feed denetim aracımızdan geçirin ve bir sonraki reklam döngüsünden önce işaretlenen her şeyi düzeltin.

Feed'inize ikinci bir göz mü istiyorsunuz? Bir sonraki gönderiminizden önce feed'inizi sizinle birlikte inceler, eksikleri gösteririz.
Ücretsiz denetim yaptırın
Cagdas Polat
Yazan
Cagdas Polat

Feedance'ın kurucu ortağıdır; bilgisayar mühendisliği ve pazarlama alanındaki geçmişini analitik içgörüler üretmek için kullanır. Verileri uygulanabilir stratejilere dönüştürmeye odaklanarak markaların dijital dünyada kayda değer bir büyüme elde etmesine yardımcı olmaya kendini adamıştır.

LinkedIn

Hangi ürünlerin
kazandırdığını görün.

Feed'inizi ve GA4'ü bağlayın. Product Score, 4T, Price War ve Broken Size'ı kendi kataloğunuzda gösterelim.