REST Resource: purchases.subscriptionsv2

{
  "kind": string,
  "regionCode": string,
  "lineItems": [
    {
      object (SubscriptionPurchaseLineItem)
    }
  ],
  "startTime": string,
  "subscriptionState": enum (SubscriptionState),
  "latestOrderId": string,
  "linkedPurchaseToken": string,
  "pausedStateContext": {
    object (PausedStateContext)
  },
  "canceledStateContext": {
    object (CanceledStateContext)
  },
  "testPurchase": {
    object (TestPurchase)
  },
  "acknowledgementState": enum (AcknowledgementState),
  "externalAccountIdentifiers": {
    object (ExternalAccountIdentifiers)
  },
  "subscribeWithGoogleInfo": {
    object (SubscribeWithGoogleInfo)
  }
}

string

이 종류는 androidpublisher 서비스의 SubscriptionPurchaseV2 객체를 나타냅니다.

string

구독이 부여된 시점의 사용자의 ISO 3166-1 alpha-2 청구서 수신 국가/지역 코드입니다.

object (SubscriptionPurchaseLineItem)

정기 결제 구매의 상품 수준 정보입니다. 동일한 구매에 포함된 상품은 모두 AutoRenewingPlan을 사용하거나 모두 PrepaidPlan을 사용해야 합니다.

string (Timestamp format)

구독이 부여된 시간입니다. 대기 중인 구독에 설정되지 않았습니다. 구독이 생성되었지만 가입 중에 결제가 대기 중입니다.

RFC3339 UTC 'Zulu' 형식의 타임스탬프입니다(나노초 단위, 소수점 이하 9자리). 예를 들면 "2014-10-02T15:01:23Z" 및 "2014-10-02T15:01:23.045123456Z"입니다.

enum (SubscriptionState)

구독의 현재 상태입니다.

string

정기 결제 구매와 연결된 최신 주문의 주문 ID입니다. 자동 갱신 구독의 경우 아직 갱신되지 않은 경우 가입 주문의 주문 ID이거나 마지막 반복 주문 ID (성공, 대기 중 또는 거부된 주문)입니다. 선불 구독의 경우 쿼리된 구매 토큰과 연결된 주문 ID입니다.

string

이 정기 결제가 다음 중 하나인 경우 이전 정기 결제의 구매 토큰입니다. * 취소되었지만 만료되지 않은 정기 결제 재가입 * 이전 정기 결제에서 업그레이드/다운그레이드합니다. * 선불 요금제에서 자동 갱신되는 정기 결제로 전환합니다. * 자동 갱신 정기 결제에서 선불로 전환합니다. * 선불 정기 결제를 충전합니다.

object (PausedStateContext)

일시중지된 정기 결제에 관한 추가 컨텍스트입니다. 구독에 현재 subscriptionState SUBSCRIPTION_STATE_PAUSED가 있는 경우에만 표시됩니다.

object (CanceledStateContext)

취소된 정기 결제에 관한 추가 컨텍스트입니다. 구독에 현재 subscriptionState SUBSCRIPTION_STATE_CANCELED가 있는 경우에만 표시됩니다.

object (TestPurchase)

이 정기 결제 구매가 테스트 구매인 경우에만 표시됩니다.

enum (AcknowledgementState)

구독의 확인 상태입니다.

object (ExternalAccountIdentifiers)

서드 파티 서비스의 사용자 계정 식별자입니다.

object (SubscribeWithGoogleInfo)

'Google을 통한 구독'으로 이루어진 구매와 연결된 사용자 프로필입니다.

{
  "autoResumeTime": string
}

string (Timestamp format)

정기 결제가 자동으로 재개되는 시간입니다.

RFC3339 UTC 'Zulu' 형식의 타임스탬프입니다(나노초 단위, 소수점 이하 9자리). 예를 들면 "2014-10-02T15:01:23Z" 및 "2014-10-02T15:01:23.045123456Z"입니다.

{

  // Union field cancellation_reason can be only one of the following:
  "userInitiatedCancellation": {
    object (UserInitiatedCancellation)
  },
  "systemInitiatedCancellation": {
    object (SystemInitiatedCancellation)
  },
  "developerInitiatedCancellation": {
    object (DeveloperInitiatedCancellation)
  },
  "replacementCancellation": {
    object (ReplacementCancellation)
  }
  // End of list of possible types for union field cancellation_reason.
}

object (UserInitiatedCancellation)

사용자가 구독을 취소했습니다.

object (SystemInitiatedCancellation)

결제 문제 등으로 인해 시스템에서 구독이 취소되었습니다.

object (DeveloperInitiatedCancellation)

개발자가 구독을 취소했습니다.

object (ReplacementCancellation)

정기 결제가 새 정기 결제로 대체되었습니다.

{
  "cancelSurveyResult": {
    object (CancelSurveyResult)
  },
  "cancelTime": string
}

object (CancelSurveyResult)

사용자가 정기 결제 취소 절차를 완료할 때 제공하는 정보 (취소 사유 설문조사)

string (Timestamp format)

사용자가 정기 결제를 취소한 시간입니다. 이 기간이 지난 후에도 사용자는 정기 결제 콘텐츠에 계속 액세스할 수 있습니다. lineItems.expiry_time을 사용하여 사용자가 계속 액세스할 수 있는지 확인합니다.

RFC3339 UTC 'Zulu' 형식의 타임스탬프입니다(나노초 단위, 소수점 이하 9자리). 예를 들면 "2014-10-02T15:01:23Z" 및 "2014-10-02T15:01:23.045123456Z"입니다.

{
  "reason": enum (CancelSurveyReason),
  "reasonUserInput": string
}

enum (CancelSurveyReason)

사용자가 취소 설문조사에서 선택한 이유입니다.

string

CANCEL_SURVEY_REASON_OTHERS에 대해서만 설정됩니다. 설문조사에 대한 사용자의 자유 형식 응답입니다.

{
  "externalAccountId": string,
  "obfuscatedExternalAccountId": string,
  "obfuscatedExternalProfileId": string
}

string

서드 파티 서비스의 사용자 계정 식별자입니다. 정기 결제 구매 흐름의 일부로 계정 연결이 발생한 경우에만 표시됩니다.

string

앱의 사용자 계정과 고유하게 연결된 ID의 난독화된 버전입니다. 다음 구매의 경우 표시됩니다. * 정기 결제 구매 흐름의 일부로 계정 연결이 발생한 경우. * 구매 시 https://developer.android.com/reference/com/android/billingclient/api/BillingFlowParams.Builder#setobfuscatedaccountid를 사용하여 지정됩니다.

string

앱의 사용자 프로필과 고유하게 연결된 ID의 난독화된 버전입니다. 구매 시 https://developer.android.com/reference/com/android/billingclient/api/BillingFlowParams.Builder#setobfuscatedprofileid를 사용하여 지정된 경우에만 표시됩니다.

{
  "profileId": string,
  "profileName": string,
  "emailAddress": string,
  "givenName": string,
  "familyName": string
}

string

구독을 구매한 시점의 사용자의 Google 프로필 ID입니다.

string

구독을 구매한 시점의 사용자 프로필 이름입니다.

string

구독을 구매한 시점의 사용자 이메일 주소입니다.

string

정기 결제가 구매되었을 때 사용자의 이름입니다.

string

정기 결제 상품을 구매한 사용자의 성입니다.

{
  "productId": string,
  "expiryTime": string,

  // Union field plan_type can be only one of the following:
  "autoRenewingPlan": {
    object (AutoRenewingPlan)
  },
  "prepaidPlan": {
    object (PrepaidPlan)
  }
  // End of list of possible types for union field plan_type.
  "offerDetails": {
    object (OfferDetails)
  },

  // Union field deferred_item_change can be only one of the following:
  "deferredItemReplacement": {
    object (DeferredItemReplacement)
  }
  // End of list of possible types for union field deferred_item_change.
}

string

구매한 제품 ID입니다 (예: 'monthly001').

string (Timestamp format)

액세스 권한이 연장되지 않는 한 정기 결제가 만료되거나 만료되는 시간입니다 (예: 갱신).

RFC3339 UTC 'Zulu' 형식의 타임스탬프입니다(나노초 단위, 소수점 이하 9자리). 예를 들면 "2014-10-02T15:01:23Z" 및 "2014-10-02T15:01:23.045123456Z"입니다.

object (AutoRenewingPlan)

항목이 자동 갱신됩니다.

object (PrepaidPlan)

선불 상품입니다.

object (OfferDetails)

이 항목의 혜택 세부정보입니다.

object (DeferredItemReplacement)

지연된 항목 교체에 관한 정보입니다.

{
  "autoRenewEnabled": boolean,
  "priceChangeDetails": {
    object (SubscriptionItemPriceChangeDetails)
  }
}

boolean

정기 결제가 현재 자동 갱신으로 설정되어 있는 경우(예: 사용자가 정기 결제를 취소하지 않음)

object (SubscriptionItemPriceChangeDetails)

정기 결제 가입 후 상품의 마지막 가격 변경에 관한 정보입니다.

{
  "newPrice": {
    object (Money)
  },
  "priceChangeMode": enum (PriceChangeMode),
  "priceChangeState": enum (PriceChangeState),
  "expectedNewPriceChargeTime": string
}

object (Money)

정기 결제 항목의 새로운 반복 가격

enum (PriceChangeMode)

가격 변경 모드는 정기 결제 항목 가격이 변경되는 방식을 지정합니다.

enum (PriceChangeState)

현재 가격 변경이 적용된 상태입니다.

string (Timestamp format)

가격 변경이 사용자에게 적용되는 갱신 시간입니다. 일시중지와 같이 갱신 기간이 변경되는 경우(향후 날짜로) 변경될 수 있습니다. 이 필드는 가격 변경이 적용되지 않은 경우에만 채워집니다.

RFC3339 UTC 'Zulu' 형식의 타임스탬프입니다(나노초 단위, 소수점 이하 9자리). 예를 들면 "2014-10-02T15:01:23Z" 및 "2014-10-02T15:01:23.045123456Z"입니다.

{
  "allowExtendAfterTime": string
}

string (Timestamp format)

이 기간이 지난 후에 선불 요금제의 충전 구매가 허용됩니다. 만료된 선불 요금제에는 표시되지 않습니다.

RFC3339 UTC 'Zulu' 형식의 타임스탬프입니다(나노초 단위, 소수점 이하 9자리). 예를 들면 "2014-10-02T15:01:23Z" 및 "2014-10-02T15:01:23.045123456Z"입니다.

{
  "offerTags": [
    string
  ],
  "basePlanId": string,
  "offerId": string
}

string

혜택과 연결된 최신 혜택 태그입니다. 기본 요금제에서 상속된 태그가 포함됩니다.

string

기본 요금제 ID입니다. 모든 기본 요금제 및 혜택에서 제공됩니다.

string

오퍼 ID 할인 혜택에만 표시됩니다.

{
  "productId": string
}

string

productId가 기존 productId를 대체합니다.