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 Merchant Promotions API để tạo và quản lý chương trình khuyến mãi của người bán 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 những 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 API.

Tổng quan về những thay đổi từ Content API for Shopping sang Merchant API

Một điểm khác biệt đáng chú ý là Content API for Shopping sẽ tự động tạo nguồn dữ liệu khi bạn chèn chương trình khuyến mãi lần đầu tiên, nhưng Merchant API thì không. Để chèn chương trình khuyến mãi bằng Merchant API, trước tiên bạn cần tạo nguồn dữ liệu khuyến mãi. Để biết thông tin về các trường trong đối tượng promotionDataSource thuộc tài nguyên accounts.dataSources, hãy xem PromotionDataSource.

Yêu cầu

Để đưa ra yêu cầu, hãy sử dụng URL sau.

POST https://merchantapi.googleapis.com/promotions/v1/{ACCOUNT_NAME}/promotions

Di chuyển từ Content API for Shopping

Sau đây là so sánh giữa Content API for Shopping và Merchant Promotions API đối với các yêu cầu liên quan đến chương trình khuyến mãi của người bán.

URL

Trong Content API for Shopping:

https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/promotions

trong Merchant API sẽ trở thành:

https://merchantapi.googleapis.com/promotions/v1/{parent=accounts/*}/promotions

Giá trị nhận dạng

Trong Content API for Shopping:

{MERCHANT_ID}/promotions/{PROMOTION_ID}

trong Merchant API sẽ trở thành:

{NAME}

Phương thức

Merchant API hỗ trợ các phương thức sau cho chương trình khuyến mãi:

  • Chèn chương trình khuyến mãi
  • Nhận chương trình khuyến mãi
  • Liệt kê chương trình khuyến mãi

Sau đây là so sánh về tính năng của các phương thức khuyến mãi trong Content API for Shopping và Merchant API:

Tính năng Content API for Shopping Merchant API
URL https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/promotions https://merchantapi.googleapis.com/promotions/v1/{parent=accounts/*}/promotions
Giá trị nhận dạng {MERCHANT_ID}/promotions/{PROMOTION_ID} {NAME}
Phương thức
  • insert
  • get
  • list
  • customBatch
  • delete
  • insert
  • get
  • list
  • delete

Thay đổi về trường

Bảng này cho biết những thay đổi đối với Chương trình khuyến mãi của người bán trong Merchant Promotions API.

Để xem ví dụ tham khảo, hãy xem bài viết Kho hàng tại địa phương.

Content API for Shopping Merchant API Mô tả
(không được hỗ trợ) custom_attributes Danh sách các thuộc tính tuỳ chỉnh (do người dùng cung cấp). Bạn cũng có thể
sử dụng thuộc tính này để gửi mọi thuộc tính của quy cách nguồn cấp dữ liệu
ở dạng chung.
Ví dụ: 
{
  "name": "size type", "value": "regular"
}
Điều này hữu ích khi gửi các thuộc tính mà API không hiển thị
một cách rõ ràng.
Không được hỗ trợ data_source Để tạo chương trình khuyến mãi, bạn cần có một nguồn dữ liệu hiện có.
Không được hỗ trợ attributes Các thuộc tính dành riêng cho chương trình khuyến mãi, chẳng hạn như
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 mã cửa hàng mà chương trình khuyến mãi áp dụng
được đổi tên.
product_type product_type_inclusion Danh sách loại sản phẩm mà chương trình khuyến mãi áp dụng
được đổi tên.
item_group_id item_group_id_inclusion Danh sách 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 thương hiệu mà chương trình khuyến mãi áp dụng
được đổi tên.
store_code store_codes_inclusion Danh sách mã cửa hàng mà chương trình khuyến mãi áp dụng
được đổi tên. 
price:
  {
    object (Price)
  }

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

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

Số tiền Giá hiện được ghi lại theo đơn vị một phần triệu,
trong đó 1 triệu đơn vị một phần triệu tương đương với đơn vị tiêu chuẩn
của đơn vị tiền tệ.

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

Tên trường currency đã thay đổ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ợ) money_budget không được hỗ trợ.
promotion_destination_ids promotion_destinations promotionDestinationIds được đổi tên.
Trạng thái chương trình khuyến mãi 
{
  "destinationStatuses": [
    {
      "destination": string,
      "status": enum (State)
    }
  ],
  "promotionIssue": [
    {
    "code": string,
    "detail": string
    }
  ],
  "creationDate": string,
  "lastUpdateDate": string
}
Trạng thái chương trình khuyến mãi đã thay đổi.
Bạn có thể xem thông tin chi tiết ở cấp độ chi tiết hơn trong các 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,
    ]
    }
  ]
}