Bạn có thể sử dụng Merchant API để tải lên và quản lý sản phẩm bằng cách lập trình. Tài nguyên accounts.products cho phép bạn tạo danh mục cửa hàng trực tuyến, tức là danh sách sản phẩm và ưu đãi. Để biết thêm thông tin về cách tải sản phẩm lên và quản lý sản phẩm bằng Merchant API, hãy xem phần Tổng quan về Merchant Products API.
Thay đổi về tài nguyên
Các tài nguyên products và productstatuses của Content API được thay thế bằng các tài nguyên productInputs và products.
Bạn có thể sử dụng tài nguyên productInputs của Merchant API để tải thông tin sản phẩm lên. Bạn có thể sử dụng tài nguyên product của Merchant API để truy xuất các sản phẩm đã xử lý, bao gồm cả trạng thái.
Yêu cầu về nguồn dữ liệu
Trong Merchant API, bạn phải chỉ định nguồn dữ liệu mục tiêu khi tải sản phẩm lên. Đây có thể là nguồn dữ liệu chính hoặc nguồn dữ liệu bổ sung. Bạn có thể truy xuất các nguồn dữ liệu hiện có bằng cách sử dụng dataSources.list hoặc tạo một nguồn dữ liệu mới bằng cách sử dụng dataSources.create.
Ngoài ra, bạn có thể sử dụng giao diện người dùng Merchant Center để quản lý các nguồn dữ liệu của mình.
Để biết thêm thông tin về nguồn dữ liệu cũng như cách tạo và quản lý nguồn dữ liệu, hãy xem bài viết Tổng quan về Merchant Data Sources API.
Thay đổi về giá trị nhận dạng
Merchant API sử dụng tên để xác định sản phẩm. Tên sản phẩm sẽ tuân theo định dạng accounts/{account}/products/{product}, trong đó {product} có định dạng channel~language~feedLabel~offerId.
Các tài nguyên Content API sử dụng : thay vì ~ giữa mỗi giá trị trong mã nhận dạng: channel:language:feedLabel:offerId.
Tất cả lệnh gọi Merchant API đều trả về định dạng mới với ~ nằm giữa các giá trị của mã nhận dạng. Bạn nên lưu trữ trường name mới từ phản hồi và sử dụng trường này trong các lệnh gọi trong tương lai.
Phương thức
Dưới đây là thông tin so sánh các phương thức sản phẩm trong Content API for Shopping và Merchant Products API:
| Content API for Shopping | Merchant Products API |
|---|---|
| products.custombatch | Không có |
| products.insert | productInputs.insert |
| products.update | Chưa có |
| products.delete | productInputs.delete |
| products.get | products.get |
| products.list | products.list |
| productstatuses.custombatch | Không có |
| productstatuses.get | products.get |
| productstatuses.list | products.list |
Yêu cầu
| Phương thức Content API | URL trong Content API for Shopping | URL trong Merchant Products API | Giá trị nhận dạng trong Content API | Giá trị nhận dạng trong Merchant Products API |
|---|---|---|---|---|
products.insert |
POST https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/products |
POST https://merchantapi.googleapis.com/products/v1beta/{PARENT}/productsInputs:insert?dataSource=accounts/{MERCHANT_ID}/dataSources/{DATASOURCE_ID} |
MERCHANT_ID | PARENT=accounts/{MERCHANT_ID} |
products.update |
PATCH https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/products/{PRODUCT_ID} |
Không có | ||
products.delete |
DELETE https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/products/{PRODUCT_ID} |
DELETE https://merchantapi.googleapis.com/products/v1beta/{NAME}?dataSource=accounts/{MERCHANT_ID}/dataSources/{DATASOURCE_ID} |
MERCHANT_ID, PRODUCT_ID | NAME=accounts/{MERCHANT_ID}/productInputs/{PRODUCT_ID_WITH_TILDES} |
products.get |
GET https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/products/{PRODUCT_ID} |
GET https://merchantapi.googleapis.com/products/v1beta/{NAME} |
MERCHANT_ID, PRODUCT_ID | NAME=accounts/{MERCHANT_ID}/products/{PRODUCT_ID_WITH_TILDES} |
products.list |
GET https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/products |
GET https://merchantapi.googleapis.com/products/v1beta/{PARENT}/products |
MERCHANT_ID | PARENT=accounts/{MERCHANT_ID} |
productstatuses.get |
GET https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/productstatuses/{PRODUCT_ID} |
GET https://merchantapi.googleapis.com/products/v1beta/{NAME} |
MERCHANT_ID, PRODUCT_ID | NAME=accounts/{MERCHANT_ID}/products/{PRODUCT_ID_WITH_TILDES} |
productstatuses.list |
GET https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/productstatuses |
GET https://merchantapi.googleapis.com/products/v1beta/{PARENT}/products |
MERCHANT_ID | PARENT=accounts/{MERCHANT_ID} |