Yerel envanter hizmeti

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

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.