Di chuyển mối quan hệ đối tác nguồn cấp dữ liệu địa phương

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

price: {

object (Price)

}

price: {

object (Price)

}

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

price: {

object (Price)

}

price: {

object (Price)

}

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