Method: monetization.subscriptions.basePlans.offers.batchUpdateStates

• HTTP 요청
• 경로 매개변수
• 요청 본문
  • JSON 표현
• 응답 본문
  • JSON 표현
• 승인 범위
• UpdateSubscriptionOfferStateRequest
  • JSON 표현
• ActivateSubscriptionOfferRequest
  • JSON 표현
• DeactivateSubscriptionOfferRequest
  • JSON 표현
• 실습

정기 결제 혜택 상태 배치를 업데이트합니다.

최대 업데이트 처리량을 달성하려면 중첩된 요청의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	string 필수 항목입니다. 업데이트된 정기 결제 혜택의 상위 앱 (패키지 이름)입니다. 업데이트된 모든 SubscriptionOffer 리소스의 packageName 필드와 같아야 합니다.
productId	string 필수 항목입니다. 업데이트된 모든 혜택이 동일한 정기 결제에 속한 경우 상위 정기 결제의 제품 ID입니다. 이 요청이 여러 구독에 걸쳐 있는 경우 이 필드를 '-'로 설정합니다. 설정해야 합니다.
basePlanId	string 필수 항목입니다. 혜택을 업데이트해야 하는 상위 기본 요금제 (ID)입니다. 여러 기본 요금제의 혜택을 업데이트하려면 '-'로 지정할 수 있습니다.

요청 본문

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

JSON 표현
{ "requests": [ { object (UpdateSubscriptionOfferStateRequest) } ] }

필드
requests[]	object (UpdateSubscriptionOfferStateRequest) 필수 항목입니다. 최대 100개의 요소로 구성된 업데이트 요청 목록입니다. 모든 요청에서 다른 혜택을 업데이트해야 합니다.

응답 본문

offer.batchUpdateStates 응답 메시지입니다.

성공할 경우 응답 본문에 다음 구조의 데이터가 포함됩니다.

JSON 표현
{ "subscriptionOffers": [ { object (SubscriptionOffer) } ] }

필드
subscriptionOffers[]	object (SubscriptionOffer) 업데이트된 정기 결제 혜택 목록입니다.

승인 범위

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

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

UpdateSubscriptionOfferStateRequest

정기 결제 혜택의 상태를 업데이트하기 위한 요청 메시지입니다.

JSON 표현
{ // Union field state_transition_type can be only one of the following: "activateSubscriptionOfferRequest": { object (ActivateSubscriptionOfferRequest) }, "deactivateSubscriptionOfferRequest": { object (DeactivateSubscriptionOfferRequest) } // End of list of possible types for union field state_transition_type. }

필드
통합 필드 state_transition_type. 적용할 상태 전환 유형으로, 정확히 하나만 설정해야 합니다. state_transition_type은 다음 중 하나여야 합니다.
activateSubscriptionOfferRequest	object (ActivateSubscriptionOfferRequest) 혜택을 활성화합니다. 활성화되면 신규 정기 결제 사용자가 혜택을 이용할 수 있습니다.
deactivateSubscriptionOfferRequest	object (DeactivateSubscriptionOfferRequest) 혜택을 비활성화합니다. 비활성화되면 신규 정기 결제 사용자는 혜택을 사용할 수 없게 되지만 기존 정기 결제 사용자는 계속 이용할 수 있습니다.

ActivateSubscriptionOfferRequest

ActivateSubscriptionOffer 요청 메시지입니다.

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

필드
packageName	string 필수 항목입니다. 활성화할 혜택의 상위 앱 (패키지 이름)입니다.
productId	string 필수 항목입니다. 활성화할 혜택의 상위 정기 결제 (ID)입니다.
basePlanId	string 필수 항목입니다. 활성화할 혜택의 상위 요금제 (ID)입니다.
offerId	string 필수 항목입니다. 활성화할 혜택의 고유한 혜택 ID입니다.
latencyTolerance	enum (ProductUpdateLatencyTolerance) 선택사항입니다. 이 제품 업데이트 전파의 지연 시간 허용 범위입니다. 기본값은 지연 시간에 민감합니다.

DeactivateSubscriptionOfferRequest

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

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

필드
packageName	string 필수 항목입니다. 비활성화할 혜택의 상위 앱 (패키지 이름)입니다.
productId	string 필수 항목입니다. 비활성화할 혜택의 상위 정기 결제 (ID)입니다.
basePlanId	string 필수 항목입니다. 비활성화할 혜택의 상위 기본 요금제 (ID)입니다.
offerId	string 필수 항목입니다. 비활성화할 혜택의 고유한 혜택 ID입니다.
latencyTolerance	enum (ProductUpdateLatencyTolerance) 선택사항입니다. 이 제품 업데이트 전파의 지연 시간 허용 범위입니다. 기본값은 지연 시간에 민감합니다.