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