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 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ề Merchant Promotions 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 kể là Content API for Shopping 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, điều này không xảy ra với Merchant API. Để chèn một chương trình khuyến mãi bằng Merchant API, trước tiên bạn cần phải tạo một nguồn dữ liệu khuyến mãi. Để biết thông tin về các trường trong đối tượng promotionDataSource trong 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à nội dung so sánh Content API for Shopping với Merchant Promotions 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/{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
  • Tham gia chương trình khuyến mãi
  • Khuyến mãi trong danh sách

Sau đây là bảng so sánh khả năng cung cấp 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 trong Merchant Promotions API.

Để xem ví dụ tham khảo, hãy xem 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"
}
Thuộc tính này hữu ích khi gửi các thuộc tính không được API
hiển thị một cách rõ ràng.
Không được hỗ trợ data_source Để tạo một 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ợ thuộc tính Các thuộc tính dành riêng cho 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 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 các 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ưới dạng chuỗi.

Giờ đây, số tiền Giá đượ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ợ) Không hỗ trợ money_budget.
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 của chương trình khuyến mãi đã thay đổi.
Bạn có thể xem thêm 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,
    ]
    }
  ]
}