Yerel envanter hizmeti

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

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.