Method: monetization.subscriptions.basePlans.batchUpdateStates

하나 또는 여러 개의 정기 결제에서 기본 요금제를 활성화하거나 비활성화합니다.

중첩된 요청의 latencyTolerance 필드를 PRODUCT_UPDATE_LATENCY_TOLERANCE_LATENCY_TOLERANT로 설정하여 최대 업데이트 처리량을 달성합니다.

HTTP 요청

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

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

경로 매개변수

매개변수
packageName

string

필수 항목입니다. 업데이트된 기본 요금제의 상위 앱 (패키지 이름)입니다.
productId

string

필수 항목입니다. 업데이트된 모든 기본 요금제가 동일한 정기 결제에 속하는 경우 상위 정기 결제의 제품 ID입니다. 이 일괄 업데이트가 여러 정기 결제에 걸쳐 있는 경우 이 필드를 '-'로 설정합니다. 설정하지 않으면 안 됩니다.

요청 본문

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

JSON 표현 
{
  "requests": [
    {
      object (UpdateBasePlanStateRequest)
    }
  ]
}
필드
requests[]

object (UpdateBasePlanStateRequest)

필수 항목입니다. 최대 100개 요소의 업데이트 요청 목록입니다. 모든 요청은 서로 다른 기본 요금제를 업데이트해야 합니다.

응답 본문

basePlans.batchUpdateStates의 응답 메시지입니다.

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

JSON 표현 
{
  "subscriptions": [
    {
      object (Subscription)
    }
  ]
}
필드
subscriptions[]

object (Subscription)

업데이트된 정기 결제 목록입니다. 이 목록은 동일한 순서로 요청과 일대일로 일치합니다.

승인 범위

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

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

UpdateBasePlanStateRequest

정기 결제 기본 요금제의 상태를 업데이트하라는 요청 메시지입니다.

JSON 표현 
{

  // Union field state_transition_type can be only one of the following:
  "activateBasePlanRequest": {
    object (ActivateBasePlanRequest)
  },
  "deactivateBasePlanRequest": {
    object (DeactivateBasePlanRequest)
  }
  // End of list of possible types for union field state_transition_type.
}
필드
통합 필드 state_transition_type. 적용할 상태 전환의 유형입니다. 정확히 하나만 설정해야 합니다. state_transition_type은 다음 중 하나여야 합니다.
activateBasePlanRequest

object (ActivateBasePlanRequest)

기본 요금제를 활성화합니다. 활성화되면 신규 정기 결제 사용자가 기본 요금제를 사용할 수 있습니다.
deactivateBasePlanRequest

object (DeactivateBasePlanRequest)

기본 요금제를 비활성화합니다. 비활성화되면 신규 정기 결제 사용자는 기본 요금제를 사용할 수 없지만 기존 정기 결제 사용자는 정기 결제를 유지합니다.

ActivateBasePlanRequest

ActivateBasePlan 요청 메시지입니다.

JSON 표현 
{
  "packageName": string,
  "productId": string,
  "basePlanId": string,
  "latencyTolerance": enum (ProductUpdateLatencyTolerance)
}
필드
packageName

string

필수 항목입니다. 활성화할 기본 요금제의 상위 앱 (패키지 이름)입니다.
productId

string

필수 항목입니다. 활성화할 기본 요금제의 상위 정기 결제 (ID)입니다.
basePlanId

string

필수 항목입니다. 활성화할 기본 요금제의 고유 기본 요금제 ID입니다.
latencyTolerance

enum (ProductUpdateLatencyTolerance)

선택사항입니다. 이 제품 업데이트의 전파에 허용되는 지연 시간입니다. 기본값은 latency-sensitive입니다.

DeactivateBasePlanRequest

basePlans.deactivate 요청 메시지입니다.

JSON 표현 
{
  "packageName": string,
  "productId": string,
  "basePlanId": string,
  "latencyTolerance": enum (ProductUpdateLatencyTolerance)
}
필드
packageName

string

필수 항목입니다. 비활성화할 기본 요금제의 상위 앱 (패키지 이름)입니다.
productId

string

필수 항목입니다. 비활성화할 기본 요금제의 상위 정기 결제 (ID)입니다.
basePlanId

string

필수 항목입니다. 비활성화할 기본 요금제의 고유 기본 요금제 ID입니다.
latencyTolerance

enum (ProductUpdateLatencyTolerance)

선택사항입니다. 이 제품 업데이트의 전파에 허용되는 지연 시간입니다. 기본값은 latency-sensitive입니다.