Method: monetization.onetimeproducts.purchaseOptions.offers.batchUpdate

하나 이상의 일회성 제품 혜택을 생성하거나 업데이트합니다.

HTTP 요청

POST https://androidpublisher.googleapis.com/androidpublisher/v3/applications/{packageName}/oneTimeProducts/{productId}/purchaseOptions/{purchaseOptionId}/offers:batchUpdate

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

경로 매개변수

매개변수
packageName

string

필수 항목입니다. 업데이트된 혜택의 상위 앱 (패키지 이름)입니다.

모든 업데이트된 OneTimeProductOffer 리소스의 packageName 필드와 동일해야 합니다.
productId

string

필수 항목입니다. 업데이트된 모든 혜택이 동일한 제품에 속하는 경우 상위 일회성 제품의 제품 ID입니다. 이 요청에 여러 개의 일회성 제품이 포함된 경우 이 필드를 '-'로 설정하세요.
purchaseOptionId

string

필수 항목입니다. 혜택을 업데이트할 상위 구매 옵션 (ID)입니다. 여러 구매 옵션의 업데이트된 혜택을 읽어오려면 '-'로 지정할 수 있습니다.

요청 본문

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

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

object (UpdateOneTimeProductOfferRequest)

필수 항목입니다. 최대 100개 요소의 업데이트 요청 목록입니다. 모든 요청은 서로 다른 혜택을 업데이트해야 합니다.

응답 본문

offers.batchUpdate의 응답 메시지입니다.

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

JSON 표현 
{
  "oneTimeProductOffers": [
    {
      object (OneTimeProductOffer)
    }
  ]
}
필드
oneTimeProductOffers[]

object (OneTimeProductOffer)

업데이트된 일회성 제품 혜택의 목록입니다. 요청에 들어 있던 목록과 순서가 동일합니다.

승인 범위

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

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

UpdateOneTimeProductOfferRequest

UpdateOneTimeProductOffer의 요청 메시지입니다.

JSON 표현 
{
  "oneTimeProductOffer": {
    object (OneTimeProductOffer)
  },
  "updateMask": string,
  "regionsVersion": {
    object (RegionsVersion)
  },
  "allowMissing": boolean,
  "latencyTolerance": enum (ProductUpdateLatencyTolerance)
}
필드
oneTimeProductOffer

object (OneTimeProductOffer)

필수 항목입니다. 업데이트할 일회성 제품 혜택입니다.
updateMask

string (FieldMask format)

필수 항목입니다. 업데이트할 필드 목록입니다.

정규화된 필드 이름의 쉼표로 구분된 목록입니다. 예: "user.displayName,photo"
regionsVersion

object (RegionsVersion)

필수 항목입니다. 혜택에 사용되는 가용 지역의 버전입니다.
allowMissing

boolean

선택사항입니다. true로 설정되고 지정된 packageName, productId, purchaseOptionId 및 offerId에 해당하는 혜택이 존재하지 않는 경우 혜택이 생성됩니다.

새 혜택이 생성되면 updateMask는 무시됩니다.
latencyTolerance

enum (ProductUpdateLatencyTolerance)

선택사항입니다. 이 혜택 업데이트의 전파에 허용되는 지연 시간입니다. 기본적으로 지연 시간에 민감합니다.