REST Resource: monetization.subscriptions

{
  "packageName": string,
  "productId": string,
  "basePlans": [
    {
      object (BasePlan)
    }
  ],
  "listings": [
    {
      object (SubscriptionListing)
    }
  ],
  "archived": boolean,
  "taxAndComplianceSettings": {
    object (SubscriptionTaxAndComplianceSettings)
  }
}

string

변경할 수 없습니다. 상위 앱의 패키지 이름입니다.

string

변경할 수 없습니다. 제품의 고유 제품 ID입니다. 상위 앱 내에서 고유해야 합니다. 제품 ID는 소문자 (a~z), 숫자 (0~9), 밑줄 (_), 마침표 (.)로 구성되어야 합니다. 소문자 또는 숫자로 시작해야 하며 1~40자 (영문 기준) 사이여야 합니다.

object (BasePlan)

이 정기 결제의 기본 요금제 집합입니다. 다른 혜택이 적용되지 않는 경우 정기 결제의 가격 및 기간을 나타냅니다.

object (SubscriptionListing)

필수. 이 구독에 대한 현지화된 목록의 apks.list입니다. 상위 앱의 기본 언어에 대한 항목이 최소한 한 개 이상 포함되어야 합니다.

boolean

출력 전용. 구독의 보관처리 여부입니다. 보관처리된 구독은 더 이상 구독자에게 제공되지 않으며, 업데이트할 수 없으며, 보관처리된 항목 플래그가 전달되지 않으면 목록 요청에 반환되지 않습니다.

object (SubscriptionTaxAndComplianceSettings)

세금 및 법률 준수에 관한 세부정보.

{
  "basePlanId": string,
  "state": enum (State),
  "regionalConfigs": [
    {
      object (RegionalBasePlanConfig)
    }
  ],
  "offerTags": [
    {
      object (OfferTag)
    }
  ],
  "otherRegionsConfig": {
    object (OtherRegionsBasePlanConfig)
  },

  // Union field base_plan_type can be only one of the following:
  "autoRenewingBasePlanType": {
    object (AutoRenewingBasePlanType)
  },
  "prepaidBasePlanType": {
    object (PrepaidBasePlanType)
  }
  // End of list of possible types for union field base_plan_type.
}

string

필수 항목입니다. 변경할 수 없습니다. 이 기본 요금제의 고유 식별자입니다. 구독 내에서 고유해야 하며 RFC-1034를 준수해야 합니다. 즉, 이 ID에는 소문자(a~z), 숫자(0~9), 하이픈(-)만 포함할 수 있으며 최대 63자(영문 기준)까지 입력할 수 있습니다.

enum (State)

출력 전용. 기본 요금제의 상태(예: 활성 여부)입니다. 임시 및 비활성 기본 요금제를 활성화하거나 삭제할 수 있습니다. 활성 기본 요금제를 비활성화할 수 있습니다. 비활성 기본 요금제는 취소할 수 있습니다. 리소스를 업데이트하여 이 필드를 변경할 수 없습니다. 대신 전용 엔드포인트를 사용하세요.

object (RegionalBasePlanConfig)

이 기본 요금제의 지역별 정보입니다.

object (OfferTag)

이 기본 요금제에 지정된 최대 20개의 맞춤 태그로 구성된 apks.list이며 결제 라이브러리를 통해 앱에 반환됩니다. 이 기본 요금제의 정기 결제 혜택도 결제 라이브러리에서 이러한 혜택 태그를 받게 됩니다.

object (OtherRegionsBasePlanConfig)

향후 Play에서 출시할 새로운 지역에 대한 가격 책정 정보입니다. 생략하면 향후 Play에서 실행할 수 있는 모든 새로운 위치에서 BasePlan을 자동으로 사용할 수 없게 됩니다.

object (AutoRenewingBasePlanType)

기본 요금제가 일정한 간격으로 자동 갱신되는 시기를 설정합니다.

object (PrepaidBasePlanType)

결제 기간이 끝날 때 기본 요금제가 자동으로 갱신되지 않는 시기를 설정합니다.

{
  "billingPeriodDuration": string,
  "gracePeriodDuration": string,
  "resubscribeState": enum (ResubscribeState),
  "prorationMode": enum (SubscriptionProrationMode),
  "legacyCompatible": boolean,
  "legacyCompatibleSubscriptionOfferId": string
}

string

필수 항목입니다. ISO 8601 형식으로 지정된 구독 기간입니다. 사용 가능한 결제 기간 목록은 고객센터를 참고하세요.

string

ISO 8601 형식으로 지정된 구독의 유예 기간입니다. 사용 가능한 값은 P0D (0일), P3D (3일), P7D (7일), P14D (14일), P30D (30일)입니다. 지정하지 않으면 반복되는 기간을 기준으로 기본값이 사용됩니다.

enum (ResubscribeState)

사용자가 Google Play 표시 경로에서 이 기본 요금제를 재구독할 수 있는지 여부 지정하지 않을 경우 기본값은 RESUBSCRIBE_STATE_ACTIVE입니다.

enum (SubscriptionProrationMode)

기본 요금제의 비례 배분 모드는 사용자가 다른 기본 요금제에서 이 요금제로 전환할 때 발생하는 상황을 결정합니다. 지정하지 않으면 기본값은 CHARGE_ON_NEXT_BILLING_DATE입니다.

boolean

갱신 기본 요금제가 이전 버전과 호환되는지 여부입니다.

이전 버전과 호환되는 기본 요금제는 Google Play 결제 라이브러리의 지원 중단된 querySkuDetailsAsync() 메서드로 반환됩니다.

지정된 정기 결제와 관련하여 하나의 갱신 요금제만 기존 버전과 호환 가능한 것으로 표시할 수 있습니다.

string

기존 버전과 호환되는 정기 결제 혜택 ID입니다.

이전 버전과 호환되는 정기 결제 혜택은 Google Play 결제 라이브러리의 지원 중단된 querySkuDetailsAsync() 메서드로 반환됩니다.

지정된 갱신 기본 요금제에 대해 하나의 정기 결제 혜택만 기존과 호환되는 것으로 표시할 수 있습니다.

구독 혜택을 기존 버전과 호환되도록 하려면 이 필드를 빈 문자열로 설정하세요.

{
  "billingPeriodDuration": string,
  "timeExtension": enum (TimeExtension)
}

string

필수 항목입니다. ISO 8601 형식으로 지정된 구독 기간입니다. 사용 가능한 결제 기간 목록은 고객센터를 참고하세요.

enum (TimeExtension)

사용자가 Google Play 표시 경로에서 이 선불 기본 요금제를 연장할 수 있는지 여부입니다. 지정하지 않을 경우 기본값은 TIME_EXTENSION_ACTIVE입니다.

{
  "regionCode": string,
  "newSubscriberAvailability": boolean,
  "price": {
    object (Money)
  }
}

string

필수 항목입니다. 이 구성이 적용되는 지역 코드입니다(ISO 3166-2에 정의되어 있음). 예: "US

boolean

새 정기 결제 사용자에게 지정된 리전의 기본 요금제를 제공할 수 있는지 나타냅니다. 이 값이 false로 설정된 경우 기존 정기 결제는 취소되지 않습니다. 지정하지 않으면 기본값은 false입니다.

object (Money)

지정된 지역의 기본 요금제 가격입니다. 신규 정기 결제 사용자가 기본 요금제를 사용할 수 있는 경우 설정해야 합니다. 지정된 지역에 연결된 통화로 설정해야 합니다.

{
  "usdPrice": {
    object (Money)
  },
  "eurPrice": {
    object (Money)
  },
  "newSubscriberAvailability": boolean
}

object (Money)

필수 항목입니다. Play가 출시될 수 있는 모든 신규 지역에 사용할 수 있는 USD 기준 가격입니다.

object (Money)

필수 항목입니다. Play가 출시되는 모든 지역에서 사용할 수 있는 유로 가격입니다.

boolean

Play가 출시되는 모든 지역의 신규 정기 결제 사용자에게 기본 요금제가 제공되는지 여부 지정하지 않으면 기본값은 false입니다.

{
  "languageCode": string,
  "title": string,
  "benefits": [
    string
  ],
  "description": string
}

string

필수 항목입니다. BCP-47에서 정의한 이 등록정보의 언어입니다(예: "en-US").

string

필수 항목입니다. 등록정보의 언어로 된 구독 제목입니다. 일반 텍스트

string

Play 스토어와 같은 플랫폼과 이 등록정보의 언어로 복원된 흐름에서 사용자에게 표시되는 혜택 목록입니다. 일반 텍스트 최대 4가지 혜택이 순서대로 나열되어 있습니다.

string

비즈니스 정보의 언어로 된 구독 설명입니다. 최대 길이는 80자(영문 기준)입니다. 일반 텍스트