REST Resource: monetization.onetimeproducts.purchaseOptions.offers

Tài nguyên: OneTimeProductOffer

Một ưu đãi duy nhất cho sản phẩm tính phí một lần.

Biểu diễn dưới dạng JSON 
{
  "packageName": string,
  "productId": string,
  "purchaseOptionId": string,
  "offerId": string,
  "state": enum (State),
  "regionalPricingAndAvailabilityConfigs": [
    {
      object (RegionalPricingAndAvailabilityConfig)
    }
  ],
  "offerTags": [
    {
      object (OfferTag)
    }
  ],
  "regionsVersion": {
    object (RegionsVersion)
  },

  // Union field offer_type can be only one of the following:
  "preOrderOffer": {
    object (OneTimeProductPreOrderOffer)
  },
  "discountedOffer": {
    object (OneTimeProductDiscountedOffer)
  }
  // End of list of possible types for union field offer_type.
}
Trường
packageName

string

Bắt buộc. Không thể thay đổi. Tên gói của ứng dụng mà sản phẩm mẹ thuộc về.
productId

string

Bắt buộc. Không thể thay đổi. Mã nhận dạng của sản phẩm gốc mà ưu đãi này thuộc về.
purchaseOptionId

string

Bắt buộc. Không thể thay đổi. Mã của lựa chọn mua mà ưu đãi này là một phần mở rộng.
offerId

string

Bắt buộc. Không thể thay đổi. Mã nhận dạng của sản phẩm này. Phải là duy nhất trong lựa chọn mua. Mã này phải bắt đầu bằng một chữ số hoặc chữ cái viết thường, đồng thời chỉ được chứa chữ cái viết thường (a-z), chữ số (0-9) và dấu gạch nối (-). Độ dài tối đa là 63 ký tự.
state

enum (State)

Chỉ có đầu ra. Trạng thái hiện tại của ưu đãi này. Bạn không thể thay đổi trường này bằng cách cập nhật tài nguyên. Thay vào đó, hãy sử dụng các điểm cuối chuyên dụng.
regionalPricingAndAvailabilityConfigs[]

object (RegionalPricingAndAvailabilityConfig)

Tập hợp thông tin về giá và tình trạng còn hàng theo khu vực cho sản phẩm này. Không được có các mục nhập trùng lặp có cùng regionCode.
offerTags[]

object (OfferTag)

Không bắt buộc. Danh sách gồm tối đa 20 thẻ tuỳ chỉnh được chỉ định cho mặt hàng này và được trả về cho ứng dụng thông qua thư viện thanh toán.
regionsVersion

object (RegionsVersion)

Chỉ có đầu ra. Phiên bản cấu hình khu vực được dùng để tạo sản phẩm tính phí một lần.
Trường nhóm offer_type. Loại ưu đãi này. Bạn phải đặt đúng một. offer_type chỉ có thể là một trong những trạng thái sau:
preOrderOffer

object (OneTimeProductPreOrderOffer)

Ưu đãi đặt hàng trước.
discountedOffer

object (OneTimeProductDiscountedOffer)

Ưu đãi giảm giá.

Tiểu bang

Trạng thái hiện tại của ưu đãi.

Enum
STATE_UNSPECIFIED Giá trị mặc định, không bao giờ được sử dụng.
DRAFT Người dùng chưa từng được cung cấp ưu đãi này.
ACTIVE Ưu đãi này dành cho người dùng, miễn là họ đáp ứng các điều kiện.
CANCELLED Trạng thái này dành riêng cho đơn đặt hàng trước. Ưu đãi bị huỷ và người dùng không thể sử dụng. Tất cả đơn đặt hàng đang chờ xử lý liên quan đến ưu đãi này đều đã bị huỷ.
INACTIVE Trạng thái này dành riêng cho các ưu đãi chiết khấu. Người dùng không còn được hưởng ưu đãi này nữa.

OneTimeProductPreOrderOffer

Cấu hình dành riêng cho ưu đãi đặt hàng trước.

Biểu diễn dưới dạng JSON 
{
  "startTime": string,
  "endTime": string,
  "releaseTime": string,
  "priceChangeBehavior": enum (PreOrderPriceChangeBehavior)
}
Trường
startTime

string (Timestamp format)

Bắt buộc. Thời gian bắt đầu mở đặt hàng trước.

Hãy dùng RFC 3339, trong đó dữ liệu đầu ra được tạo sẽ luôn được chuẩn hoá theo múi giờ và sử dụng 0, 3, 6 hoặc 9 chữ số thập phân. Các khoảng lệch khác ngoài "Z" cũng được chấp nhận. Ví dụ: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" hoặc "2014-10-02T15:01:23+05:30".
endTime

string (Timestamp format)

Bắt buộc. Thời gian mà người dùng không thể đặt hàng trước nữa.

Hãy dùng RFC 3339, trong đó dữ liệu đầu ra được tạo sẽ luôn được chuẩn hoá theo múi giờ và sử dụng 0, 3, 6 hoặc 9 chữ số thập phân. Các khoảng lệch khác ngoài "Z" cũng được chấp nhận. Ví dụ: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" hoặc "2014-10-02T15:01:23+05:30".
releaseTime

string (Timestamp format)

Bắt buộc. Thời gian phát hành sản phẩm liên kết với đơn đặt hàng trước và hoàn tất đơn đặt hàng trước.

Hãy dùng RFC 3339, trong đó dữ liệu đầu ra được tạo sẽ luôn được chuẩn hoá theo múi giờ và sử dụng 0, 3, 6 hoặc 9 chữ số thập phân. Các khoảng lệch khác ngoài "Z" cũng được chấp nhận. Ví dụ: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" hoặc "2014-10-02T15:01:23+05:30".
priceChangeBehavior

enum (PreOrderPriceChangeBehavior)

Bắt buộc. Không thể thay đổi. Cho biết mức độ ảnh hưởng của việc thay đổi giá đối với các đơn đặt hàng trước hiện có.

PreOrderPriceChangeBehavior

Cho biết mức độ ảnh hưởng của việc thay đổi giá đối với các đơn đặt hàng trước hiện có.

Enum
PRE_ORDER_PRICE_CHANGE_BEHAVIOR_UNSPECIFIED Hành vi thay đổi giá chưa được chỉ định. Không được sử dụng.
PRE_ORDER_PRICE_CHANGE_BEHAVIOR_TWO_POINT_LOWEST Người mua sẽ được tính mức giá thấp nhất giữa giá ban đầu tại thời điểm đặt hàng trước và giá ưu đãi cuối cùng vào ngày phát hành.
PRE_ORDER_PRICE_CHANGE_BEHAVIOR_NEW_ORDERS_ONLY Người mua sẽ nhận được mức giá giống như mức giá họ đã đặt trước, bất kể có thay đổi nào về giá sau khi đặt trước.

OneTimeProductDiscountedOffer

Cấu hình dành riêng cho các ưu đãi chiết khấu.

Biểu diễn dưới dạng JSON 
{
  "startTime": string,
  "endTime": string,
  "redemptionLimit": string
}
Trường
startTime

string (Timestamp format)

Thời gian ưu đãi bắt đầu có hiệu lực.

Hãy dùng RFC 3339, trong đó dữ liệu đầu ra được tạo sẽ luôn được chuẩn hoá theo múi giờ và sử dụng 0, 3, 6 hoặc 9 chữ số thập phân. Các khoảng lệch khác ngoài "Z" cũng được chấp nhận. Ví dụ: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" hoặc "2014-10-02T15:01:23+05:30".
endTime

string (Timestamp format)

Thời điểm ưu đãi sẽ ngừng được cung cấp.

Hãy dùng RFC 3339, trong đó dữ liệu đầu ra được tạo sẽ luôn được chuẩn hoá theo múi giờ và sử dụng 0, 3, 6 hoặc 9 chữ số thập phân. Các khoảng lệch khác ngoài "Z" cũng được chấp nhận. Ví dụ: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" hoặc "2014-10-02T15:01:23+05:30".
redemptionLimit

string (int64 format)

Không bắt buộc. Số lần ưu đãi này có thể được sử dụng. Nếu bạn không đặt hoặc đặt thành 0, thì người dùng có thể sử dụng ưu đãi không giới hạn. Nếu không, phải là một số từ 1 đến 50 (kể cả 1 và 50).

RegionalPricingAndAvailabilityConfig

Cấu hình giá và tình trạng còn hàng theo khu vực cho sản phẩm tính phí một lần.

Biểu diễn dưới dạng JSON 
{
  "regionCode": string,
  "availability": enum (Availability),

  // Union field price_override can be only one of the following:
  "noOverride": {
    object (OneTimeProductOfferNoPriceOverrideOptions)
  },
  "relativeDiscount": number,
  "absoluteDiscount": {
    object (Money)
  }
  // End of list of possible types for union field price_override.
}
Trường
regionCode

string

Bắt buộc. Mã vùng mà cấu hình này áp dụng, theo định nghĩa của ISO 3166-2, ví dụ: "US".
availability

enum (Availability)

Bắt buộc. Phạm vi cung cấp cho khu vực này.
Trường nhóm price_override. Giá thay thế của ưu đãi này. Bạn phải đặt đúng một. price_override chỉ có thể là một trong những trạng thái sau:
noOverride

object (OneTimeProductOfferNoPriceOverrideOptions)

Giá được xác định trong lựa chọn mua cho khu vực này sẽ được sử dụng.
relativeDiscount

number

Phần giá của lựa chọn mua mà người dùng trả cho ưu đãi này. Ví dụ: nếu giá của lựa chọn mua cho khu vực này là 120.000 VND, thì chiết khấu 50% sẽ tương ứng với giá là 60.000 VND. Bạn phải chỉ định chiết khấu dưới dạng một phân số lớn hơn 0 và nhỏ hơn 1. Giá cuối cùng sẽ được làm tròn đến đơn vị có thể tính phí gần nhất (ví dụ: xu đối với USD). Chiết khấu tương đối được coi là không hợp lệ nếu giá chiết khấu thấp hơn giá tối thiểu được phép ở khu vực này.
absoluteDiscount

object (Money)

Giá trị tuyệt đối của khoản chiết khấu được trừ vào giá của lựa chọn mua.

Giá này phải nằm trong khoảng từ 0 đến giá của lựa chọn mua.

OneTimeProductOfferNoPriceOverrideOptions

Loại này không có trường nào.

Các lựa chọn cho ưu đãi sản phẩm tính phí một lần mà không có giá thay thế theo khu vực.

Phạm vi cung cấp

Phạm vi cung cấp ưu đãi.

Enum
AVAILABILITY_UNSPECIFIED Tình trạng còn hàng không được chỉ định. Không được sử dụng.
AVAILABLE Ưu đãi này dành cho người dùng.
NO_LONGER_AVAILABLE Người dùng không còn được hưởng ưu đãi này nữa. Bạn chỉ có thể sử dụng giá trị này nếu trước đó bạn đặt trạng thái còn hàng là CÒN HÀNG.

Phương thức

activate

 Kích hoạt ưu đãi sản phẩm tính phí một lần.

batchDelete

 Xoá một hoặc nhiều ưu đãi sản phẩm tính phí một lần.

batchGet

 Đọc một hoặc nhiều ưu đãi về sản phẩm tính phí một lần.

batchUpdate

 Tạo hoặc cập nhật một hoặc nhiều ưu đãi sản phẩm tính phí một lần.

batchUpdateStates

 Cập nhật một loạt trạng thái của sản phẩm tính phí một lần.

cancel

 Huỷ ưu đãi cho sản phẩm tính phí một lần.

deactivate

 Huỷ kích hoạt ưu đãi sản phẩm tính phí một lần.

list

 Liệt kê tất cả ưu đãi trong một ứng dụng, sản phẩm hoặc lựa chọn mua hàng nhất định.

Mã lỗi

Các thao tác của tài nguyên này sẽ trả về các mã lỗi HTTP sau:

Mã lỗi Lý do Độ phân giải
5xx Lỗi chung trong máy chủ Google Play. Hãy thử gửi lại yêu cầu.

Nếu vấn đề vẫn tiếp diễn, hãy liên hệ với người quản lý tài khoản Google Play hoặc gửi yêu cầu hỗ trợ. Hãy cân nhắc kiểm tra Trang tổng quan về trạng thái của Play để xem có sự cố ngừng hoạt động nào đã biết hay không.
409 Lỗi cập nhật đồng thời.

Đã có một nỗ lực cập nhật một đối tượng đang được cập nhật. Ví dụ: giao dịch mua được xác nhận bằng cách gọi phương thức acknowledgePurchase() của Thư viện Play Billing và gọi purchases.products.acknowledge của API Nhà phát triển Play cùng một lúc.

 Hãy thử gửi lại yêu cầu.