Bạn có thể sử dụng Merchant API để chia sẻ dữ liệu về kho hàng, cửa hàng và doanh số với Google nhằm tăng khả năng hiển thị và quản lý.
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:
- 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 nguồn cấp dữ liệu địa phương
- Một 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 mối quan hệ đố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 cho API mối quan hệ đố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 Phương thức: accounts.lfpInventories.insert.
Dưới đây là một ví dụ so sánh Content API for Shopping với API mối quan hệ đố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à một ví dụ so sánh Content API for Shopping với API mối quan hệ đối tác nguồn cấp dữ liệu địa phương cho yêu cầu chèn một lượt bán:
| 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à một ví dụ so sánh Content API for Shopping với API mối quan hệ đối tác nguồn cấp dữ liệu địa phương cho yêu cầu chèn một 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 nội dung đã thay đổi đối với các phương thức API cửa hàng trong API mối quan hệ đố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 là 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 là accounts/{IFP_PARTNER_ACCOUNT_ID} |
Sau đây là những nội dung đã thay đổi đối với các phương thức API kho hàng trong API mối quan hệ đố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 là accounts/{IFP_PARTNER_ACCOUNT_ID} |
Sau đây là những nội dung đã thay đổi đối với các phương thức API doanh số trong API mối quan hệ đố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}/lfpSales:insert |
{MERCHANT_ID}/pos/{TARGETMERCHANT_ID} |
{PARENT} | {PARENT} có định dạng là accounts/{IFP_PARTNER_ACCOUNT_ID} |
Tài nguyên
Sau đây là những nội dung đã thay đổi đối với tài nguyên cửa hàng trong API mối quan hệ đối tác nguồn cấp dữ liệu địa phương. Các trường không có trong danh sách này 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ông được hỗ trợ | targetAccount: integer |
Tài khoản Merchant Center để chèn kho hàng |
targetCountry: string |
regionCode: string |
targetCountry đã được đổi tên thành regionCode |
websiteUrl: string |
websiteUri: string |
websiteUrl đã được đổi tên thành websiteUri |
kind: string |
Không được hỗ trợ | kind không được hỗ trợ trong API mối quan hệ đối tác nguồn cấp dữ liệu địa phương |
Sau đây là những nội dung đã thay đổi đối với việc chèn một kho hàng. Các trường không có trong danh sách này 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 hàng |
| Không được hỗ trợ | targetAccount: integer |
Tài khoản Merchant Center để chèn kho hàng. |
targetCountry: string |
regionCode: string |
targetCountry đã được đổi tên thành regionCode. Mã lãnh thổ CLDR cho quốc gia nơi sản phẩm được bán. |
itemId: string |
offerId: string |
itemId đã được đổ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 đã được đổi tên thành collectionTime |
kind: string |
Không được hỗ trợ | kind không được hỗ trợ trong API mối quan hệ đối tác nguồn cấp dữ liệu địa phương. |
Sau đây là những nội dung đã thay đổi đối với việc chèn một lượt bán. Các trường không có trong danh sách này 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 hàng |
| Không được hỗ trợ | targetAccount:integer |
Tài khoản Merchant Center để chèn lượt bán |
targetCountry: string |
regionCode: string |
Mã lãnh thổ CLDR cho quốc gia nơi sản phẩm được bán. |
itemId: string |
offerId: string |
itemId đã được đổ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 đã được đổi tên thành saleTime |
kind: string |
Không được hỗ trợ | kind không được hỗ trợ trong API mối quan hệ đối tác nguồn cấp dữ liệu địa phương. |