Bu sayfada, ürünlerinizi programatik olarak nasıl yükleyip yönetebileceğiniz açıklanmaktadır. Merchant Products API'yi kullanarak bir veri kaynağına ürün ekleyebilir veya mevcut bir ürünü güncelleyebilir, hesabınızdan ürün alabilir ve bir veri kaynağından ürün silebilirsiniz.
Merchant Products API iki kaynak içerir.
productInputs, ürünlerinizin giriş bölümlerini temsil eder.products, giriş parçalarınızdan oluşturulan işlenmiş ürünleri temsil eder.
productInputs, birincil veri kaynağına veya ek veri kaynağına yüklenip yüklenmediğine bağlı olarak birincil ve ek olabilir.
Her product, tek bir birincil productInput ve herhangi bir sayıda ek productInputs'den oluşur.
Online veya yerel mağaza katalogları oluşturmak için Merchant Products API'yi kullanabilirsiniz. Bu kataloglar, birden fazla alışveriş hedefinde gösterilebilecek ürünlerdir.
Merchant Center hesabınızı oluşturduktan, ilk veri kaynağınızı ayarladıktan ve API üzerinden ilk ürün grubunu yüklemeye hazır olduktan sonra productInputs kaynağını kullanabilirsiniz.
Satıcılar PrimaryProductDataSource adlı bir dosya kullanarak ürün yükleyebilir. Ancak Merchant API'yi kullanarak ürün oluşturmanın ve silmenin çeşitli avantajları vardır. Bu avantajlar arasında daha hızlı yanıt süresi ve büyük dosyaları yönetmeye gerek kalmadan ürünleri anlık olarak güncelleme olanağı yer alır. API çağrılarıyla yapılan ürün değişikliklerinin Alışveriş veritabanında görünmesi birkaç saat sürebilir.
Ön koşullar
Veri kaynağınız yoksa Merchant DataSources API'yi veya Merchant Center'ı kullanarak veri kaynağı oluşturun.
Merchant Center kullanıcı arayüzünü veya API'yi kullanarak oluşturduğunuz bir veri kaynağınız varsa Merchant Products API'yi kullanarak ürünlerinizi ekleyebilirsiniz. Ürün eklemek için Content API for Shopping'i kullanıyorsanız Merchant Products API'yi kullanmaya nasıl başlayacağınızı öğrenmek için taşıma rehberine bakın.
Alışveriş reklamları ve ücretsiz listelemeler politikalarına uyma konusunda sorumluluk size aittir. Alışveriş reklamları, bu politikaları uygulama ve bu politikaları ihlal eden içerik veya davranış tespit edersek uygun şekilde yanıt verme hakkını saklı tutar.
Kaynaklar
products kaynağı, Alışveriş veritabanından ürün bilgilerini almanıza olanak tanır.
productInput kaynağı, bir ürün için gönderdiğiniz giriş verilerini temsil eder. Ayrıca, ürün bilgilerini tek tek veya toplu modda birden fazla ürün bilgisini güncellemenize ya da silmenize olanak tanıyan yöntemler de sağlar. productInput kaynağında aşağıdaki alanlar bulunmalıdır:
channel: Ürünün kanalı.offerId: Ürünün benzersiz tanımlayıcısı.contentLanguage: Ürünün iki harfli ISO 639-1 dil kodu.feedLabel: Ürünün feed etiketi.
Hesabınıza ürün girişi yükleme
Hesabınıza ürün girişi yüklemek için accounts.productInputs.insert yöntemini kullanın. Birincil veya ek veri kaynağının benzersiz tanımlayıcısını iletmeniz gerekir.
Hesabınızdan işlenmiş bir ürünü alma
İşlenen bir ürünü hesabınızdan almak için accounts.products.get yöntemini kullanın. İşlenen ürünün eklendikten sonra görünmesi birkaç dakika sürebilir.
İşlenen ürünün kaynak adını accounts.productInputs.insert yanıtındaki product alanından alabilirsiniz.
Hesabınızdaki bir ürün girişini silme
Hesabınızdaki bir ürün girişini silmek için accounts.productInputs.delete yöntemini kullanın. Merchant Products API'yi kullanarak bir ürünü silmek için ürünün ait olduğu birincil veya ek veri kaynağının benzersiz tanımlayıcısını iletmeniz gerekir.
Hesabınızdaki ürünleri listeleme
Hesabınızda işlenen ürünleri listelemek için accounts.products.list yöntemini kullanın.