Bạn có thể sử dụng Merchant API để chia sẻ dữ liệu về kho hàng, cửa hàng và lượt bán hàng với Google nhằm tăng khả năng hiển thị và quản lý hiệu quả hơn.
Tính năng mới
Ngoài các tính năng của Content API, Merchant API còn cung cấp các tính năng mới sau:
- Phương thức truy xuất trạng thái của các tài sản cấp người bán liên quan đến việc tích hợp đối tác nguồn cấp dữ liệu địa phương
- Phương thức gửi thông báo cho nhà bán lẻ
Để biết thông tin chi tiết về các phương thức này, hãy xem API đối tác nguồn cấp dữ liệu địa phương.
Yêu cầu
Sử dụng định dạng URL yêu cầu sau đây cho API đối tác nguồn cấp dữ liệu địa phương:
POST https://merchantapi.googleapis.com/lfp/v1beta/{PARENT}/lfpInventories:insert
Để biết thêm thông tin, hãy xem Phương thức: accounts.lfpInventories.insert.
Dưới đây là thông tin so sánh mẫu về Content API for Shopping với API đối tác nguồn cấp dữ liệu tại địa phương cho yêu cầu chèn khoảng không quảng cáo:
Content API | Merchant API | |
URL |
POST https://shoppingcontent.googleapis.com/content/v2.1/ {MERCHANT_ID}/pos/ {TARGETMERCHANT_ID}/inventory
|
POST https://merchantapi.googleapis.com/lfp/v1beta/ {PARENT}/lfpInventories:insert
|
Giá trị nhận dạng |
{MERCHANT_ID}/pos/ {TARGETMERCHANT_ID}
|
{PARENT} |
Dưới đây là ví dụ so sánh Content API for Shopping với API đối tác nguồn cấp dữ liệu cục bộ cho yêu cầu chèn chương trình ưu đãi:
Content API | Merchant API | |
URL | POST https://shoppingcontent.googleapis.com/content/v2.1/ {MERCHANT_ID}/pos/ {TARGETMERCHANT_ID}/sale |
POST https://merchantapi.googleapis.com/lfp/v1beta/ {PARENT}/lfpSales:insert |
Giá trị nhận dạng | {MERCHANT_ID}/pos/ {TARGETMERCHANT_ID} |
{PARENT} |
Dưới đây là ví dụ so sánh Content API for Shopping với API đối tác nguồn cấp dữ liệu cục bộ cho yêu cầu chèn cửa hàng:
Content API | Merchant API | |
URL | POST https://shoppingcontent.googleapis.com/content/v2.1/ {MERCHANT_ID}/pos/ {TARGETMERCHANT_ID}/store |
POST https://merchantapi.googleapis.com/lfp/v1beta/ {PARENT}/lfpStores:insert |
Giá trị nhận dạng | {MERCHANT_ID}/pos/ {TARGETMERCHANT_ID} |
{PARENT} |
Phương thức
Sau đây là những thay đổi đối với các phương thức API cửa hàng trong API đối tác nguồn cấp dữ liệu địa phương:
Phương thức | URL trong Content API for Shopping | URL trong Merchant API | Giá trị nhận dạng trong Content API for Shopping | Giá trị nhận dạng trong Merchant API | Mô tả |
insert |
POST https://shoppingcontent.googleapis.com/content/v2.1/ {MERCHANT_ID}/pos/ {TARGETMERCHANT_ID}/store |
POST https://merchantapi.googleapis.com/lfp/v1beta/ {parent=accounts/*}/lfpStores:insert |
{MERCHANT_ID}/pos /{TARGETMERCHANT_ID} |
{PARENT} | parent có định dạng accounts/{IFP_PARTNER_ACCOUNT_ID} |
delete |
DELETE https://shoppingcontent.googleapis.com/content/v2.1/ {MERCHANT_ID}/pos/ {TARGETMERCHANT_ID}/store/ {STORE_CODE} |
DELETE https://merchantapi.googleapis.com/lfp/v1beta/ {name=accounts/*/lfpStores/*} |
{MERCHANT_ID}/pos/ {TARGETMERCHANT_ID}/store/ {STORE_CODE} |
{NAME} | name có định dạng accounts/ {IFP_PARTNER_ACCOUNT_ID}/lfpStores/ {TARGETMERCHANT_ID}~{STORE_CODE} |
get |
GET https://shoppingcontent.googleapis.com/content/v2.1/ {MERCHANT_ID}/pos/ {TARGETMERCHANT_ID}/store/ {STORE_CODE} |
GET https://merchantapi.googleapis.com/lfp/v1beta/ {name=accounts/*/lfpStores/*} |
{MERCHANT_ID}/pos/ {TARGETMERCHANT_ID}/store/ {STORE_CODE} |
{NAME} | name có định dạng accounts/ {IFP_PARTNER_ACCOUNT_ID}/lfpStores/ {TARGETMERCHANT_ID}~{STORE_CODE} |
list |
GET https://shoppingcontent.googleapis.com/content/v2.1/ {MERCHANT_ID}/pos/ {TARGETMERCHANT_ID}/store |
GET https://merchantapi.googleapis.com/lfp/v1beta/ {parent=accounts/*}/lfpStores |
/{MERCHANT_ID}/pos/ {TARGETMERCHANT_ID} |
{PARENT} | {PARENT} có định dạng accounts/ {IFP_PARTNER_ACCOUNT_ID} |
Sau đây là những điểm thay đổi đối với các phương thức API kho hàng trong API đối tác nguồn cấp dữ liệu địa phương:
Phương thức | URL trong Content API for Shopping | URL trong Merchant API | Giá trị nhận dạng trong Content API for Shopping | Giá trị nhận dạng trong Merchant API | Mô tả |
insert |
POST https://shoppingcontent.googleapis.com/content/v2.1/ {MERCHANT_ID}/pos/ {TARGETMERCHANT_ID}/store |
POST https://merchantapi.googleapis.com/lfp/v1beta/ {PARENT}/lfpInventories:insert |
{MERCHANT_ID}/pos/ {TARGETMERCHANT_ID} |
{PARENT} | parent có định dạng accounts/ {IFP_PARTNER_ACCOUNT_ID} |
Sau đây là những thay đổi đối với các phương thức API bán hàng trong API đối tác nguồn cấp dữ liệu tại địa phương:
Phương thức | URL trong Content API for Shopping | URL trong Merchant API | Giá trị nhận dạng trong Content API for Shopping | Giá trị nhận dạng trong Merchant API | Mô tả |
insert |
POST https://shoppingcontent.googleapis.com/content/v2.1/ {MERCHANT_ID}/pos/ {TARGETMERCHANT_ID}/store |
POST https://merchantapi.googleapis.com/lfp/v1beta/ {PARENT}/lfpSales:insert |
{MERCHANT_ID}/pos/ {TARGETMERCHANT_ID} |
{PARENT} | {PARENT} có định dạng accounts/ {IFP_PARTNER_ACCOUNT_ID} |
Tài nguyên
Sau đây là những thay đổi đối với tài nguyên cửa hàng trong API đối tác nguồn cấp dữ liệu tại địa phương. Các trường không có trong danh sách này sẽ không thay đổi.
Content API for Shopping | Merchant API | Mô tả |
Không thể làm | name: string |
Thêm trường mới để phân biệt các cửa hàng |
Không thể làm | targetAccount: integer |
Tài khoản người bán để chèn khoảng không quảng cáo |
targetCountry: string |
regionCode: string |
targetCountry đổi tên thành regionCode . |
websiteUrl: string |
websiteUri: string |
websiteUrl đổi tên thành websiteUri . |
kind: string |
Không thể làm | kind không được hỗ trợ trong API đối tác nguồn cấp dữ liệu địa phương |
Sau đây là những điểm thay đổi đối với việc chèn khoảng không quảng cáo. Các trường không có trong danh sách này sẽ không thay đổi.
Content API for Shopping | Merchant API | Mô tả |
Không thể làm | name: string |
Thêm trường mới để phân biệt các khoảng không quảng cáo |
Không thể làm | targetAccount: integer |
Tài khoản người bán để chèn khoảng không quảng cáo. |
targetCountry: string |
regionCode: string |
targetCountry đổi tên thành regionCode Mã lãnh thổ CLDR của quốc gia nơi sản phẩm được bán. |
itemId: string |
offerId: string |
itemId đổi tên thành offerId . |
quantity: string |
quantity: string |
quantity đã được cập nhật để trở thành không bắt buộc |
Không thể làm | availability: string |
availability là bắt buộc |
|
|
Định nghĩa về giá đã thay đổi. Để biết thêm thông tin, hãy xem phần Giá. |
timestamp: string |
collectionTime: string |
timestamp đổi tên thành collectionTime . |
kind: string |
Không thể làm | kind không được hỗ trợ trong API đối tác nguồn cấp dữ liệu địa phương. |
Sau đây là những điểm thay đổi đối với việc chèn chương trình ưu đãi. Các trường không có trong danh sách này sẽ không thay đổi.
Content API for Shopping | Merchant API | Mô tả |
Không thể làm | name: string |
Thêm trường mới để phân biệt các khoảng không quảng cáo |
Không thể làm | targetAccount:integer |
Tài khoản người bán để chèn lượt bán hàng |
targetCountry: string |
regionCode: string |
Mã lãnh thổ CLDR của quốc gia nơi sản phẩm được bán. |
itemId: string |
offerId: string |
itemId đổi tên thành offerId . |
|
|
Định nghĩa về giá đã thay đổi. Để biết thêm thông tin, hãy xem phần Giá. |
timestamp: string |
saleTime: string |
timestamp đổi tên thành saleTime . |
kind: string |
Không thể làm | kind không được hỗ trợ trong API đối tác nguồn cấp dữ liệu địa phương. |