Dịch vụ kho hàng tại địa phương

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, trong đó có các trường có thể có nhiều giá trị cho nhiều địa điểm cửa hàng thực tế. Mỗi phiên bản kho hàng tại địa phương là một phần tử 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 khác nhau ở các cửa hàng khác nhau, nhưng có cùng mã nhận dạng, nội dung mô tả và dữ liệu sản phẩm khác ở tất cả các cửa hàng. Dữ liệu kho hàng tại địa phương được dùng cho các chương trình 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.

Hướng dẫn này giải thích những điều bạn cần biết trước khi bắt đầu sử dụng dịch vụ kho hàng tại địa phương, mô tả các trường và phương thức có sẵn, đồng thời cung cấp ví dụ về một 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 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 và thiết lập mã cửa hàng trong Trang doanh nghiệp.

  • Tài khoản Merchant Center của bạn phải đăng ký một chương trình tại địa phương: Các nền tảng tại địa phương trên Google 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ài viết 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 các sản phẩm tại cửa hàng địa phương hiện có. Trước tiên, bạn phải tạo sản phẩm tại cửa hàng địa phương bằng cách sử dụng dịch vụ products của Content API hoặc datafeeds của Merchant Center bằng cách đặt trường channel thành local. Sau đó, bạn có thể sử dụ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 từng Trang doanh nghiệp storecode nơi sản phẩm được bán.

Trường

Mỗi phiên bản kho hàng tại địa phương đều chứa một nhóm trường được liên kết với một vị trí cửa hàng cụ thể thông qua trường storeCode (bạn xác định trong Trang doanh nghiệp). Chỉ có storecode và productId là bắt buộc đối với tất cả các yêu cầu. Tất cả các trường khác đều 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 này, hãy xem trang tham chiếu 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 đị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 chương trình khuyến mãi tại cửa hàng từ 13:00 ngày 24 tháng 2 năm 2021 (GMT-8) cho đến 15:30 ngày 28 tháng 2 năm 2021 (GMT-8). Yêu cầu này cũng cập nhật số lượng có sẵn cho phiên bản kho hàng tại địa phương. Không giống như nguồn cấp dữ liệu bổ sung cho dữ liệu sản phẩm không phải tại địa phương, các trường không có trong nội dung yêu cầu sẽ 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.custombatchcho phép bạn tạo nhiều mục kho hàng tại địa phương cho một sản phẩm tại địa phương ở nhiều cửa hàng hoặc tạo mục kho hàng tại địa phương cho nhiều sản phẩm tại địa phương.