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 phiên bản của kho hàng tại địa phương là một phần tử con của 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 của 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ó chung 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 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 gì bạn cần 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ề yêu cầu dịch vụ.

Lưu ý: Trong phiên bản 2.1 của Content API, dịch vụ kho hàng tại địa phương và nguồn cấp dữ liệu bổ sung sẽ thay thế dịch vụ kho hàng trong phiên bản 2. Để cập nhật một phần dữ liệu sản phẩm không phải dữ liệu cục bộ bằng API phiên bản 2.1, hãy sử dụng nguồn cấp dữ liệu bổ sung. Để cập nhật sản phẩm bổ sung tại địa phương, hãy sử dụng dịch vụ localinventory.

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

  Lưu ý: Nếu tài khoản Merchant Center của bạn chưa đăng ký tham gia chương trình địa phương, việc đặt trường channel của sản phẩm thành local thông qua phương thức Products.insert sẽ dẫn đến lỗi: "channel Không hợp lệ kênh: địa phương".

• Dịch vụ kho hàng tại địa phương tạo thực thể 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 dịch vụ sản phẩm của Content API hoặc nguồn cấp dữ liệu 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.

Các trường

Mỗi phiên bản của kho hàng tại địa phương chứa một tập hợp các trường 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 của mình). Chỉ cần sử dụng storecode và productId cho 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ả 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ả, hãy xem trang tham khảo về localinventory (Kho hàng tại địa phương).

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 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 chương trình giảm giá tại cửa hàng từ 1:00 chiều ngày 24 tháng 2 năm 2021 đến 3:30 chiều ngày 28 tháng 2 năm 2021 (theo giờ GMT-8). Yêu cầu này cũng cập nhật số lượng hàng có sẵn cho thực thể 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 đị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 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 địa phương duy nhất trong 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.

Lưu ý: Bạn không thể truy xuất, liệt kê hoặc xoá các thực thể kho hàng tại địa phương. Để xem dữ liệu kho hàng tại địa phương trong Merchant Center, hãy chọn một sản phẩm tại cửa hàng địa phương trên trang Tất cả sản phẩm, sau đó mở rộng phần Kho hàng tại địa phương. Bảng này trình bày dữ liệu kho hàng tại địa phương cho từng mã cửa hàng.