Dịch vụ kho hàng tại địa phương cho phép bạn tạo và cập nhật các phiên bản của tài nguyên kho hàng tại địa phương, chứa các trường có thể có các giá trị khác nhau cho các vị trí cửa hàng thực tế khác nhau. Mỗi phiên bản của kho hàng tại địa phương là một phiên bản con của một tài nguyên sản phẩm hiện có, và kế thừa các trường dữ liệu sản phẩm từ tài nguyên mẹ. Ví dụ: bạn có thể có một sản phẩm có giá và số lượng tuỳ từng cửa hàng, nhưng có chia sẻ mã nhận dạng, nội dung mô tả, v.v. dữ liệu sản phẩm tại tất cả các cửa hàng. Dữ liệu kho hàng tại địa phương được dùng để Các nền tảng của Google tại địa phương và Quảng cáo kho hàng tại địa phương các chương trình.
Hướng dẫn này giải thích những điều bạn cần trước khi bắt đầu sử dụng kho hàng tại địa phương dịch vụ, mô tả các trường và phương thức có sẵn, đồng thời cung cấp ví dụ về yêu cầu dịch vụ.
Điều kiện tiên quyết
- Để sử dụng dịch vụ kho hàng tại địa phương, bạn phải tạo một Trang doanh nghiệp, liên kết Trang doanh nghiệp với tài khoản Merchant Center, xác minh doanh nghiệp của bạn và thiết lập mã cửa hàng trên Trang doanh nghiệp.
Tài khoản Merchant Center của bạn phải được đăng ký tham gia một chương trình tại địa phương: Các nền tảng của Google tại địa phương hoặc Quảng cáo kho hàng tại địa phương. Để biết thêm thông tin về cách sử dụng quảng cáo kho hàng tại địa phương thông qua Content API, hãy xem Bắt đầu sử dụng Quảng cáo kho hàng tại địa phương.
Dịch vụ kho hàng tại địa phương tạo các phiên bản kho hàng tại địa phương cho những Trước tiên, bạn phải tạo các sản phẩm tại cửa hàng địa phương bằng cách sử dụng Dịch vụ sản phẩm API hoặc Nguồn cấp dữ liệu Merchant Center, theo đặt trường
channelthànhlocal. Sau đó, bạn có thể dùng kho hàng tại địa phương để tạo các bản sao kho hàng tại địa phương cho từng Trang doanh nghiệpstorecode, nơi bán sản phẩm.
Trường
Mỗi phiên bản kho hàng tại địa phương chứa một tập hợp các trường được liên kết với một
vị trí cửa hàng cụ thể qua trường storeCode (mà bạn xác định trong
Trang doanh nghiệp). Chỉ
storecode
và
productId
là bắt buộc đối với tất cả yêu cầu. Tất cả các trường khác là không bắt buộc:
- Bắt buộc đối với tất cả các yêu cầu:
storeCode,productId(trong URL) - Không bắt buộc:
quantity,price,salePrice,salePriceEffectiveDate,availability,pickupMethod,pickupSla,instoreProductLocation
Để xem danh sách đầy đủ các trường kho hàng tại địa phương và nội dung mô tả của các trường đó, hãy xem Tài liệu tham khảo về localinventory .
Phương thức
Dịch vụ kho hàng tại địa phương chỉ bao gồm 2 phương thức:
localinventory.insert
localinventory.insert
cho phép bạn tạo một phiên bản kho hàng tại địa phương cho một sản phẩm tại cửa hàng địa phương.
Ví dụ này minh hoạ cách sử dụng dịch vụ kho hàng tại địa phương để tạo lượt bán hàng tại cửa hàng thực tế từ Từ 13:00 ngày 24/02/2021 (theo giờ GMT-8) đến 15:30 ngày 28/02/2021 (giờ GMT-8). Yêu cầu này cũng cập nhật số lượng hiện có cho kho hàng tại địa phương thực thể. Bỏ thích nguồn cấp dữ liệu bổ sung đối với dữ liệu sản phẩm không phải tại địa phương, các trường không có trong phần nội dung của yêu cầu đã bị ghi đè bằng lệnh gọi này:
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
cho phép bạn tạo nhiều phiên bản kho hàng tại địa phương cho một
sản phẩm tại cửa hàng địa phương tại nhiều cửa hàng hoặc tạo các phiên bản kho hàng tại địa phương cho
nhiều sản phẩm tại cửa hàng địa phương.