정기 결제 요금제 전환을 예약합니다.
HTTP 요청
POST https://androidpublisher.googleapis.com/androidpublisher/v3/applications/{packageName}/purchases/subscriptionsv2/tokens/{token}:schedulePlanTransition
URL은 gRPC 트랜스코딩 문법을 사용합니다.
경로 매개변수
| 매개변수 | |
|---|---|
packageName |
필수 항목입니다. 이 정기 결제의 구매가 이루어진 애플리케이션의 패키지입니다(예: 'com.some.thing'). |
token |
필수 항목입니다. 정기 결제를 구매했을 때 사용자 기기에 제공된 토큰입니다. |
요청 본문
요청 본문에는 다음과 같은 구조의 데이터가 포함됩니다.
| 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 ( |
| 필드 | |
|---|---|
productId |
필수 항목입니다. 전환을 예약할 정기 결제 제품입니다(예: 'premium_plan'). |
earliestTransitionEffectiveTime |
필수 항목입니다. 요금제 전환이 이루어질 가장 이른 시간입니다. 실제 전환은 갱신 시점에 또는 이 시간 이후에 이루어집니다. 생성된 출력은 항상 Z-정규화되고 소수점 이하 0, 3, 6 또는 9자리인 RFC 3339를 사용합니다. 'Z' 이외의 오프셋도 허용됩니다. 예를 들면 |
| [필수] 요금제 전환의 모드입니다. 다음은 상호 배타적인 필드 목록입니다. 응답에서 최대 하나의 필드가 설정됩니다. | |
definiteTransition |
이 모드를 사용하면 사용자가 확정적으로 새 요금제로 전환되며 전환이 취소될 수 없습니다. |
tentativeTransition |
이 모드를 사용하면 사용자가 조건부로 새 요금제로 전환되며 전환이 취소될 수 있습니다. |
| 상호 배타적 필드의 끝입니다. | |
etag |
설정된 경우 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 |
정기 결제 항목의 요금제 전환 세부정보입니다. |
승인 범위
다음 OAuth 범위가 필요합니다.
https://www.googleapis.com/auth/androidpublisher
DefiniteTransition
이 유형에는 필드가 없습니다.
요금제 전환이 확정적임을 나타내는 데 사용됩니다.
TentativeTransition
이 유형에는 필드가 없습니다.
요금제 전환이 조건부임을 나타내는 데 사용됩니다.