Bạn có thể sử dụng API Chương trình khuyến mãi của người bán để tạo và quản lý các chương trình khuyến mãi trên Google. Tài nguyên accounts.promotions cho phép bạn giới thiệu các ưu đãi đặc biệt cho các sản phẩm mà bạn bán trên Google. Để biết thêm thông tin, hãy xem bài viết Tổng quan về API Chương trình khuyến mãi của người bán.
Yêu cầu
Để đưa ra yêu cầu, vui lòng sử dụng URL sau.
POST https://merchantapi.googleapis.com/promotions/v1beta/{account_name}/promotions
Di chuyển từ Content API for Shopping
Dưới đây là so sánh Content API for Shopping với API Chương trình khuyến mãi của người bán cho các yêu cầu liên quan đến chương trình khuyến mãi.
URL
Trong Content API for Shopping:
https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/promotions
trong API Merchant trở thành:
https://merchantapi.googleapis.com/promotions/v1beta/{parent=accounts/*}/promotions
Giá trị nhận dạng
Trong Content API for Shopping:
{merchantId}/promotions/{promotionId}
trong API Merchant trở thành:
{name}
Phương thức
Merchant API hỗ trợ các phương thức sau đây cho chương trình khuyến mãi:
- Chèn chương trình khuyến mãi
- Nhận khuyến mãi
- Liệt kê chương trình khuyến mãi
Dưới đây là so sánh khả năng sử dụng các phương thức khuyến mãi trong Content API for Shopping và Merchant API:
| Phương thức | Content API for Shopping | API người bán |
|---|---|---|
| chèn | Có | Có |
| nhận | Có | Có |
| list | Có | Có |
| customBatch | Không | Không |
| xóa | Không | (Sẽ được xác định) |
Tên tài nguyên
Bảng này cho biết những thay đổi đối với Chương trình khuyến mãi trong API Chương trình khuyến mãi của người bán.
Để xem ví dụ về tài liệu tham khảo, hãy xem bài viết Local Inventory (Khoảng không quảng cáo cục bộ).
| Content API for Shopping | API người bán | Nội dung mô tả |
|---|---|---|
| (không được hỗ trợ) | custom_attributes |
Danh sách các thuộc tính tuỳ chỉnh (do người bán cung cấp). Bạn cũng có thể cũng sử dụng thuộc tính này để gửi bất kỳ thuộc tính nào trong quy cách nguồn cấp dữ liệu ở dạng chung. Ví dụ:
{
"name": "size type", "value": "regular"
}
Thông tin này hữu ích khi gửi các thuộc tính không
mà API hiển thị một cách rõ ràng. |
| Không thể làm | data_source | Để tạo chương trình khuyến mãi, bạn phải có sẵn một nguồn dữ liệu. |
| Không thể làm | thuộc tính |
Các thuộc tính cụ thể của chương trình khuyến mãi, ví dụ: long_tile, promotion_effective_timeperiod, và các thuộc tính khác là một phần của thông báo thuộc tính. |
| item_id | item_id_inclusion |
Danh sách mã mặt hàng mà chương trình khuyến mãi áp dụng
đã được đổi tên. |
| store_id | store_id_inclusion |
Danh sách các mã cửa hàng mà chương trình khuyến mãi áp dụng
đã được đổi tên. |
| prduct_type | product_type_inclusion |
Danh sách các loại sản phẩm được áp dụng chương trình khuyến mãi
đã được đổi tên. |
| item_group_id | item_group_id_inclusion |
Danh sách các mã nhóm mặt hàng mà chương trình khuyến mãi áp dụng
đã được đổi tên. |
| brand | brand_inclusion |
Danh sách các thương hiệu được áp dụng chương trình khuyến mãi
đã được đổi tên. |
| store_code | store_codes_inclusion |
Danh sách các mã cửa hàng áp dụng chương trình khuyến mãi
đã được đổi tên. |
price: {
object (Price)
}
|
price: {
object (Price)
}
|
Định nghĩa của Giá đã thay đổi.
Trong Content API for Shopping, Price (Giá)
Số tiền Price hiện được ghi lại ở dạng phần triệu,
Tên trường amount đã thay đổi từ giá trị thành
Tên trường currency đã thay đổi thành
|
| order_limit | (không được hỗ trợ) | Thuộc tính order_limit không được hỗ trợ. |
| shippingServiceNames[] | (không được hỗ trợ) | shippingServiceNames[] không được hỗ trợ. |
| money_budget | (không được hỗ trợ) | Không hỗ trợ money_budget. |
| promotion_destination_ids | promotion_destinations | promotionDestinationIds được đổi tên. |
Trạng thái khuyến mãi
{
"destinationStatuses": [
{
"destination": string,
"status": enum (State)
}
],
"promotionIssue": [
{
"code": string,
"detail": string
}
],
"creationDate": string,
"lastUpdateDate": string
}
|
Trạng thái khuyến mãi đã thay đổi.
Bạn có thể xem thêm thông tin chi tiết trong vấn đề.
promotionStatus = {
destinationStatuses = [
{
reportingContext = Enum
status = Enum
},
],
itemLevelIssues = [
{
code = String
severity = Enum
resolution = String
reportingContext = Enum
description = String
detail = String
documentation = String applicableCountries = [
String,
]
}
]
}
|
|