Bạn có thể sử dụng Merchant API để chia sẻ kho hàng, cửa hàng và dữ liệu bán hàng với Google để 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 đây:
- Một phương thức để truy xuất trạng thái của các thuộc tính ở cấp doanh nghiệp liên quan đến việc tích hợp mối quan hệ đối tác về 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 bài viết API chương trình đố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 chương trình đối tác nguồn cấp dữ liệu địa phương:
POST https://merchantapi.googleapis.com/lfp/v1/{PARENT}/lfpInventories:insert
Để biết thêm thông tin, hãy xem bài viết Phương thức: accounts.lfpInventories.insert.
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 địa phương cho yêu cầu chèn một kho hàng:
| 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/v1/{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 địa phương cho yêu cầu chèn một đợt giảm giá:
| 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/v1/{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 địa phương 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/v1/{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 chương trình đố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/v1/{parent=accounts/*}/lfpStores:insert |
{MERCHANT_ID}/pos/{TARGETMERCHANT_ID} |
{PARENT} | parent có định dạng là 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/v1/{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/v1/{name=accounts/*/lfpStores/*} |
{MERCHANT_ID}/pos/{TARGETMERCHANT_ID}/store/{STORE_CODE} |
{NAME} | name có định dạng là 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/v1/{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 chương trình đố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/v1/{PARENT}/lfpInventories:insert |
{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 bán hàng trong API quan hệ đối tác về 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/v1/{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 chương trình đối tác nguồn cấp dữ liệu địa phương. Các trường không có trong đây sẽ không thay đổi.
| Content API for Shopping | Merchant API | Mô tả |
| Không được hỗ trợ | name: string |
Thêm trường mới để phân biệt các cửa hàng khác nhau |
| Không được hỗ trợ | targetAccount: integer |
Tài khoản Merchant Center để chèn kho hàng |
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 được hỗ trợ | kind không được hỗ trợ trong API chương trình đối tác nguồn cấp dữ liệu địa phương |
Sau đây là những 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 đây sẽ không thay đổi.
| Content API for Shopping | Merchant API | Mô tả |
| Không được hỗ trợ | name: string |
Thêm trường mới để phân biệt các khoảng không quảng cáo khác nhau |
| Không được hỗ trợ | targetAccount: integer |
Tài khoản Merchant Center để chèn kho hàng. |
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 thành không bắt buộc |
| Không được hỗ trợ | 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 bài viết Giá. |
timestamp: string |
collectionTime: string |
timestamp đổi tên thành collectionTime. |
kind: string |
Không được hỗ trợ | kind không được hỗ trợ trong API chương trình đối tác nguồn cấp dữ liệu địa phương. |
Sau đây là những thay đổi đối với việc chèn một chương trình giảm giá. Các trường không có trong đây sẽ không thay đổi.
| Content API for Shopping | Merchant API | Mô tả |
| Không được hỗ trợ | name: string |
Thêm trường mới để phân biệt các khoảng không quảng cáo khác nhau |
| Không được hỗ trợ | targetAccount:integer |
Tài khoản Merchant Center để chèn doanh số 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 bài viết Giá. |
timestamp: string |
saleTime: string |
timestamp đổi tên thành saleTime. |
kind: string |
Không được hỗ trợ | kind không được hỗ trợ trong API chương trình đối tác nguồn cấp dữ liệu địa phương. |