Method: purchases.subscriptionsv2.scheduleplantransition

정기 결제 요금제 전환을 예약합니다.

HTTP 요청

POST https://androidpublisher.googleapis.com/androidpublisher/v3/applications/{packageName}/purchases/subscriptionsv2/tokens/{token}:schedulePlanTransition

URL은 gRPC 트랜스코딩 문법을 사용합니다.

경로 매개변수

매개변수
packageName

string

필수 항목입니다. 이 정기 결제의 구매가 이루어진 애플리케이션의 패키지입니다(예: 'com.some.thing').

token

string

필수 항목입니다. 정기 결제를 구매했을 때 사용자 기기에 제공된 토큰입니다.

요청 본문

요청 본문에는 다음과 같은 구조의 데이터가 포함됩니다.

JSON 표현
{
  "productId": string,
  "earliestTransitionEffectiveTime": string,

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "definiteTransition": {
    object (DefiniteTransition)
  },
  "tentativeTransition": {
    object (TentativeTransition)
  }
  // End of mutually exclusive fields.
  "etag": string
}
필드
productId

string

필수 항목입니다. 전환을 예약할 정기 결제 제품입니다(예: 'premium_plan').

earliestTransitionEffectiveTime

string (Timestamp format)

필수 항목입니다. 요금제 전환이 이루어질 가장 이른 시간입니다. 실제 전환은 갱신 시점에 또는 이 시간 이후에 이루어집니다.

생성된 출력은 항상 Z-정규화되고 소수점 이하 0, 3, 6 또는 9자리인 RFC 3339를 사용합니다. 'Z' 이외의 오프셋도 허용됩니다. 예를 들면 "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" 또는 "2014-10-02T15:01:23+05:30"입니다.

[필수] 요금제 전환의 모드입니다. 다음은 상호 배타적인 필드 목록입니다. 응답에서 최대 하나의 필드가 설정됩니다.
definiteTransition

object (DefiniteTransition)

이 모드를 사용하면 사용자가 확정적으로 새 요금제로 전환되며 전환이 취소될 수 없습니다.

tentativeTransition

object (TentativeTransition)

이 모드를 사용하면 사용자가 조건부로 새 요금제로 전환되며 전환이 취소될 수 있습니다.

상호 배타적 필드의 끝입니다.
etag

string

설정된 경우 ETag가 이 정기 결제의 최신 ETag와 일치하지 않으면 API가 실패합니다. ETag는 purchases.subscriptionsv2.get(https://developers.google.com/android-publisher/api-ref/rest/v3/purchases.subscriptionsv2/get)에서 가져옵니다.

응답 본문

purchases.subscriptionsv2.schedulePlanTransition API의 응답입니다.

성공한 경우 응답 본문은 다음과 같은 구조의 데이터를 포함합니다.

JSON 표현
{
  "planTransitionDetails": {
    object (PlanTransitionDetails)
  }
}
필드
planTransitionDetails

object (PlanTransitionDetails)

정기 결제 항목의 요금제 전환 세부정보입니다.

승인 범위

다음 OAuth 범위가 필요합니다.

  • https://www.googleapis.com/auth/androidpublisher

DefiniteTransition

이 유형에는 필드가 없습니다.

요금제 전환이 확정적임을 나타내는 데 사용됩니다.

TentativeTransition

이 유형에는 필드가 없습니다.

요금제 전환이 조건부임을 나타내는 데 사용됩니다.