- 리소스: SubscriptionOffer
- 상태
- SubscriptionOfferPhase
- RegionalSubscriptionOfferPhaseConfig
- OtherRegionSubscriptionOfferPhaseConfig
- 기타 지역 구독 혜택 단계 가격
- SubscriptionOffer타겟팅
- 획득타겟팅 규칙
- 타겟팅 규칙 범위
- UpgradetargetingRule
- RegionalSubscriptionOfferConfig
- OtherRegionSubscriptionOfferConfig
- 메서드
리소스: SubscriptionOffer
단일 임시 혜택
JSON 표현 |
---|
{ "packageName": string, "productId": string, "basePlanId": string, "offerId": string, "state": enum ( |
필드 | |
---|---|
packageName |
필수 항목입니다. 변경할 수 없습니다. 상위 정기 결제가 속한 앱의 패키지 이름입니다. |
productId |
필수 항목입니다. 변경할 수 없습니다. 이 오퍼가 속한 상위 구독의 ID입니다. |
basePlanId |
필수 항목입니다. 변경할 수 없습니다. 이 혜택이 확장 프로그램인 기본 요금제의 ID입니다. |
offerId |
필수 항목입니다. 변경할 수 없습니다. 이 구독 혜택의 고유 ID입니다. 기본 요금제 내에서 고유해야 합니다. |
state |
출력 전용. 이 오퍼의 현재 상태입니다. 활성화 및 비활성화 작업을 사용하여 변경할 수 있습니다. NB: 기본 요금제 상태가 이 상태를 대체하므로 기본 요금제가 활성화되지 않은 경우 활성 혜택을 사용하지 못할 수 있습니다. |
phases[] |
필수 항목입니다. 이 구독 혜택의 단계입니다. 항목을 1개 이상 포함해야 하며 최대 5개를 포함할 수 있습니다. 사용자는 항상 지정된 순서대로 모든 단계를 받게 됩니다. 초기 생성 후 단계는 추가, 삭제 또는 재정렬할 수 없습니다. |
targeting |
이 혜택을 이용하려면 사용자가 충족해야 하는 요구사항입니다. 혜택의 반환 여부를 판단하기 위해 Play에서 평가하는 요구사항을 나타냅니다. 개발자는 이러한 오퍼를 추가로 필터링할 수 있습니다. |
regionalConfigs[] |
필수 항목입니다. 이 오퍼의 지역별 구성입니다. 항목을 1개 이상 포함해야 합니다. |
otherRegionsConfig |
향후 Play에서 출시할 수 있는 모든 새 위치의 구성입니다. |
offerTags[] |
이 오퍼에 지정된 최대 20개의 맞춤 태그 목록이며 결제 라이브러리를 통해 앱에 반환됩니다. |
상태
정기 결제 혜택의 현재 상태입니다.
열거형 | |
---|---|
STATE_UNSPECIFIED |
기본값이며 사용해서는 안 됩니다. |
DRAFT |
정기 결제 혜택이 아직 제공되지 않으며 사용자에게 제공되는 적이 없습니다. |
ACTIVE |
정기 결제 혜택은 신규 및 기존 사용자에게 제공됩니다. |
INACTIVE |
신규 사용자는 정기 결제 혜택을 이용할 수 없습니다. 기존 사용자는 액세스 권한을 유지합니다. |
구독 혜택 단계
정기 결제 혜택의 단일 단계입니다.
JSON 표현 |
---|
{ "recurrenceCount": integer, "duration": string, "regionalConfigs": [ { object ( |
필드 | |
---|---|
recurrenceCount |
필수 항목입니다. 이 단계가 반복되는 횟수입니다. 이 혜택 단계가 무료가 아닌 경우 각 갱신마다 사용자에게 이 혜택 단계의 가격이 청구됩니다. |
duration |
필수 항목입니다. 이 단계의 단일 반복 시간입니다. ISO 8601 형식으로 지정됩니다. |
regionalConfigs[] |
필수 항목입니다. 이 오퍼 단계의 지역별 구성입니다. 이 목록에는 정기 결제 제공 항목에 지역 구성이 있는 각 지역에 해당하는 항목이 하나씩 있어야 합니다. |
otherRegionsConfig |
Play가 출시되는 모든 지역의 가격 정보 |
리전 구독 혜택 단계 구성
단일 지역의 정기 결제 혜택의 단일 단계 구성입니다.
JSON 표현 |
---|
{ "regionCode": string, // Union field |
필드 | |
---|---|
regionCode |
필수 항목입니다. 변경할 수 없습니다. 이 구성이 적용되는 리전입니다. |
통합 필드 price_override 는 이 단계의 가격 재정의입니다. 필수 항목입니다. price_override 은 다음 중 하나여야 합니다. |
|
price |
이 오퍼 단계에서 사용자가 지불하는 절대 가격입니다. 가격은 이 지역에 허용되는 최저 가격 이상이어야 합니다. |
relativeDiscount |
사용자가 이 혜택 단계에 지불하는 단계 기간 동안 일할 계산된 기본 요금제 가격의 비율입니다. 예를 들어 이 지역의 기본 요금제 가격이 1년 동안 12달러인 경우 3개월 동안 50% 할인이 1.50달러가 됩니다. 할인율은 0보다 크고 1보다 작은 분수로 지정해야 합니다. 최종 가격은 가장 가까운 청구 가능 단위 (예: USD의 경우 센트)로 반올림됩니다. 할인 가격이 이 지역에서 허용되는 최소 가격보다 낮아지면 상대적 할인은 유효하지 않은 것으로 간주됩니다. |
absoluteDiscount |
사용자가 이 혜택 단계에 지불하는 단계 기간 동안 일할 계산되어 기본 요금제 가격에서 차감된 절대 금액입니다. 예를 들어 이 지역의 기본 요금제 가격이 1년 동안 $12라면 3개월 동안 $1의 절대 할인은 $2에 해당합니다. 최종 가격은 이 지역에서 허용되는 최소 가격보다 작을 수 없습니다. |
free |
이 혜택을 무료로 설정하려면 설정하세요. |
기타 지역 구독 혜택 단계 구성
단일 혜택 단계에서 Play가 출시되는 모든 신규 위치의 구성입니다.
JSON 표현 |
---|
{ // Union field |
필드 | |
---|---|
통합 필드 price_override 는 이 단계의 가격 재정의입니다. 필수 항목입니다. price_override 은 다음 중 하나여야 합니다. |
|
otherRegionsPrices |
이 오퍼 단계에서 사용자가 지불하는 절대 가격입니다. 가격은 Play에서 출시할 수 있는 모든 신규 위치에 허용되는 최소 가격보다 작을 수 없습니다. |
relativeDiscount |
사용자가 이 혜택 단계에 지불하는 단계 기간 동안 일할 계산된 기본 요금제 가격의 비율입니다. 예를 들어 이 지역의 기본 요금제 가격이 1년 동안 12달러인 경우 3개월 동안 50% 할인이 1.50달러가 됩니다. 할인율은 0보다 크고 1보다 작은 분수로 지정해야 합니다. 최종 가격은 가장 가까운 청구 가능 단위 (예: USD의 경우 센트)로 반올림됩니다. 할인이 Play가 출시되는 모든 지역에서 허용되는 최소 가격보다 낮은 경우 상대적 할인이 잘못된 것으로 간주됩니다. |
absoluteDiscounts |
사용자가 이 혜택 단계에 지불하는 단계 기간 동안 일할 계산되어 기본 요금제 가격에서 차감된 절대 금액입니다. 예를 들어 이 지역의 기본 요금제 가격이 1년 동안 $12라면 3개월 동안 $1의 절대 할인은 $2에 해당합니다. 최종 가격은 Play가 출시되는 모든 지역에서 허용되는 최소 가격보다 작을 수 없습니다. |
free |
이 혜택을 무료로 설정하려면 설정하세요. |
기타 지역 정기 결제 혜택 단계 가격
Play가 출시되는 모든 지역의 가격 정보
JSON 표현 |
---|
{ "usdPrice": { object ( |
필드 | |
---|---|
usdPrice |
필수 항목입니다. Play가 출시되는 모든 지역에 사용할 수 있는 가격(USD) |
eurPrice |
필수 항목입니다. Play가 출시되는 모든 지역에 사용할 수 있는 유로 가격입니다. |
구독 오퍼 타겟팅
이 오퍼를 수신하기 위해 사용자가 충족해야 하는 규칙을 정의합니다.
JSON 표현 |
---|
{ // Union field |
필드 | |
---|---|
통합 필드
|
|
acquisitionRule |
신규 사용자 획득을 위한 오퍼 타겟팅 규칙입니다. |
upgradeRule |
사용자의 기존 요금제를 업그레이드하기 위한 오퍼 타겟팅 규칙입니다. |
획득 타겟팅 규칙
사용자가 이전에 {scope}를 보유한 적이 없는 타겟팅 규칙을 나타냅니다.
JSON 표현 |
---|
{
"scope": {
object ( |
필드 | |
---|---|
scope |
필수 항목입니다. 이 규칙에서 고려하는 구독의 범위입니다. '이 정기 결제' 및 '앱에서 정기 결제'만 허용합니다. |
타겟팅 규칙 범위
이전 또는 현재 사용 권한을 기준으로 사용자에게 혜택을 타겟팅하기 위해 타겟팅 규칙과 일치시킬 수 있는 정기 결제의 범위를 정의합니다.
JSON 표현 |
---|
{ // Union field |
필드 | |
---|---|
통합 필드
|
|
thisSubscription |
현재 타겟팅 규칙의 범위는 이 제품이 정의된 정기 결제입니다. |
anySubscriptionInApp |
현재 타겟팅 규칙의 범위는 상위 앱에 있는 모든 구독입니다. |
specificSubscriptionInApp |
현재 타겟팅 규칙의 범위는 지정된 구독 ID가 있는 구독입니다. 동일한 상위 앱 내의 구독이어야 합니다. |
업그레이드 타겟팅 규칙
다음과 같은 형식의 타겟팅 규칙을 나타냅니다. 사용자: 현재 {scope}이(가) 있습니다[결제 기간 {billing_period}].
JSON 표현 |
---|
{
"oncePerUser": boolean,
"scope": {
object ( |
필드 | |
---|---|
oncePerUser |
이 혜택은 사용자당 한 번만 제공됩니다. true로 설정하면 사용자가 이 혜택을 구독한 적이 있으면 다시 이 혜택을 사용할 수 없습니다. |
scope |
필수 항목입니다. 이 규칙에서 고려하는 구독의 범위입니다. '이 정기 결제' 및 '앱 내 특정 정기 결제'만 허용합니다. |
billingPeriodDuration |
이 규칙을 사용하려면 사용자가 현재 구독해야 하는 ISO 8601 형식의 특정 결제 기간입니다. 지정하지 않으면 결제 기간을 구독한 사용자가 일치합니다. |
지역별 구독 혜택 구성
단일 리전의 정기 결제 혜택 구성
JSON 표현 |
---|
{ "regionCode": string, "newSubscriberAvailability": boolean } |
필드 | |
---|---|
regionCode |
필수 항목입니다. 변경할 수 없습니다. ISO 3166-2에 정의된 대로 이 구성이 적용되는 지역 코드입니다(예: 'US'). |
newSubscriberAvailability |
지정된 지역의 정기 결제 혜택이 신규 정기 결제 사용자에게 제공되는지 여부입니다. 이 값을 false로 설정하면 기존 정기 결제가 취소되지 않습니다. 지정하지 않으면 기본값은 false입니다. |
기타 지역 구독 혜택 구성
Play에서 정기 결제 혜택에 지정된 모든 지역의 새로운 위치에 대한 구성입니다.
JSON 표현 |
---|
{ "otherRegionsNewSubscriberAvailability": boolean } |
필드 | |
---|---|
otherRegionsNewSubscriberAvailability |
향후 새로운 지역에서 정기 결제 혜택을 제공할지 여부입니다. 지정하지 않으면 기본값은 false입니다. |
방법 |
|
---|---|
|
구독 혜택을 활성화합니다. |
|
새 정기 결제 혜택을 만듭니다. |
|
구독 혜택을 비활성화합니다. |
|
정기 결제 혜택을 삭제합니다. |
|
단일 혜택을 읽습니다. |
|
지정된 구독의 모든 혜택을 나열합니다. |
|
기존 정기 결제 혜택을 업데이트합니다. |