정기 결제 상품 배치를 업데이트합니다.
최대 업데이트 처리량을 달성하려면 중첩된 요청의latencyTolerance 필드를 PRODUCT_UPDATE_LATENCY_TOLERANCE_LATENCY_TOLERANT로 설정합니다.
HTTP 요청
POST https://androidpublisher.googleapis.com/androidpublisher/v3/applications/{packageName}/subscriptions/{productId}/basePlans/{basePlanId}/offers:batchUpdate
URL은 gRPC 트랜스코딩 구문을 사용합니다.
경로 매개변수
매개변수 | |
---|---|
packageName |
필수 항목입니다. 업데이트된 정기 결제 혜택의 상위 앱 (패키지 이름)입니다. 업데이트된 모든 SubscriptionOffer 리소스의 packageName 필드와 같아야 합니다. |
productId |
필수 항목입니다. 업데이트된 모든 혜택이 동일한 정기 결제에 속한 경우 상위 정기 결제의 제품 ID입니다. 이 요청이 여러 구독에 걸쳐 있는 경우 이 필드를 '-'로 설정합니다. 설정해야 합니다. |
basePlanId |
필수 항목입니다. 혜택을 업데이트해야 하는 상위 기본 요금제 (ID)입니다. 여러 기본 요금제의 혜택을 업데이트하려면 '-'로 지정할 수 있습니다. |
요청 본문
요청 본문에는 다음과 같은 구조의 데이터가 포함됩니다.
JSON 표현 |
---|
{
"requests": [
{
object ( |
필드 | |
---|---|
requests[] |
필수 항목입니다. 최대 100개의 요소로 구성된 업데이트 요청 목록 모든 요청은 서로 다른 정기 결제 혜택을 업데이트해야 합니다. |
응답 본문
offer.batchUpdate의 응답 메시지입니다.
성공할 경우 응답 본문에 다음 구조의 데이터가 포함됩니다.
JSON 표현 |
---|
{
"subscriptionOffers": [
{
object ( |
필드 | |
---|---|
subscriptionOffers[] |
업데이트된 정기 결제 혜택 목록입니다. |
승인 범위
다음 OAuth 범위가 필요합니다.
https://www.googleapis.com/auth/androidpublisher
UpdateSubscriptionOfferRequest
offer.patch 요청 메시지입니다.
JSON 표현 |
---|
{ "subscriptionOffer": { object ( |
필드 | |
---|---|
subscriptionOffer |
필수 항목입니다. 업데이트할 정기 결제 혜택입니다. |
updateMask |
필수 항목입니다. 업데이트할 필드 목록입니다. 필드의 정규화된 이름을 쉼표로 구분한 목록입니다. 예: |
regionsVersion |
필수 항목입니다. subscriptionOffer에 사용되는 사용 가능한 지역의 버전입니다. |
allowMissing |
선택사항입니다. true로 설정되고 지정된 packageName, productId, basePlanId, offerId를 사용하는 정기 결제 혜택이 없으면 혜택이 생성됩니다. 새 오퍼가 생성되면 updateMask가 무시됩니다. |
latencyTolerance |
선택사항입니다. 이 제품 업데이트 전파의 지연 시간 허용 범위입니다. 기본값은 지연 시간에 민감합니다. |