Yerel envanter hizmeti, yerel envanter kaynağının örneklerini oluşturup güncellemenizi sağlar. Bu örnekler, farklı fiziksel mağaza konumları için farklı değerlere sahip olabilecek alanlar içerir. 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 fiyat ve miktarları farklı 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 rehberde, yerel envanter hizmetini kullanmaya başlamadan önce nelere ihtiyacınız olduğu ve kullanılabilecek alanlar ile yöntemler açıklanmakta ve hizmet isteği örneği sağlanmaktadı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ı ayarlamanı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. Bunun için
channel
alanınılocal
olarak ayarlayıp Content API ürünleri hizmetini veya Merchant Center veri feed'lerini kullanarak önce yerel ürünler oluşturmanız gerekir. Ardından, ürünün satıldığı her İşletme Profilistorecode
için yerel envanter örnekleri oluşturmak amacıyla yerel envanter hizmetini kullanabilirsiniz.
Alanlar
Her yerel envanter örneği, storeCode
alanı üzerinden belirli bir mağaza konumuyla ilişkilendirilmiş bir alan grubu içerir (bunu İşletme Profilinizde tanımlarsınız). 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 tam listesi ve açıklamaları 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ıza olanak tanır.
Bu örnekte, 24 Şubat 2021 saat 13:00'dan (GMT-8) 28 Şubat 2021 saat 15:30'a (GMT-8) kadar mağaza içi indirim 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. Yerel olmayan ürün verileri için ek feed'lerin aksine, bu çağrı, isteğin gövdesine dahil olmayan 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ıza olanak tanır.