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.
Aşağıdaki örnek istek, satıcı hesabınıza ürün girişi yüklemek için accounts.productInputs.insert yöntemini nasıl kullanabileceğinizi gösterir. İstek, kargo fiyatını ve bölgesini, ayrıca üretim tarihi ve beden gibi özel özellikleri belirler.
POST https://merchantapi.googleapis.com/products/v1beta/accounts/{ACCOUNT_ID}/productInputs:insert?dataSource={DATASOURCE}
{
"name": "{PRODUCT_TITLE}",
"versionNumber": {VERSION_NUMBER},
"contentLanguage": "{CONTENT_LANGUAGE}",
"feedLabel": "{FEED_LABEL}",
"offerId": "{OFFER_ID}",
"channel": "ONLINE",
"attributes": {
"availability": "in stock",
"imageLink": "{IMAGE_LINK}",
"link": "{PRODUCT_LINK}",
"brand": "{BRAND_NAME}",
"price": {
"currencyCode": "{CURRENCY_CODE}",
"amountMicros": {PRICE}
},
"color": "red",
"productWeight": {
"value": 320,
"unit": "g"
},
"adult": false,
"shipping": [
{
"country": "GB",
"price": {
"amountMicros": {SHIPPING_COST},
"currencyCode": "{CURRENCY_CODE_SHIPPING}"
},
"postalCode": "{SHIPPING_POSTALCODE}",
"service": "",
"region": "{SHIPPING_REGION}",
"maxHandlingTime": "{MAX_HANDLING_TIME}",
"minHandlingTime": "{MIN_HANDLING_TIME}",
"maxTransitTime": "{MAX_TRANSIT_TIME}",
"minTransitTime": "{MIN_TRANSIT_TIME}"
}
],
"gender": "Female"
},
"customAttributes": [
{
"name": "size",
"value": "Large"
},
{
"name": "Date of Manufacturing",
"value": "2024-05-05"
}
]
}
Aşağıdakini değiştirin:
- {ACCOUNT_ID}: Merchant Center hesabınızın benzersiz tanımlayıcısı.
- {DATASOURCE}: Veri kaynağının benzersiz tanımlayıcısı.
accounts/{ACCOUNT_ID}/dataSources/{DATASOURCE_ID} biçiminde olmalıdır. - {PRODUCT_TITLE}: Ürünün adı.
- {VERSION_NUMBER}: Ürünün sürüm numarası. İsteğe bağlı.
- {CONTENT_LANGUAGE}: Ürünün iki harfli ISO 639-1 dil kodu. Zorunlu.
- {FEED_LABEL}: Ürünü satmak istediğiniz bölgenin CLDR bölge kodu.
feedLabeliçin sağlanan değer geçerli değilsetargetCountryalanı doldurulmaz. - {OFFER_ID}: Ürünün benzersiz tanımlayıcısıdır. Zorunlu.
- {IMAGE_LINK}: Ürünün web sitenizdeki resminin bağlantısı. İsteğe bağlı.
- {PRODUCT_LINK}: Web sitenizdeki ürünün bağlantısı. İsteğe bağlı.
- {CURRENCY_CODE}: ISO 4217'ye göre üç harfli kısaltmalar kullanılarak fiyatın para birimi. İsteğe bağlı.
- {PRICE}: Ürünün fiyatı, mikro cinsinden bir sayı olarak temsil edilir. İsteğe bağlı.
- {SHIPPING_COST}: Sabit kargo fiyatı, sayı olarak temsil edilir. İsteğe bağlı.
- {SHIPPING_POSTALCODE}: Kargo ücretinin geçerli olduğu posta kodu aralığı. İsteğe bağlı.
- {MAX_HANDLING_TIME}: Sipariş alındığı tarih ile gönderildiği tarih arasında iş günü cinsinden maksimum sevkiyata hazırlık süresi. İsteğe bağlı.
- {MIN_HANDLING_TIME}: Sipariş alındığı tarih ile gönderildiği tarih arasındaki minimum sevkiyata hazırlık süresi (iş günü cinsinden). 0 değeri, siparişin alındığı gün teslim edildiği anlamına gelir. İsteğe bağlı.
- {MAX_TRANSIT_TIME}: Sipariş gönderildikten teslim edilene kadar iş günü cinsinden maksimum nakliye süresi. İsteğe bağlı.
- {MIN_TRANSIT_TIME}: Siparişin gönderildiği tarih ile teslim edildiği tarih arasında iş günü cinsinden minimum nakliye süresi. 0 değeri, siparişin gönderildiği gün teslim edildiği anlamına gelir. İsteğe bağlı.
İstek başarıyla çalıştırıldığında aşağıdaki yanıtı görürsünüz:
{
"name": "{PRODUCT_NAME}",
"product": "{PRODUCT_ID}",
"channel": "ONLINE",
"offerId": "{OFFER_ID}",
"contentLanguage": "{CONTENT_LANGUAGE}",
"feedLabel": "{FEED_LABEL}",
"versionNumber": "{VERSION_NUMBER}",
"attributes": {
"link": "{PRODUCT_LINK}",
"imageLink": "{IMAGE_LINK}",
"adult": false,
"availability": "in stock",
"brand": "{BRAND_NAME}",
"color": "red",
"gender": "Female",
"price": {
"amountMicros": "{PRICE}",
"currencyCode": "{CURRENCY_CODE}"
},
"shipping": [
{
"price": {
"amountMicros": "{SHIPPING_COST}",
"currencyCode": "{CURRENCY_CODE}"
},
"country": "{SHIPPING_COUNTRY}",
"region": "{SHIPPING_REGION}",
"postalCode": "{SHIPPING_POSTALCODE}",
"minHandlingTime": "{MIN_HANDLING_TIME}",
"maxHandlingTime": "{MAX_HANDLING_TIME}",
"minTransitTime": "{MIN_TRANSIT_TIME}",
"maxTransitTime": "{MAX_TRANSIT_TIME}"
}
],
"productWeight": {
"value": 320,
"unit": "g"
}
},
"customAttributes": [
{
"name": "Size",
"value": "Large"
},
{
"name": "Date of Manufacturing",
"value": "2024-05-05"
}
]
}
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.