Method: purchases.subscriptionsv2.revoke

사용자의 정기 결제 구매를 subscriptionsv2.revoke합니다.

HTTP 요청

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

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

경로 매개변수

매개변수
packageName

string

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

string

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

요청 본문

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

JSON 표현 
{
  "revocationContext": {
    object (RevocationContext)
  }
}
필드
revocationContext

object (RevocationContext)

필수 항목입니다. 정기 결제 취소에 관한 추가 세부정보입니다.

응답 본문

성공한 경우 응답 본문은 비어 있습니다.

샘플

다음은 샘플 요청입니다.

curl -X POST \
  'https://androidpublisher.googleapis.com/androidpublisher/v3/applications/com.example.myapp/purchases/subscriptionsv2/tokens/sample_purchase_token:revoke' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
    "revocationContext": {
      "proratedRefund": {}
    }
  }'

승인 범위

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

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

RevocationContext

purchases.subscriptionsv2.revoke API의 취소 컨텍스트입니다.

JSON 표현 
{

  // Union field RefundType can be only one of the following:
  "fullRefund": {
    object (FullRefund)
  },
  "proratedRefund": {
    object (ProratedRefund)
  },
  "itemBasedRefund": {
    object (ItemBasedRefund)
  }
  // End of list of possible types for union field RefundType.
}
필드
통합 필드 RefundType. 승인할 환불의 유형을 정합니다. 유효한 요청의 일환으로 환불 유형이 지정되어야 합니다. RefundType은 다음 중 하나여야 합니다.
fullRefund

object (FullRefund)

선택사항입니다. 사용자가 정기 결제의 각 항목에 대해 최근 청구된 금액 전액을 환불받아야 하는 경우 사용합니다.
proratedRefund

object (ProratedRefund)

선택사항입니다. 정기 결제의 남아 있는 기간을 기준으로 사용자가 결제한 금액의 일할 계산된 금액을 환불하려는 경우 사용합니다.
itemBasedRefund

object (ItemBasedRefund)

선택사항입니다. 부가기능 항목이 포함된 정기 결제에서 특정 항목을 환불해야 하는 경우에 사용됩니다.

FullRefund

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

RevocationContext의 환불 유형이 전액 환불인지 확인하는 데 사용됩니다.

ProratedRefund

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

RevocationContext의 환불 유형이 일할 계산된 환불인지 확인하는 데 사용됩니다.

ItemBasedRefund

여러 항목이 포함된 정기 결제에서 취소할 특정 항목을 결정하는 데 사용됩니다.

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

string

필수 항목입니다. 정기 결제가 부가기능이 포함된 정기 결제인 경우 취소할 정기 결제 항목의 제품 ID입니다.