Di chuyển tính năng quản lý chương trình khuyến mãi

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ý chương trình khuyến mãi trên Google. Chiến lược phát hành đĩa đơ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ề 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à thông tin so sánh Content API for Shopping với chương trình khuyến mãi của người bán API 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à phần so sánh khả năng sử dụng các phương thức khuyến mãi trong Content API cho Mua sắm và API người bán:

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ụ để tham khảo, hãy xem phần Địa phương Khoảng không quảng cáo.

Content API for Shopping API người bán 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ó thể
bạn cũng có thể sử dụng nó để gửi bất kỳ thuộc tính nào của nguồn cấp dữ liệu
ở dạng chung chung.
Ví dụ: 
{
  "name": "size type", "value": "regular"
}
Điều này hữu ích khi gửi các thuộc tính không rõ ràng
mà API hiển thị.
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 đều nằm trong thông báo thuộc tính.
item_id item_id_inclusion Danh sách mã mặt hàng được áp dụng chương trình khuyến mãi
đã được đổi tên.
store_id store_id_inclusion Danh sách các mã cửa hàng áp dụng chương trình khuyến mãi
sẽ được đổi tên.
prduct_type product_type_inclusion Danh sách các loại sản phẩm áp dụng chương trình khuyến mãi
sẽ được đổi tên.
item_group_id item_group_id_inclusion Danh sách các mã nhóm mặt hàng được áp dụng chương trình khuyến mãi
sẽ đượ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
sẽ được đổi tên.
store_code store_codes_inclusion Danh sách mã cửa hàng áp dụng chương trình khuyến mãi
sẽ được đổi tên. 
price: {
  object (Price)
}

price: {
  object (Price)
}
Định nghĩa của Giá đã thay đổi.

Trong Content API for Shopping, mục Price (Giá)
là một số thập phân ở dạng chuỗi.

Số tiền Price hiện được ghi lại dưới dạng phần triệu,
trong đó 1 triệu micros tương đương với đơn vị tiền tệ của bạn
đơn vị chuẩn.

Tên trường amount đã thay đổi từ giá trị thành
amountMicros.

Tên trường currency đã đổi thành
currencyCode. Định dạng vẫn là
ISO 4217. (Wikipedia)

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ông tin chi tiết hơn ở cấp độ 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,
    ]
    }
  ]
}