- 리소스: 구독
- BasePlan
- 상태
- AutoRenewingBasePlanType
- ResubscribeState
- SubscriptionProrationMode
- PrepaidBasePlanType
- TimeExtension
- InstallmentsBasePlanType
- RenewalType
- RegionalBasePlanConfig
- OtherRegionsBasePlanConfig
- SubscriptionListing
- RestrictedPaymentCountries
- 메서드
리소스: 구독
앱의 단일 구독입니다.
JSON 표현 |
---|
{ "packageName": string, "productId": string, "basePlans": [ { object ( |
입력란 | |
---|---|
packageName |
변경할 수 없습니다. 상위 앱의 패키지 이름입니다. |
productId |
변경할 수 없습니다. 제품의 고유 제품 ID입니다. 상위 앱 내에서 고유합니다. 제품 ID는 소문자(a~z), 숫자(0~9), 밑줄(_), 점(.)으로 구성되어야 합니다. 소문자 또는 숫자로 시작해야 하며 1~40자여야 합니다. |
basePlans[] |
이 정기 결제의 기본 요금제 집합입니다. 다른 혜택이 적용되지 않는 경우 구독의 가격과 기간을 나타냅니다. |
listings[] |
필수 항목입니다. 이 정기 결제의 현지화된 등록정보 목록입니다. 최소한 상위 앱의 기본 언어에 대한 항목을 포함해야 합니다. |
archived |
출력 전용입니다. 지원 중단됨: 구독 보관처리는 지원되지 않습니다. |
taxAndComplianceSettings |
세금 및 법률 준수에 관한 세부정보입니다. |
restrictedPaymentCountries |
선택사항입니다. 동일한 국가에 등록된 결제 수단으로 정기 결제 상품을 구매할 수 있는 국가입니다. 비어 있으면 결제 위치 제한이 적용되지 않습니다. |
BasePlan
정기 결제의 단일 기본 요금제입니다.
JSON 표현 |
---|
{ "basePlanId": string, "state": enum ( |
입력란 | |
---|---|
basePlanId |
필수 항목입니다. 변경할 수 없습니다. 이 기본 요금제의 고유 식별자입니다. 구독 내에서 고유해야 하며 RFC-1034를 준수해야 합니다. 즉, 이 ID에는 소문자(a~z), 숫자(0~9), 하이픈(-)만 포함할 수 있으며 63자(영문 기준) 이하여야 합니다. |
state |
출력 전용입니다. 기본 요금제의 상태(예: 활성 상태인지 여부)입니다. 초안 및 비활성 기본 요금제는 활성화하거나 삭제할 수 있습니다. 활성 기본 요금제는 비활성화할 수 있습니다. 비활성 기본 요금제는 취소할 수 있습니다. 이 필드는 리소스를 업데이트하여 변경할 수 없습니다. 대신 전용 엔드포인트를 사용하세요. |
regionalConfigs[] |
이 기본 요금제의 지역별 정보입니다. |
offerTags[] |
이 기본 요금제에 지정된 최대 20개의 맞춤 태그 목록으로, 결제 라이브러리를 통해 앱으로 반환됩니다. 이 기본 요금제의 정기 결제 혜택도 결제 라이브러리에 이러한 혜택 태그를 수신합니다. |
otherRegionsConfig |
향후 Play가 출시될 새로운 지역의 가격 정보 생략할 경우 향후 Play에서 새로운 지역을 출시할 경우 BasePlan이 자동으로 제공되지 않습니다. |
통합 필드 base_plan_type . 이 기본 요금제의 유형입니다. 정확히 1개를 설정해야 합니다. base_plan_type 은 다음 중 하나여야 합니다. |
|
autoRenewingBasePlanType |
기본 요금제가 정기적으로 자동 갱신되는 시점을 설정합니다. |
prepaidBasePlanType |
결제 기간이 끝날 때 기본 요금제가 자동으로 갱신되지 않을 때 설정합니다. |
installmentsBasePlanType |
사용자가 지정된 횟수만큼 결제를 약정하는 할부 기본 요금제에 설정됩니다. |
상태
기본 요금제의 현재 상태입니다.
열거형 | |
---|---|
STATE_UNSPECIFIED |
지정되지 않은 상태. |
DRAFT |
기본 요금제는 현재 초안 상태이며 활성화되지 않았습니다. 이 시점에서 안전하게 삭제할 수 있습니다. |
ACTIVE |
기본 요금제가 활성 상태이며 신규 정기 결제 사용자에게 제공됩니다. |
INACTIVE |
기본 요금제는 비활성 상태이며 기존 정기 결제 사용자만 사용할 수 있습니다. |
AutoRenewingBasePlanType
구독 기간이 끝날 때 자동으로 갱신되는 기본 요금제를 나타냅니다.
JSON 표현 |
---|
{ "billingPeriodDuration": string, "gracePeriodDuration": string, "accountHoldDuration": string, "resubscribeState": enum ( |
입력란 | |
---|---|
billingPeriodDuration |
필수 항목입니다. ISO 8601 형식으로 지정된 구독 기간입니다. 사용 가능한 결제 기간 목록은 고객센터를 참고하세요. |
gracePeriodDuration |
ISO 8601 형식으로 지정된 구독 유예 기간입니다. 허용되는 값은 P0D (제로데이), P3D (3일), P7D (7일), P14D (14일), P30D (30일)입니다. 지정하지 않으면 반복 기간을 기준으로 기본값이 사용됩니다. |
accountHoldDuration |
선택사항입니다. ISO 8601 형식으로 지정된 정기 결제의 계정 보류 기간입니다. 허용되는 값은 DAYS이고, 범위는 P0D (0일)에서 P30D (30일) 사이여야 합니다. 지정되지 않은 경우 기본값은 P30D (30일)입니다. |
resubscribeState |
사용자가 Google Play 표시 경로에서 이 기본 요금제를 다시 정기 결제할 수 있는지 여부입니다. 지정하지 않을 경우 기본값은 RESUBSCRIPTION_STATE_ACTIVE입니다. |
prorationMode |
기본 요금제의 비례 배분 모드에 따라 사용자가 다른 기본 요금제에서 이 요금제로 전환할 때 발생하는 결과가 결정됩니다. 지정하지 않을 경우 기본값은 CHARGE_ON_NEXT_BILLING_DATE입니다. |
legacyCompatible |
갱신하는 기본 요금제가 이전 버전과 호환되는지 여부입니다. 이전 버전과 호환되는 기본 요금제는 Google Play 결제 라이브러리의 지원 중단된 메서드 querySkuDetailsAsync()에서 반환됩니다. 갱신되는 기본 요금제 하나만 특정 정기 결제와 기존 버전과 호환 가능한 것으로 표시할 수 있습니다. |
legacyCompatibleSubscriptionOfferId |
기존 버전과 호환되는 정기 결제 혜택 ID입니다. 이전 버전과 호환되는 정기 결제 혜택은 Google Play 결제 라이브러리의 지원 중단된 메서드 querySkuDetailsAsync()에서 반환됩니다. 갱신되는 기본 요금제에서는 하나의 정기 결제 혜택만 기존 버전과 호환 가능한 것으로 표시할 수 있습니다. 기존 버전과 호환 가능한 정기 결제 혜택이 없으면 이 필드를 빈 문자열로 설정하세요. |
ResubscribeState
기본 요금제 정기 결제 재신청 상태입니다.
열거형 | |
---|---|
RESUBSCRIBE_STATE_UNSPECIFIED |
지정되지 않은 상태. |
RESUBSCRIBE_STATE_ACTIVE |
정기 결제 재신청이 활성화되었습니다. |
RESUBSCRIBE_STATE_INACTIVE |
정기 결제 재신청이 비활성 상태입니다. |
SubscriptionProrationMode
기본 요금제 갱신에 사용되는 비례 배분 모드입니다.
열거형 | |
---|---|
SUBSCRIPTION_PRORATION_MODE_UNSPECIFIED |
지정되지 않은 모드입니다. |
SUBSCRIPTION_PRORATION_MODE_CHARGE_ON_NEXT_BILLING_DATE |
현재 결제 기간이 끝나면 새 기본 요금제의 요금이 사용자에게 청구됩니다. |
SUBSCRIPTION_PRORATION_MODE_CHARGE_FULL_PRICE_IMMEDIATELY |
사용자에게 새로운 기본 요금제의 요금이 즉시 전액 청구됩니다. 기존 구독에서 남은 기간이 새 요금제 기간을 연장하는 데 사용됩니다. |
PrepaidBasePlanType
기본 요금제 종료 시 자동으로 갱신되지 않으며 사용자가 수동으로 갱신해야 하는 기본 요금제를 나타냅니다.
JSON 표현 |
---|
{
"billingPeriodDuration": string,
"timeExtension": enum ( |
입력란 | |
---|---|
billingPeriodDuration |
필수 항목입니다. ISO 8601 형식으로 지정된 구독 기간입니다. 사용 가능한 결제 기간 목록은 고객센터를 참고하세요. |
timeExtension |
사용자가 Google Play 표시 경로에서 이 선불 기본 요금제를 연장할 수 있는지 여부입니다. 지정하지 않을 경우 기본값은 TIME_EXTENSION_ACTIVE입니다. |
TimeExtension
기본 요금제의 기간을 연장합니다.
열거형 | |
---|---|
TIME_EXTENSION_UNSPECIFIED |
지정되지 않은 상태. |
TIME_EXTENSION_ACTIVE |
시간 광고 확장이 활성 상태입니다. 사용자는 선불 요금제를 충전하거나 연장할 수 있습니다. |
TIME_EXTENSION_INACTIVE |
시간 광고 확장이 비활성화되었습니다. 사용자는 선불 요금제를 충전하거나 연장할 수 없습니다. |
InstallmentsBasePlanType
사용자가 지정된 횟수만큼 결제를 약정하는 할부 기본 요금제를 나타냅니다.
JSON 표현 |
---|
{ "billingPeriodDuration": string, "committedPaymentsCount": integer, "renewalType": enum ( |
입력란 | |
---|---|
billingPeriodDuration |
필수 항목입니다. ISO 8601 형식으로 지정된 구독 기간입니다. 사용 가능한 결제 기간 목록은 고객센터를 참고하세요. |
committedPaymentsCount |
필수 항목입니다. 사용자가 약정한 결제 횟수입니다. |
renewalType |
필수 항목입니다. 할부 기본 요금제 갱신 유형입니다. 초기 약정 종료 시 동작을 결정합니다. |
gracePeriodDuration |
ISO 8601 형식으로 지정된 구독 유예 기간입니다. 허용되는 값은 P0D (제로데이), P3D (3일), P7D (7일), P14D (14일), P30D (30일)입니다. 지정하지 않으면 반복 기간을 기준으로 기본값이 사용됩니다. |
accountHoldDuration |
선택사항입니다. 구독의 계정 보류 기간으로, 일 단위 및 ISO 8601 형식으로만 지정됩니다. 허용되는 값은 P0D (제로데이)~P30D (30일)입니다. 지정되지 않은 경우 기본값은 P30D (30일)입니다. |
resubscribeState |
사용자가 Google Play 표시 경로에서 이 기본 요금제를 다시 정기 결제할 수 있는지 여부입니다. 지정하지 않을 경우 기본값은 RESUBSCRIPTION_STATE_ACTIVE입니다. |
prorationMode |
기본 요금제의 비례 배분 모드에 따라 사용자가 다른 기본 요금제에서 이 요금제로 전환할 때 발생하는 결과가 결정됩니다. 지정하지 않을 경우 기본값은 CHARGE_ON_NEXT_BILLING_DATE입니다. |
RenewalType
할부 기본 요금제 갱신 유형입니다. 초기 약정 종료 시 동작을 결정합니다.
열거형 | |
---|---|
RENEWAL_TYPE_UNSPECIFIED |
지정되지 않은 상태. |
RENEWAL_TYPE_RENEWS_WITHOUT_COMMITMENT |
약정 없이 결제 기간 동안 정기적으로 갱신됩니다. |
RENEWAL_TYPE_RENEWS_WITH_COMMITMENT |
처음 구독과 동일한 기간의 약정으로 갱신됩니다. |
RegionalBasePlanConfig
지역에 맞는 기본 요금제의 구성입니다.
JSON 표현 |
---|
{
"regionCode": string,
"newSubscriberAvailability": boolean,
"price": {
object ( |
입력란 | |
---|---|
regionCode |
필수 항목입니다. ISO 3166-2에 정의된 대로 이 설정이 적용되는 지역 코드입니다(예: 'US'). |
newSubscriberAvailability |
지정된 지역의 기본 요금제가 신규 정기 결제 사용자에게 제공되는지 여부입니다. 이 값이 false로 설정되면 기존 정기 결제 사용자의 정기 결제는 취소되지 않습니다. 지정하지 않으면 기본값은 false입니다. |
price |
지정된 리전의 기본 요금제 가격입니다. 신규 정기 결제 사용자가 기본 요금제를 사용할 수 있는 경우 설정해야 합니다. 지정된 지역에 연결된 통화로 설정해야 합니다. |
OtherRegionsBasePlanConfig
Play가 출시될 새로운 지역의 가격 정보입니다.
JSON 표현 |
---|
{ "usdPrice": { object ( |
입력란 | |
---|---|
usdPrice |
필수 항목입니다. Play가 출시될 새로운 지역에 사용할 수 있는 가격(USD)입니다. |
eurPrice |
필수 항목입니다. Play가 출시될 새로운 지역에 적용되는 가격은 유로(EUR)입니다. |
newSubscriberAvailability |
Play가 출시될 수 있는 새로운 지역의 신규 정기 결제 사용자에게 기본 요금제가 제공되는지 여부 지정하지 않으면 기본값은 false입니다. |
SubscriptionListing
소비자에게 표시되는 정기 결제 메타데이터입니다.
JSON 표현 |
---|
{ "languageCode": string, "title": string, "benefits": [ string ], "description": string } |
입력란 | |
---|---|
languageCode |
필수 항목입니다. BCP-47에 정의된 이 등록정보의 언어입니다(예: 'en-US'). |
title |
필수 항목입니다. 등록정보의 언어로 된 구독 제목입니다. 일반 텍스트 |
benefits[] |
Play 스토어와 같은 플랫폼 및 이 등록정보의 언어로 된 복원 절차에서 사용자에게 표시되는 혜택 목록입니다. 일반 텍스트 최대 4개 혜택이 포함된 순서가 지정된 목록입니다. |
description |
등록정보의 언어로 된 구독 설명입니다. 최대 길이는 80자(영문 기준)입니다. 일반 텍스트 |
RestrictedPaymentCountries
이 제품의 구매가 동일한 국가에 등록된 결제 수단으로 제한되는 국가입니다. 비어 있으면 결제 위치 제한이 적용되지 않습니다.
JSON 표현 |
---|
{ "regionCodes": [ string ] } |
입력란 | |
---|---|
regionCodes[] |
필수 항목입니다. ISO 3166-2에 정의된 대로 결제 제한을 적용하는 지역 코드입니다(예: 'US'). |
메서드 |
|
---|---|
(deprecated) |
지원 중단됨: 구독 보관처리는 지원되지 않습니다. |
|
하나 이상의 구독을 읽습니다. |
|
구독 배치를 업데이트합니다. |
|
새 구독을 만듭니다. |
|
구독을 삭제합니다. |
|
단일 구독을 읽습니다. |
|
지정된 앱의 모든 구독을 나열합니다. |
|
기존 구독을 업데이트합니다. |