Jasa inventaris lokal

Layanan inventaris lokal memungkinkan Anda membuat dan memperbarui instance resource inventaris lokal, yang berisi kolom yang dapat memiliki nilai berbeda untuk lokasi toko fisik yang berbeda. Setiap instance inventaris lokal adalah turunan dari resource produk yang ada, dan mewarisi kolom data produk dari resource induk. Misalnya, Anda mungkin memiliki produk yang memiliki harga dan jumlah yang berbeda di toko yang berbeda, tetapi memiliki ID, deskripsi, dan data produk lainnya yang sama di semua toko. Data inventaris lokal digunakan untuk program Platform lokal Google dan Iklan Inventaris Lokal.

Panduan ini menjelaskan hal-hal yang Anda butuhkan sebelum mulai menggunakan layanan inventaris lokal, menjelaskan kolom dan metode yang tersedia, serta memberikan contoh permintaan layanan.

Prasyarat

  • Untuk menggunakan layanan inventaris lokal, Anda harus membuat Profil Bisnis, menautkan Profil Bisnis ke akun Merchant Center, memverifikasi bisnis Anda, dan menyiapkan kode toko Profil Bisnis.

  • Akun Merchant Center Anda harus terdaftar dalam program lokal: baik Platform Google lokal atau Iklan inventaris lokal. Untuk mengetahui informasi selengkapnya tentang cara menggunakan iklan inventaris lokal melalui Content API, lihat artikel Mulai Menggunakan Iklan Inventaris Lokal.

  • Layanan inventaris lokal membuat instance inventaris lokal untuk produk lokal yang ada. Anda harus membuat produk lokal terlebih dahulu, menggunakan layanan produk Content API atau feed data Merchant Center, dengan menetapkan kolom channel ke local. Kemudian, Anda dapat menggunakan layanan inventaris lokal untuk membuat instance inventaris lokal untuk setiap Profil Bisnis storecode tempat produk dijual.

Kolom

Setiap instance inventaris lokal berisi serangkaian kolom yang dikaitkan dengan lokasi toko tertentu melalui kolom storeCode (yang Anda tentukan di Profil Bisnis Anda). Hanya storecode dan productId yang diperlukan untuk semua permintaan. Semua kolom lainnya bersifat opsional:

  • Wajib untuk semua permintaan: storeCode, productId (di URL)
  • Opsional: quantity, price, salePrice, salePriceEffectiveDate, availability, pickupMethod, pickupSla, instoreProductLocation

Untuk mengetahui daftar lengkap kolom inventaris lokal dan deskripsinya, lihat halaman referensi localinventory.

Metode

Layanan inventaris lokal hanya mencakup dua metode:

localinventory.insert

localinventory.insert memungkinkan Anda membuat instance inventaris lokal untuk satu produk lokal.

Contoh ini menunjukkan cara menggunakan layanan inventaris lokal untuk membuat promo di toko dari 24 Februari 2021 pukul 13.00 (GMT-8) hingga 28 Februari 2021 pukul 15.30 (GMT-8). Permintaan ini juga memperbarui jumlah yang tersedia untuk instance inventaris lokal. Tidak seperti feed tambahan untuk data produk non-lokal, kolom yang tidak disertakan dalam isi permintaan akan digantikan oleh panggilan ini:

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 memungkinkan Anda membuat beberapa instance inventaris lokal untuk satu produk lokal di beberapa toko, atau membuat instance inventaris lokal untuk beberapa produk lokal.