Method: accounts.productInputs.insert

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

string

Zorunlu. Bu ürünün ekleneceği hesap. Biçim: accounts/{hesap}

Sorgu parametreleri

Parametreler
dataSource

string

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: accounts/{account}/dataSources/{datasource}.

İ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şlenmiş [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 (ChannelEnum),
  "offerId": string,
  "contentLanguage": string,
  "feedLabel": string,
  "attributes": {
    object (Attributes)
  },
  "customAttributes": [
    {
      object (CustomAttribute)
    }
  ],
  "versionNumber": string
}
Alanlar
name

string

Tanımlayıcı. Ürün girişinin adı. Biçim: "{productinput.name=accounts/{account}/productInputs/{productinput}}"
product

string

Yalnızca çıkış. İşlenen ürünün adı. Biçim: "{product.name=accounts/{account}/products/{product}}"
channel

enum (ChannelEnum)

Zorunlu. Sabit. Ürünün kanalı.
offerId

string

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

string

Zorunlu. Sabit. Ürünün iki harfli ISO 639-1 dil kodu.
feedLabel

string

Zorunlu. Sabit. Ürünün feed etiketi.
attributes

object (Attributes)

İsteğe bağlı. Ürün özelliklerinin listesi.
customAttributes[]

object (CustomAttribute)

İsteğe bağlı. Özel (satıcı tarafından sağlanan) özelliklerin listesi. Ayrıca veri spesifikasyonunun herhangi bir özelliğini genel biçiminde (ör. { "name": "size type", "value": "regular" }) göndermek için de kullanılabilir. Bu, Google ile Satın Al için kullanılan ek özellikler gibi API tarafından açıkça gösterilmeyen özellikleri göndermek için kullanışlıdır. Her özel özellik için izin verilen maksimum karakter sayısı 10.240'tır (ad ve değer karakterlerinin toplamını gösterir). Ürün başına maksimum 2500 özel özellik belirlenebilir ve toplam boyut 102, 4 kB'tır. Özel özellik adlarındaki alt çizgiler, eklendikten sonra boşlukla değiştirilir.
versionNumber

string (int64 format)

İ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 versionNumber ile yeniden ekleme (örneğin, 30 gün sonra ürün yenileme) işlemi gerçekleştirilebilir.

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.