Kullanımdan kaldırma ve kullanımdan kaldırma

Google Content API for Shopping, 18 Ağustos 2026'da resmen kullanımdan kaldırıldı. Tüm geliştiricilerin mevcut entegrasyonları en kısa sürede Merchant API'ye taşıması gerekir.

Google, tam devre dışı bırakma işleminden önce geçişi teşvik etmek ve geliştiricilerin uygulama günlüklerinde desteği sonlandırma bildirimlerini dikkate almasını sağlamak için 1 Eylül 2026'dan itibaren kademeli bir hizmet düşürme süreci başlatıyor.

Kullanımdan kaldırma zaman çizelgesi

Aşağıdaki tabloda, Google Content API for Shopping (v2.1) hizmetinin kalitesinin düşmesi ve nihai olarak kullanımdan kaldırılmasıyla ilgili zaman çizelgesi özetlenmektedir:

Tarih Milestone Ayrıntılar
1 Eylül 2026 Aralıklı olarak başarısız olan isteklerin kullanıma sunulması Etkin uzatma içermeyen istekler, HTTP 410 Gone ile aralıklı olarak başarısız olmaya başlar.
2027'nin başları Devre dışı bırakma Tamamen kapatma. Tüm uç noktalar kapatılır ve tüm istekler başarısız olur.

Hizmetin kalitesinin düşmesi ve hata yanıtları

1 Eylül 2026'dan itibaren, etkin uzantısı olmayan istemciler tarafından Google Content API for Shopping uç noktalarına gönderilen istekler, aralıklı olarak HTTP 410 Gone durum koduyla başarısız olacak.

Hata yanıtı biçimi

Planlanmış hizmet düşüşü kapsamında bir istek reddedildiğinde API, Google Cloud projenizle ilgili ayrıntıları içeren mesaj ve meta verileri içeren bir HTTP 410 Gone hata yükü döndürür:

{
  "error": {
    "code": 410,
    "message": "Content API for Shopping was sunset on August 18, 2026 for GCP project with id YOUR_PROJECT_ID and number 123456789012. Please migrate to the Merchant API v1 version. See https://developers.google.com/merchant/api/guides/compatibility for more details",
    "status": "ABORTED",
    "details": [
      {
        "@type": "type.googleapis.com/google.rpc.ErrorInfo",
        "reason": "content_api_sunset",
        "domain": "shoppingcontent.googleapis.com",
        "metadata": {
          "GCP_ID": "YOUR_PROJECT_ID",
          "GCP_NUMBER": "YOUR_PROJECT_NUMBER",
          "HELP_CENTER_LINK": "https://developers.google.com/merchant/api/guides/compatibility"
        }
      }
    ]
  }
}

Hata yanıtı aşağıdaki meta veri alanlarını içerir:

  • GCP_ID: İsteği gönderen Google Cloud projesinin kimliği.
  • GCP_NUMBER: Google Cloud projesinin benzersiz sayısal tanımlayıcısı.
  • HELP_CENTER_LINK: Taşıma belgelerine doğrudan bağlantı.

Kota etkisi

Hizmetin kalitesinin düşmesi sırasında oluşturulan yapay hata yanıtları, projenizin API kotasına dahil edilmez.

Başarısız istekleri yeniden deneme

Hizmetin ilk aşamada bozulması yalnızca isteklerin bir kısmının başarısız olmasına neden olduğundan, başarısız olan bir isteği yeniden denemek başarılı olabilir. Ancak, yeniden denemelere güvenmek uzun vadeli bir çözüm değildir. Çünkü devre dışı bırakma sırasında tüm istekler başarısız olana kadar başarısız olan istekler daha sık hale gelir.

Etkilenen geliştiriciler

Desteğin sonlandırılması ve hizmetin kalitesinin düşürülmesi süreci, geliştiriciler ve işletmeler için aşağıdaki şekilde uygulanır:

  • Özel API entegrasyonları: Kuruluşunuzun, Shopping için Google Content API'ye doğrudan çağrı yapan dahili araçları, komut dosyaları veya özel yazılımları varsa uygulamalarınızı Merchant API'yi çağıracak şekilde güncellemeniz gerekir.
  • Üçüncü taraf platformları: Merchant Center'a bir e-ticaret platformu üzerinden erişiyorsanız platform iş ortağınız taşıma işlemini sizin adınıza yönetir. Sizin yapmanız gereken herhangi bir işlem yoktur.

İşlem gerekli

Ürün listelemelerinizde ve hesap yönetiminizde kesinti yaşanmaması için:

  1. Mimariyi, kimlik doğrulamayı ve alt API yapılarını anlamak için Merchant API'ye genel bakış başlıklı makaleyi inceleyin.
  2. Mevcut Content API hizmetlerinizin modern karşılıklarını belirlemek için Content API for Shopping'den Merchant API'ye geçiş kılavuzunu inceleyin.
  3. Programlama diliniz için en son Merchant API istemci kitaplıklarını yükleyin.
  4. Üretime dağıtmadan önce entegrasyonunuzu geliştirme ortamında güncelleyin ve test edin.

Uzatma isteğinde bulunma

Kuruluşunuzun taşıma işlemini tamamlaması için ek süreye ihtiyacı varsa Google Cloud projenizi hizmet düşüşü hatalarından geçici olarak muaf tutmak için ek süre başvurusunda bulunabilirsiniz. Ek süre isteğinde bulunmak için Content API ek süre isteği formunu gönderin.

Onaylı uzantılar, onaylı uzantı pencereniz aracılığıyla projelerinizi planlanmış hata yanıtlarından korur. Uzantılar, 2027'nin başlarında nihai olarak kullanımdan kaldırılmanın ötesine geçmez.