WooCommerce için Merchant API ve Content API for Shopping karşılaştırması
WooCommerce ürünlerini Google Merchant Center’a bağlayan sistemlerde API seçimi veri gönderimi, hesap yönetimi, hata işleme ve gelecekteki bakım yaklaşımını etkiler. Content API for Shopping uzun süre birçok entegrasyonun temelini oluştururken Merchant API daha yeni kaynak ve hizmet yapıları sunar. Seçim yalnız uç nokta adlarına göre değil, kullanılan özelliklerin resmi desteğine göre yapılmalıdır.
API rollerini doğru anlayın
Her iki yaklaşım da Merchant Center verileriyle programatik çalışmayı amaçlar; ancak kaynak modelleri, hizmetler, istek biçimleri ve desteklenen özellikler aynı olmayabilir. Bir işlemin yeni API’de bulunması, eski kodun yalnız adres değiştirilerek çalışacağı anlamına gelmez.
Mevcut entegrasyonun envanterini çıkarın
Ürün ekleme, güncelleme, silme, toplu işlem, hesap seçimi, kargo, promosyon ve raporlama gibi kullanılan bütün işlevleri listeleyin. Hangi OAuth kapsamlarının ve Merchant hesap rollerinin gerektiğini belgeleyin. Kullanılmayan izinleri kaldırın.
Ürün kaynak modelini karşılaştırın
Eski ve yeni yapıda ürün kimliği, veri kaynağı, hedef ülke, dil ve kanal bileşenlerinin nasıl temsil edildiğini inceleyin. WooCommerce ürün ve varyasyon kimliklerini geçiş sırasında kararlı tutun. Kimlik değişikliği yinelenen veya geçmişi kopmuş ürünler oluşturabilir.
Kapsam ve yetkilendirmeyi doğrulayın
Resmi OAuth akışını kullanın ve yalnız gerekli en dar izinleri isteyin. Doğru Google hesabı ile Merchant hesabının eşleştiğini test edin. Erişim ve yenileme belirteçlerini yönetici dışındaki kullanıcılara, kayıtlara veya hata mesajlarına açık etmeyin.
Hata ve durum modellerini uyarlayın
HTTP kodu tek başına yeterli değildir. Alan düzeyi doğrulama sorunlarını, geçici hizmet hatalarını, yetki sorunlarını ve politika sonuçlarını ayrı işleyin. API isteğinin kabul edilmesi ürünün Google tarafından onaylandığı anlamına gelmez.
Kota ve toplu işlemleri planlayın
Büyük katalogları güvenli gruplar hâlinde gönderin. Kota sınırlarına, yeniden deneme önerilerine ve idempotent işlem gereksinimlerine uyun. Üstel gecikmeli yeniden deneme kullanın; kalıcı doğrulama hatalarını aynı veriyle sürekli tekrarlamayın.
Geçişi paralel doğrulayın
Canlı kataloğun tamamını bir anda taşımak yerine test hesabı veya sınırlı ürün grubuyla başlayın. Eski ve yeni sonuçları ürün kimliği, fiyat, stok, görsel ve durum açısından karşılaştırın. Aynı canlı ürünü iki API üzerinden çelişkili biçimde yönetmeyin.
WooCommerce olaylarını eşleyin
Ürün kaydetme, sipariş, iade, stok değişimi, kampanya başlangıcı ve silme olaylarının yeni API akışında doğru görevi oluşturduğunu test edin. Zamanlanmış tam uzlaştırma ile kaçırılmış olayları ve yetim kayıtları bulun.
Resmi destek durumunu izleyin
API özellikleri ve geçiş takvimleri zamanla değişebilir. Uygulamadan önce güncel Google Merchant geliştirici belgelerini, sürüm notlarını ve kullanımdan kaldırma duyurularını kontrol edin. Üretim kodunu belgelenmemiş davranışlara bağlamayın.
Geri dönüş ve izleme planı oluşturun
Yeni yapı beklenmeyen sonuç verirse veri kaybı yaşamadan durdurabileceğiniz bir plan hazırlayın. İşlem başarısı, gecikme, hata türü ve kuyruk durumunu ölçün. Eski sistemi kapatmadan önce silme, varyasyon ve fiyat güncelleme senaryolarını tamamlayın.
Merchant API geçişi bir adres değişikliği değildir; ürün modeli, yetkilendirme, hata işleme ve WooCommerce olaylarının birlikte yeniden doğrulanmasıdır.