- HTTP isteği
- Yol parametreleri
- Sorgu parametreleri
- İstek metni
- Yanıt metni
- Yetkilendirme kapsamları
- Deneyin.
Merchant Center hesabınıza bir ürün girişi yükler. Aynı contentLanguage, offerId ve dataSource'a sahip bir giriş zaten varsa bu yöntem söz konusu girişin yerini alır.
Bir ürün girişini ekledikten, güncelledikten veya sildikten sonra, işlenen ürünün alınması birkaç dakika sürebilir.
HTTP isteği
POST https://merchantapi.googleapis.com/products/v1beta/{parent=accounts/*}/productInputs:insert
URL, gRPC Kod Dönüştürme söz dizimini kullanır.
Yol parametreleri
Parametreler | |
---|---|
parent |
Zorunlu. Bu ürünün ekleneceği hesap. Biçim: accounts/{hesap} |
Sorgu parametreleri
Parametreler | |
---|---|
dataSource |
Zorunlu. Birincil veya ek ürün veri kaynağı adı. Ürün zaten mevcutsa ve sağlanan veri kaynağı farklıysa ürün yeni bir veri kaynağına taşınır. Biçim: |
İstek içeriği
İstek metni, ProductInput
öğesinin bir örneğini içerir.
Yanıt gövdesi
Bu kaynak; Merchant Center'da, Alışveriş reklamlarında veya Google platformlarında gördüğünüz işlenmiş ürün değil, bir ürün için gönderdiğiniz giriş verilerini temsil eder. Ürün girişleri, kurallar ve ek veri kaynağı verileri bir araya getirilerek işlenen [product][google.shopping.content.bundles.Products.Product] oluşturulur.
Veri doğrulama kontrollerini geçmek için gerekli ürün girişi özellikleri birincil olarak Ürün Verileri Spesifikasyonu'nda tanımlanmıştır.
Şu özellikler gereklidir: [feedLabel][google.shopping.content.bundles.Products.feed_label], [contentLanguage][google.shopping.content.bundles.Products.content_language] ve [offerId][google.shopping.content.bundles.Products.offer_id].
Bir ürün girişini ekledikten, güncelledikten veya sildikten sonra, işlenen ürünün alınması birkaç dakika sürebilir.
Ürün girişi ve alt mesajlarındaki tüm alanlar, bazı istisnalar dışında, sektör spesifikasyonundaki karşılık gelen özelliğin İngilizce adıyla eşleşir.
Başarılı olursa yanıt metni aşağıdaki yapıyla birlikte verileri içerir:
JSON gösterimi |
---|
{ "name": string, "product": string, "channel": enum ( |
Alanlar | |
---|---|
name |
Tanımlayıcı. Ürün girişinin adı. Biçim: |
product |
Yalnızca çıkış. İşlenen ürünün adı. Biçim: |
channel |
Zorunlu. Sabit. Ürünün kanalı. |
offerId |
Zorunlu. Sabit. Ürün için benzersiz tanımlayıcınızdır. Bu değer, ürün girişi ve işlenen ürün için aynıdır. Gönderildikten sonra baştaki ve sondaki boşluklar kaldırılır ve birden fazla boşluk tek bir boşlukla değiştirilir. Ayrıntılar için ürün verileri spesifikasyonuna bakın. |
contentLanguage |
Zorunlu. Sabit. Ürünün iki harfli ISO 639-1 dil kodu. |
feedLabel |
Zorunlu. Sabit. Ürünün feed etiketi. |
attributes |
İsteğe bağlı. Ürün özelliklerinin listesi. |
customAttributes[] |
İsteğe bağlı. Özel (satıcı tarafından sağlanan) özelliklerin listesi. Ayrıca, veri spesifikasyonunun herhangi bir özelliğini genel biçiminde (örneğin, |
versionNumber |
İsteğe bağlı. Ürünün mevcut sürümünü (güncelliğini) gösterir. Bu sürüm, aynı anda birden fazla güncelleme yapıldığında doğru sırayı korumak için kullanılabilir. Ayarlanırsa sürüm numarası mevcut ürünün geçerli sürüm numarasından düşük olduğunda ekleme işlemi engellenir. Mevcut Yalnızca birincil veri kaynaklarına yapılan eklemeler için desteklenir. İşlem engellenirse iptal edilen istisna uygulanır. |
Yetkilendirme kapsamları
Aşağıdaki OAuth kapsamını gerektirir:
https://www.googleapis.com/auth/content
Daha fazla bilgi için OAuth 2.0 Overview (OAuth 2.0'a Genel Bakış) sayfasına göz atın.