Method: purchases.subscriptionsv2.defer

정기 결제 갱신을 연기합니다.

HTTP 요청

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

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

경로 매개변수

매개변수
packageName

string

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

string

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

요청 본문

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

JSON 표현 
{
  "deferralContext": {
    object (DeferralContext)
  }
}
필드
deferralContext

object (DeferralContext)

필수 항목입니다. 정기 결제 연기에 관한 세부정보입니다.

응답 본문

v2 purchases.subscriptions.defer API의 응답입니다.

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

JSON 표현 
{
  "itemExpiryTimeDetails": [
    {
      object (ItemExpiryTimeDetails)
    }
  ]
}
필드
itemExpiryTimeDetails[]

object (ItemExpiryTimeDetails)

각 정기 결제 항목의 새 만료 시간입니다.

승인 범위

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

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

DeferralContext

purchases.subscriptionsv2.defer API의 연기 컨텍스트입니다.

JSON 표현 
{
  "etag": string,
  "deferDuration": string,
  "validateOnly": boolean
}
필드
etag

string

필수 항목입니다. etag가 이 정기 결제의 최신 etag와 일치하지 않으면 API가 실패합니다. etag는 purchases.subscriptionsv2.get(https://developers.google.com/android-publisher/api-ref/rest/v3/purchases.subscriptionsv2/get)에서 가져옵니다.
deferDuration

string (Duration format)

필수 항목입니다. 모든 정기 결제 항목을 연기해야 하는 기간입니다.

소수점 아래가 최대 9자리까지이고 's'로 끝나는 초 단위 기간입니다. 예를 들면 "3.5s"입니다.
validateOnly

boolean

'true'로 설정되면 요청은 subscriptionsv2.defer의 효과를 검증하기 위한 드라이 런이며 정기 결제는 영향을 받지 않습니다.

ItemExpiryTimeDetails

정기 결제 항목의 만료 시간 세부정보입니다.

JSON 표현 
{
  "productId": string,
  "expiryTime": string
}
필드
productId

string

정기 결제 항목의 제품 ID입니다 (예: 'premium_plan').
expiryTime

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"