Yerel envanter hizmeti, farklı fiziksel mağaza konumları için farklı değerlere sahip olabilecek alanlar içeren yerel envanter kaynağının örneklerini oluşturmanıza ve güncellemenize olanak tanır. Her yerel envanter örneği, mevcut bir ürün kaynağının alt öğesidir ve ürün verisi alanlarını üst kaynaktan devralır. Örneğin, farklı mağazalarda farklı fiyat ve miktarlara sahip olan ancak tüm mağazalarda kimliği, açıklaması ve diğer ürün verilerini paylaşan bir ürününüz olabilir. Yerel envanter verileri, Yerel Google platformları ve Yerel Envanter Reklamları programları için kullanılır.
Bu kılavuzda, yerel envanter hizmetini kullanmaya başlamadan önce nelere ihtiyacınız olduğu, kullanılabilir alanlar ve yöntemler açıklanmakta ve bir hizmet isteği örneği sunulmaktadır.
Ön koşullar
- Yerel envanter hizmetini kullanmak için İşletme Profili oluşturmanız, İşletme Profilinizi Merchant Center hesabınıza bağlamanız, işletmenizi doğrulamanız ve İşletme Profili mağaza kodlarınızı oluşturmanız gerekir.
Merchant Center hesabınız, bir yerel programa kayıtlı olmalıdır: Yerel Google platformları veya Yerel envanter reklamları. Content API aracılığıyla yerel envanter reklamlarını kullanma hakkında daha fazla bilgi için Yerel Envanter Reklamlarını Kullanmaya Başlama bölümüne bakın.
Yerel envanter hizmeti, mevcut yerel ürünler için yerel envanter örnekleri oluşturur. Öncelikle
channel
alanınılocal
olarak ayarlayıp Content API ürünleri hizmetini veya Merchant Center veri feed'lerini kullanarak yerel ürünler oluşturmanız gerekir. Daha sonra, yerel envanter hizmetini kullanarak ürünün satıldığı her İşletme Profilistorecode
için yerel envanter örnekleri oluşturabilirsiniz.
Alanlar
Her yerel envanter örneği, storeCode
alanı (İşletme Profilinizde tanımlar) aracılığıyla belirli bir mağaza konumuyla ilişkilendirilen bir alan grubu içerir. Tüm istekler için yalnızca storecode
ve productId
gereklidir. Diğer tüm alanlar isteğe bağlıdır:
- Tüm istekler için gerekli:
storeCode
,productId
(URL'de) - İsteğe bağlı:
quantity
,price
,salePrice
,salePriceEffectiveDate
,availability
,pickupMethod
,pickupSla
,instoreProductLocation
Yerel envanter alanlarının ve açıklamalarının tam listesi için localinventory referans sayfasına bakın.
Yöntemler
Yerel envanter hizmeti yalnızca iki yöntem içerir:
localinventory.insert
localinventory.insert
, tek bir yerel ürün için yerel envanter örneği oluşturmanızı sağlar.
Bu örnekte, 24 Şubat 2021 saat 13:00'ten (GMT-8) 28 Şubat 2021 15:30'a (GMT-8) kadar mağaza içi satış oluşturmak için yerel envanter hizmetinin nasıl kullanılacağı gösterilmektedir. İstek, yerel envanter örneği için kullanılabilen miktarı da günceller. Bu çağrı, yerel olmayan ürün verileri için ek feed'lerin aksine isteğin gövdesinde yer almayan alanların üzerine yazılır:
POST https://shoppingcontent.googleapis.com/content/v2.1/merchantId/products/productId/localinventory
{
"storeCode": “1235”,
"salePrice": {
"value": “100.00”,
"currency": “USD”
},
"salePriceEffectiveDate": “2021-02-24T13:00-0800/2021-02-28T15:30-0800”,
"quantity": 200,
}
localinventory.custombatch
localinventory.custombatch
, birden fazla mağazadaki tek bir yerel ürün için birden fazla yerel envanter örneği veya birden fazla yerel ürün için yerel envanter örnekleri oluşturmanızı sağlar.