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 nhà bán hàng trên Google. Tài nguyên accounts.promotions giúp bạn giới thiệu các ưu đãi đặc biệt cho 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 nhà bán hàng API.

Thông tin tổng quan về những thay đổi khi chuyển 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 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 bài viết PromotionDataSource.

Nguồn dữ liệu hiện có

Đối với các nguồn dữ liệu hiện có, nếu bạn không biết accounts.dataSources.name, hãy sử dụng dataSources.list để truy xuất.

Ngoài ra, bạn có thể xác định nguồn dữ liệu cho từng chương trình khuyến mãi bằng cách sử dụng phương thức accounts.promotions.get và kiểm tra trường dataSource trong nội dung phản hồi của mọi chương trình khuyến mãi hiện có trong tài khoản của bạn.

Để tham chiếu trực tiếp đến các chương trình khuyến mãi trong các lệnh gọi API trong tương lai, bạn nên lưu trữ accounts.dataSources.name trong cơ sở dữ liệu cục bộ cho mỗi chương trình khuyến mãi.

Yêu cầu

Để gửi 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à thông tin 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 của nhà bán hàng.

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 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

Sau đây là thông tin so sánh về khả năng sử dụng các phương thức khuyến mãi trong Content API for Shopping và Merchant API:

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 nhà bán hàng trong Merchant Promotions API.

Để xem ví dụ tham khảo, hãy xem accounts.promotions.

{
  "name": "size type", "value": "regular"
}

price:
  {
    object (Price)
  }

price:
  {
    object (Price)
  }

{
  "destinationStatuses": [
    {
      "destination": string,
      "status": enum (State)
    }
  ],
  "promotionIssue": [
    {
    "code": string,
    "detail": string
    }
  ],
  "creationDate": string,
  "lastUpdateDate": string
}

promotionStatus = {
  destinationStatuses = [
     {
     reportingContext = Enum
     status = Enum
     },
  ],
  itemLevelIssues = [
    {
    code = String
    severity = Enum
    resolution = String
    reportingContext = Enum
    description = String
    detail = String
    documentation = String applicableCountries = [
      String,
    ]
    }
  ]
}