Halaman ini diterjemahkan oleh Cloud Translation API.

Jasa inventaris lokal

Layanan inventaris lokal memungkinkan Anda membuat dan memperbarui instance resource inventaris lokal, yang berisi kolom yang dapat memiliki nilai yang 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 dengan harga dan jumlah berbeda di toko yang berbeda, tetapi memiliki ID, deskripsi, dan data produk lainnya di semua toko. Data inventaris lokal digunakan untuk program Platform Google lokal dan Iklan Inventaris Lokal.

Panduan ini menjelaskan hal yang Anda perlukan 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, dan menyiapkan kode toko Profil Bisnis Anda.
Akun Merchant Center Anda harus terdaftar dalam program lokal: Platform Google lokal atau Iklan inventaris lokal. Untuk mengetahui informasi selengkapnya tentang penggunaan iklan inventaris lokal melalui Content API, lihat Memulai Iklan Inventaris Lokal.

Catatan: Jika akun Merchant Center Anda tidak terdaftar dalam program lokal, menyetel kolom channel produk ke local, melalui metode Products.insert, akan menyebabkan error: "channel Saluran tidak valid: lokal".
Layanan inventaris lokal membuat instance inventaris lokal untuk produk lokal yang sudah ada. Anda harus terlebih dahulu membuat produk lokal, menggunakan layanan produk Content API atau datafeeds Merchant Center, dengan menetapkan kolom channel ke local. Anda kemudian dapat menggunakan layanan inventaris lokal untuk membuat instance inventaris lokal untuk setiap storecode Profil Bisnis tempat produk dijual.

Kolom

Setiap instance inventaris lokal berisi kumpulan kolom yang dikaitkan dengan lokasi toko tertentu melalui kolom storeCode (yang Anda tentukan di Profil Bisnis). 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 menyertakan 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 obral di toko dari 24 Februari 2021 pukul 13.00 (GMT-8) hingga 28 Februari 2021 pukul 15.30 (GMT-8). Permintaan tersebut 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 ditimpa 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.