REST Resource: monetization.subscriptions.basePlans.offers

Tài nguyên: SubscriptionOffer

Một ưu đãi tạm thời duy nhất

Biểu diễn dưới dạng JSON 
{
  "packageName": string,
  "productId": string,
  "basePlanId": string,
  "offerId": string,
  "state": enum (State),
  "phases": [
    {
      object (SubscriptionOfferPhase)
    }
  ],
  "targeting": {
    object (SubscriptionOfferTargeting)
  },
  "regionalConfigs": [
    {
      object (RegionalSubscriptionOfferConfig)
    }
  ],
  "otherRegionsConfig": {
    object (OtherRegionsSubscriptionOfferConfig)
  },
  "offerTags": [
    {
      object (OfferTag)
    }
  ]
}
Trường
packageName

string

Bắt buộc. Bất biến. Tên gói của ứng dụng có chứa gói thuê bao gốc.
productId

string

Bắt buộc. Bất biến. Mã của gói thuê bao mẹ chứa ưu đãi này.
basePlanId

string

Bắt buộc. Bất biến. Mã của gói cơ bản mà ưu đãi này là một tiện ích.
offerId

string

Bắt buộc. Bất biến. Mã nhận dạng duy nhất của ưu đãi thuê bao này. Phải là duy nhất trong gói cơ bản.
state

enum (State)

Chỉ có đầu ra. Trạng thái hiện tại của ưu đãi này. Có thể thay đổi bằng thao tác Kích hoạt và Huỷ kích hoạt. Lưu ý: Trạng thái của gói cơ bản sẽ thay thế trạng thái này. Vì vậy, ưu đãi đang hoạt động có thể không xuất hiện nếu gói cơ bản không hoạt động.
phases[]

object (SubscriptionOfferPhase)

Bắt buộc. Các giai đoạn của gói thuê bao này. Phải chứa ít nhất một mục nhập và có thể chứa tối đa năm mục nhập. Người dùng sẽ luôn nhận được tất cả các giai đoạn này theo thứ tự đã chỉ định. Bạn không thể thêm, xoá hoặc sắp xếp lại các giai đoạn sau lần tạo đầu tiên.
targeting

object (SubscriptionOfferTargeting)

Các yêu cầu mà người dùng cần đáp ứng để đủ điều kiện nhận ưu đãi này. Thể hiện những yêu cầu mà Play sẽ đánh giá để quyết định xem có nên trả về một ưu đãi hay không. Nhà phát triển có thể tự lọc thêm các mặt hàng này.
regionalConfigs[]

object (RegionalSubscriptionOfferConfig)

Bắt buộc. Chế độ thiết lập theo khu vực cụ thể của ưu đãi này. Phải chứa ít nhất một mục nhập.
otherRegionsConfig

object (OtherRegionsSubscriptionOfferConfig)

Cấu hình này cho mọi vị trí mới mà Play có thể ra mắt trong tương lai.
offerTags[]

object (OfferTag)

Danh sách gồm tối đa 20 thẻ tuỳ chỉnh được chỉ định cho ưu đãi này và được trả lại cho ứng dụng thông qua thư viện Billing.

Tiểu bang

Trạng thái hiện tại của gói thuê bao.

Enum
STATE_UNSPECIFIED Giá trị mặc định, không bao giờ được sử dụng.
DRAFT Ưu đãi thuê bao này không áp dụng và chưa bao giờ áp dụng cho người dùng.
ACTIVE Ưu đãi thuê bao áp dụng cho cả người dùng mới và người dùng hiện tại.
INACTIVE Ưu đãi thuê bao này không dành cho người dùng mới. Người dùng hiện tại giữ lại quyền truy cập.

SubscriptionOfferPhase

Một giai đoạn của chương trình ưu đãi gói thuê bao.

Biểu diễn dưới dạng JSON 
{
  "recurrenceCount": integer,
  "duration": string,
  "regionalConfigs": [
    {
      object (RegionalSubscriptionOfferPhaseConfig)
    }
  ],
  "otherRegionsConfig": {
    object (OtherRegionsSubscriptionOfferPhaseConfig)
  }
}
Trường
recurrenceCount

integer

Bắt buộc. Số lần giai đoạn này lặp lại. Nếu giai đoạn ưu đãi này không miễn phí, mỗi lần lặp lại sẽ tính phí người dùng theo giá của giai đoạn ưu đãi này.
duration

string

Bắt buộc. Thời gian của một lần lặp lại duy nhất của giai đoạn này. Được chỉ định ở định dạng ISO 8601.
regionalConfigs[]

object (RegionalSubscriptionOfferPhaseConfig)

Bắt buộc. Cấu hình theo khu vực cụ thể của giai đoạn ưu đãi này. Danh sách này phải chứa đúng một mục nhập cho mỗi khu vực có gói thuê bao có cấu hình theo khu vực.
otherRegionsConfig

object (OtherRegionsSubscriptionOfferPhaseConfig)

Thông tin về giá cho mọi vị trí mới mà Play có thể ra mắt.

RegionalSubscriptionOfferPhaseConfig

Cấu hình cho một giai đoạn duy nhất của chương trình ưu đãi gói thuê bao trong một khu vực.

Biểu diễn dưới dạng JSON 
{
  "regionCode": string,

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

string

Bắt buộc. Bất biến. Khu vực áp dụng cấu hình này.
Trường kết hợp price_override. Cơ chế ghi đè giá trong giai đoạn này. Bắt buộc. price_override chỉ có thể là một trong những trạng thái sau đây:
price

object (Money)

Giá tuyệt đối mà người dùng trả cho giai đoạn ưu đãi này. Giá không được nhỏ hơn giá tối thiểu cho phép đối với khu vực này.
relativeDiscount

number

Tỷ lệ phần trăm giá gói cơ bản tính theo tỷ lệ trong khoảng thời gian mà người dùng trả cho giai đoạn ưu đãi này. Ví dụ: nếu giá gói cơ bản cho khu vực này là 12 USD trong khoảng thời gian 1 năm, thì mức chiết khấu 50% cho giai đoạn trong thời hạn 3 tháng sẽ tương ứng với mức giá là 1, 5 USD. Khoản chiết khấu phải được chỉ định dưới dạng phân số hoàn toàn lớn hơn 0 và hoàn toàn nhỏ hơn 1. Giá thu được sẽ được làm tròn đến đơn vị có thể tính phí gần nhất (ví dụ: xu cho USD). Chiết khấu tương đối được coi là không hợp lệ nếu giá chiết khấu nhỏ hơn giá tối thiểu cho phép tại khu vực này.
absoluteDiscount

object (Money)

Số tiền tuyệt đối trừ vào giá gói cơ bản tính theo tỷ lệ trong khoảng thời gian mà người dùng thanh toán cho giai đoạn ưu đãi này. Ví dụ: nếu giá gói cơ bản cho khu vực này là 12 USD trong khoảng thời gian 1 năm, thì mức chiết khấu tuyệt đối 1 USD cho giai đoạn có thời hạn 3 tháng sẽ tương ứng với mức giá 2 USD. Giá thu được không được nhỏ hơn giá tối thiểu cho phép đối với khu vực này.
free

object (RegionalSubscriptionOfferPhaseFreePriceOverride)

Đặt để chỉ định người dùng sẽ nhận được ưu đãi này miễn phí.

RegionalSubscriptionOfferPhaseFreePriceOverride

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

Biểu thị cấu hình ghi đè giá miễn phí cho một giai đoạn duy nhất của ưu đãi thuê bao

OtherRegionsSubscriptionOfferPhaseConfig

Cấu hình cho mọi vị trí mới mà Play có thể ra mắt trong một giai đoạn ưu đãi duy nhất.

Biểu diễn dưới dạng JSON 
{

  // Union field price_override can be only one of the following:
  "otherRegionsPrices": {
    object (OtherRegionsSubscriptionOfferPhasePrices)
  },
  "relativeDiscount": number,
  "absoluteDiscounts": {
    object (OtherRegionsSubscriptionOfferPhasePrices)
  },
  "free": {
    object (OtherRegionsSubscriptionOfferPhaseFreePriceOverride)
  }
  // End of list of possible types for union field price_override.
}
Trường
Trường kết hợp price_override. Cơ chế ghi đè giá trong giai đoạn này. Bắt buộc. price_override chỉ có thể là một trong những trạng thái sau đây:
otherRegionsPrices

object (OtherRegionsSubscriptionOfferPhasePrices)

Giá tuyệt đối mà người dùng trả cho giai đoạn ưu đãi này. Giá không được nhỏ hơn giá tối thiểu cho phép đối với mọi địa điểm mới mà Play có thể ra mắt.
relativeDiscount

number

Tỷ lệ phần trăm giá gói cơ bản tính theo tỷ lệ trong khoảng thời gian mà người dùng trả cho giai đoạn ưu đãi này. Ví dụ: nếu giá gói cơ bản cho khu vực này là 12 USD trong khoảng thời gian 1 năm, thì mức chiết khấu 50% cho giai đoạn trong thời hạn 3 tháng sẽ tương ứng với mức giá là 1, 5 USD. Khoản chiết khấu phải được chỉ định dưới dạng phân số hoàn toàn lớn hơn 0 và hoàn toàn nhỏ hơn 1. Giá thu được sẽ được làm tròn đến đơn vị có thể tính phí gần nhất (ví dụ: xu cho USD). Khoản chiết khấu tương đối được coi là không hợp lệ nếu giá chiết khấu đó nhỏ hơn giá tối thiểu được phép ở bất kỳ vị trí mới nào mà Play có thể triển khai.
absoluteDiscounts

object (OtherRegionsSubscriptionOfferPhasePrices)

Số tiền tuyệt đối trừ vào giá gói cơ bản tính theo tỷ lệ trong khoảng thời gian mà người dùng thanh toán cho giai đoạn ưu đãi này. Ví dụ: nếu giá gói cơ bản cho khu vực này là 12 USD trong khoảng thời gian 1 năm, thì mức chiết khấu tuyệt đối 1 USD cho giai đoạn có thời hạn 3 tháng sẽ tương ứng với mức giá 2 USD. Giá thu được không được nhỏ hơn giá tối thiểu cho phép đối với mọi địa điểm mới mà Play có thể ra mắt.
free

object (OtherRegionsSubscriptionOfferPhaseFreePriceOverride)

Đặt để chỉ định người dùng sẽ nhận được ưu đãi này miễn phí.

OtherRegionsSubscriptionOfferPhasePrices

Thông tin về giá cho mọi vị trí mới mà Play có thể ra mắt.

Biểu diễn dưới dạng JSON 
{
  "usdPrice": {
    object (Money)
  },
  "eurPrice": {
    object (Money)
  }
}
Trường
usdPrice

object (Money)

Bắt buộc. Giá tính theo USD để sử dụng cho mọi vị trí mới mà Play có thể ra mắt.
eurPrice

object (Money)

Bắt buộc. Giá tính theo EUR để sử dụng cho mọi vị trí mới mà Play có thể ra mắt.

OtherRegionsSubscriptionOfferPhaseFreePriceOverride

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

Biểu thị cấu hình ghi đè giá miễn phí cho mọi vị trí mới mà Play có thể triển khai cho một giai đoạn ưu đãi.

SubscriptionOfferTargeting

Xác định quy tắc mà người dùng cần đáp ứng để nhận được ưu đãi này.

Biểu diễn dưới dạng JSON 
{

  // Union field rule can be only one of the following:
  "acquisitionRule": {
    object (AcquisitionTargetingRule)
  },
  "upgradeRule": {
    object (UpgradeTargetingRule)
  }
  // End of list of possible types for union field rule.
}
Trường
Trường kết hợp rule. Hãy để trống nếu bạn muốn biết điều kiện của ưu đãi do nhà phát triển xác định. rule chỉ có thể là một trong những trạng thái sau đây:
acquisitionRule

object (AcquisitionTargetingRule)

Quy tắc nhắm mục tiêu của ưu đãi để thu nạp người dùng mới.
upgradeRule

object (UpgradeTargetingRule)

Quy tắc nhắm mục tiêu ưu đãi để nâng cấp người dùng các gói hiện tại.

AcquisitionTargetingRule

Biểu thị quy tắc nhắm mục tiêu của biểu mẫu: Người dùng chưa từng có {scope}.

Biểu diễn dưới dạng JSON 
{
  "scope": {
    object (TargetingRuleScope)
  }
}
Trường
scope

object (TargetingRuleScope)

Bắt buộc. Phạm vi gói thuê bao mà quy tắc này sẽ xem xét. Chỉ cho phép "gói thuê bao này" và "bất kỳ gói thuê bao nào trong ứng dụng".

TargetingRuleScope

Xác định phạm vi các gói thuê bao mà quy tắc nhắm mục tiêu có thể so khớp để nhắm mục tiêu các mặt hàng đến người dùng dựa trên quyền trước đây hoặc hiện tại.

Biểu diễn dưới dạng JSON 
{

  // Union field scope can be only one of the following:
  "thisSubscription": {
    object (TargetingRuleScopeThisSubscription)
  },
  "anySubscriptionInApp": {
    object (TargetingRuleScopeAnySubscriptionInApp)
  },
  "specificSubscriptionInApp": string
  // End of list of possible types for union field scope.
}
Trường

Trường kết hợp scope.

scope chỉ có thể là một trong những trạng thái sau đây:
thisSubscription

object (TargetingRuleScopeThisSubscription)

Phạm vi của quy tắc nhắm mục tiêu hiện tại là gói thuê bao mà ưu đãi này được xác định.
anySubscriptionInApp

object (TargetingRuleScopeAnySubscriptionInApp)

Phạm vi của quy tắc nhắm mục tiêu hiện tại là bất kỳ gói thuê bao nào trong ứng dụng mẹ.
specificSubscriptionInApp

string

Phạm vi của quy tắc nhắm mục tiêu hiện tại là gói thuê bao có mã nhận dạng gói thuê bao đã chỉ định. Phải là một gói thuê bao trong cùng một ứng dụng mẹ.

TargetingRuleScopeThisSubscription

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

Biểu thị phạm vi quy tắc nhắm mục tiêu tương ứng với các đăng ký mà phiếu mua hàng này được xác định.

TargetingRuleScopeAnySubscriptionInApp

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

Biểu thị phạm vi quy tắc nhắm mục tiêu tương ứng với bất kỳ gói thuê bao nào trong ứng dụng mẹ.

UpgradeTargetingRule

Biểu thị quy tắc nhắm mục tiêu của biểu mẫu: Người dùng hiện có {scope} [có kỳ thanh toán là {billing_period}].

Biểu diễn dưới dạng JSON 
{
  "oncePerUser": boolean,
  "scope": {
    object (TargetingRuleScope)
  },
  "billingPeriodDuration": string
}
Trường
oncePerUser

boolean

Ưu đãi này chỉ áp dụng một lần cho mỗi người dùng. Nếu bạn đặt chính sách này thành true, thì người dùng sẽ không bao giờ đủ điều kiện nhận ưu đãi này nữa nếu họ đã từng đăng ký ưu đãi này.
scope

object (TargetingRuleScope)

Bắt buộc. Phạm vi gói thuê bao mà quy tắc này sẽ xem xét. Chỉ cho phép "gói thuê bao này" và "gói thuê bao cụ thể trong ứng dụng".
billingPeriodDuration

string

Khoảng thời gian kỳ thanh toán cụ thể (được chỉ định theo định dạng ISO 8601) mà người dùng hiện phải đăng ký thì mới đủ điều kiện áp dụng quy tắc này. Nếu bạn không chỉ định, hệ thống sẽ so khớp những người dùng đã đăng ký một kỳ thanh toán bất kỳ.

RegionalSubscriptionOfferConfig

Cấu hình cho một gói thuê bao ở một khu vực duy nhất.

Biểu diễn dưới dạng JSON 
{
  "regionCode": string,
  "newSubscriberAvailability": boolean
}
Trường
regionCode

string

Bắt buộc. Bất biến. Mã vùng mà cấu hình này áp dụng, theo xác định trong ISO 3166-2, ví dụ: "Hoa Kỳ".
newSubscriberAvailability

boolean

Liệu ưu đãi thuê bao ở khu vực được chỉ định có áp dụng cho người đăng ký mới hay không. Người đăng ký hiện tại sẽ không bị huỷ gói thuê bao nếu bạn đặt giá trị này thành false. Nếu không được chỉ định, giá trị mặc định sẽ là false.

OtherRegionsSubscriptionOfferConfig

Cấu hình cho mọi vị trí mới mà Play có thể phát hành tại những vị trí đã chỉ định trong một ưu đãi cho gói thuê bao.

Biểu diễn dưới dạng JSON 
{
  "otherRegionsNewSubscriberAvailability": boolean
}
Trường
otherRegionsNewSubscriberAvailability

boolean

Liệu việc cung cấp gói thuê bao ở bất kỳ vị trí mới nào mà Play có thể ra mắt trong tương lai hay không. Nếu không được chỉ định, giá trị mặc định sẽ là false.

Phương thức

activate

 Kích hoạt một gói thuê bao.

batchGet

 Đọc một hoặc nhiều ưu đãi thuê bao.

batchUpdate

 Cập nhật hàng loạt ưu đãi thuê bao.

batchUpdateStates

 Cập nhật một loạt trạng thái của ưu đãi gói thuê bao.

create

 Tạo một gói thuê bao mới.

deactivate

 Huỷ kích hoạt ưu đãi cho gói thuê bao.

delete

 Xoá một gói thuê bao.

get

 Đọc một ưu đãi duy nhất

list

 Liệt kê tất cả ưu đãi của một gói thuê bao cụ thể.

patch

 Cập nhật một gói thuê bao hiện có.