Method: monetization.subscriptions.basePlans.migratePrices

이전 정기 결제 가격을 받는 정기 결제를 지정된 지역에서 현재 제공되는 가격으로 이전합니다. 요청하면 제공된 타임스탬프보다 이전 가격을 수신하는 사용자에게 가격 변경 알림이 전송됩니다. 새 요금에 동의하지 않는 정기 결제 사용자는 다음 갱신 시 정기 결제가 종료됩니다.

HTTP 요청

POST https://androidpublisher.googleapis.com/androidpublisher/v3/applications/{packageName}/subscriptions/{productId}/basePlans/{basePlanId}:migratePrices

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

경로 매개변수

매개변수
packageName

string

필수 항목입니다. 상위 앱의 패키지 이름입니다. 구독 리소스의 packageName 필드와 같아야 합니다.

productId

string

필수 항목입니다. 업데이트할 구독의 ID입니다. 구독 리소스의 productId 필드와 동일해야 합니다.

basePlanId

string

필수 항목입니다. 가격을 업데이트할 기본 요금제의 고유한 기본 요금제 ID입니다.

요청 본문

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

JSON 표현
{
  "regionalPriceMigrations": [
    {
      object (RegionalPriceMigrationConfig)
    }
  ],
  "regionsVersion": {
    object (RegionsVersion)
  }
}
필드
regionalPriceMigrations[]

object (RegionalPriceMigrationConfig)

필수 항목입니다. 업데이트할 지역별 가격입니다.

regionsVersion

object (RegionsVersion)

필수 항목입니다. RegionalPriceMigration에 사용되는 가용 리전의 버전입니다.

응답 본문

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

승인 범위

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

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

지역별 가격 이전 구성

가격 마이그레이션 구성입니다.

JSON 표현
{
  "regionCode": string,
  "oldestAllowedPriceVersionTime": string
}
필드
regionCode

string

필수 항목입니다. 이 구성이 적용되는 지역 코드입니다(ISO 3166-2에 정의된 경우). 예: 'US'

oldestAllowedPriceVersionTime

string (Timestamp format)

필수 항목입니다. 정기 결제 사용자가 요금을 지불할 수 있는 이전 가격의 마감 시간입니다. 이 마감 시간 전에 생성된 가격으로 정기 결제를 이용하는 정기 결제 사용자에게는 현재 제공되는 가격으로 이전됩니다. 이러한 정기 결제 사용자에게는 다른 요금이 적용된다는 알림이 전송됩니다. 새 요금에 동의하지 않는 정기 결제 사용자는 다음 갱신 시 정기 결제가 종료됩니다.

RFC3339 UTC 'Zulu' 형식의 타임스탬프(나노초 해상도 및 최대 9자리 소수) 예: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z"