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, 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ươngQuả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

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