- HTTP 요청
- 경로 매개변수
- 요청 본문
- 응답 본문
- 승인 범위
- UpdateBasePlanStateRequest
<ph type="x-smartling-placeholder">
- </ph>
- JSON 표현
- ActivateBasePlanRequest
<ph type="x-smartling-placeholder">
- </ph>
- JSON 표현
- DeactivateBasePlanRequest
<ph type="x-smartling-placeholder">
- </ph>
- JSON 표현
- 실습
하나 이상의 정기 결제에서 기본 요금제를 활성화하거나 비활성화합니다.
최대 업데이트 처리량을 달성하려면 중첩된 요청의 지연Tolerance 필드를 PRODUCT_UPDATE_LATENCY_TOLERANCE_LATENCY_TOLERANT로 설정합니다.
HTTP 요청
POST https://androidpublisher.googleapis.com/androidpublisher/v3/applications/{packageName}/subscriptions/{productId}/basePlans:batchUpdateStates
URL은 gRPC 트랜스코딩 문법을 사용합니다.
경로 매개변수
매개변수 | |
---|---|
packageName |
필수 항목입니다. 업데이트된 기본 요금제의 상위 앱 (패키지 이름)입니다. |
productId |
필수 항목입니다. 업데이트된 모든 기본 요금제가 동일한 정기 결제에 속하는 경우 상위 정기 결제의 제품 ID입니다. 이 일괄 업데이트가 여러 구독에 걸쳐 있는 경우 이 필드를 '-'로 설정합니다. 설정해야 합니다. |
요청 본문
요청 본문에는 다음과 같은 구조의 데이터가 포함됩니다.
JSON 표현 |
---|
{
"requests": [
{
object ( |
필드 | |
---|---|
requests[] |
필수 항목입니다. 최대 100개 요소로 구성된 업데이트 요청 목록입니다. 모든 요청은 서로 다른 기본 요금제를 업데이트해야 합니다. |
응답 본문
basePlans.batchUpdateStates의 응답 메시지입니다.
성공할 경우 응답 본문에 다음 구조의 데이터가 포함됩니다.
JSON 표현 |
---|
{
"subscriptions": [
{
object ( |
필드 | |
---|---|
subscriptions[] |
업데이트된 구독 목록입니다. 이 목록은 동일한 순서로 요청을 일대일로 일치시킵니다. |
승인 범위
다음 OAuth 범위가 필요합니다.
https://www.googleapis.com/auth/androidpublisher
UpdateBasePlanStateRequest
정기 결제 기본 요금제의 상태를 업데이트하기 위한 요청 메시지입니다.
JSON 표현 |
---|
{ // Union field |
필드 | |
---|---|
통합 필드 state_transition_type . 적용할 상태 전환의 유형입니다. 하나만 설정해야 합니다. state_transition_type 은 다음 중 하나여야 합니다. |
|
activateBasePlanRequest |
기본 요금제를 활성화합니다. 활성화되면 신규 구독자에게 기본 요금제가 제공됩니다. |
deactivateBasePlanRequest |
기본 요금제를 비활성화합니다. 비활성화되면 신규 정기 결제 사용자는 기본 요금제를 사용할 수 없지만 기존 정기 결제 사용자는 계속해서 정기 결제를 유지합니다. |
ActivateBasePlanRequest
ActivateBasePlan 요청 메시지입니다.
JSON 표현 |
---|
{
"packageName": string,
"productId": string,
"basePlanId": string,
"latencyTolerance": enum ( |
필드 | |
---|---|
packageName |
필수 항목입니다. 활성화할 기본 요금제의 상위 앱 (패키지 이름)입니다. |
productId |
필수 항목입니다. 활성화할 기본 요금제의 상위 정기 결제 (ID)입니다. |
basePlanId |
필수 항목입니다. 활성화할 기본 요금제의 고유한 기본 요금제 ID입니다. |
latencyTolerance |
선택사항입니다. 이 제품 업데이트 전파의 지연 시간 허용치입니다. 기본값은 지연 시간에 민감합니다. |
DeactivateBasePlanRequest
basePlans.deactivate 요청 메시지입니다.
JSON 표현 |
---|
{
"packageName": string,
"productId": string,
"basePlanId": string,
"latencyTolerance": enum ( |
필드 | |
---|---|
packageName |
필수 항목입니다. 비활성화할 기본 요금제의 상위 앱 (패키지 이름)입니다. |
productId |
필수 항목입니다. 비활성화할 기본 요금제의 상위 정기 결제 (ID)입니다. |
basePlanId |
필수 항목입니다. 비활성화할 기본 요금제의 고유한 기본 요금제 ID입니다. |
latencyTolerance |
선택사항입니다. 이 제품 업데이트 전파의 지연 시간 허용치입니다. 기본값은 지연 시간에 민감합니다. |