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 bản sao của tài nguyên kho hàng tại địa phương, trong đó chứa các trường có thể có giá trị khác nhau cho các vị trí cửa hàng thực tế khác nhau. Mỗi thực thể của 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 tại các cửa hàng khác nhau, nhưng lại có chung mã nhận dạng, nội dung mô tả và dữ liệu sản phẩm khác trên 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 việc bạn cần làm 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 đưa ra 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 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 cho 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à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ụ sản phẩm 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 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ể thông 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ả cá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ác trường đó, hãy xem trang 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 duy nhất.

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 bán hàng tại cửa hàng từ 1 giờ chiều ngày 24 tháng 2 năm 2021 (giờ GMT-8) cho đến 3:30 chiều ngày 28 tháng 2 năm 2021 (giờ GMT-8). Yêu cầu này cũng cập nhật số lượng hiện có 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 của cửa hàng địa phương, các trường không có trong phần nội dung của yêu cầu sẽ bị ghi đè bằng lệnh gọi sau:

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 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.