Method: monetization.onetimeproducts.purchaseOptions.offers.batchUpdateStates

하나의 배치에 속한 여러 개의 일회성 제품 혜택의 상태를 업데이트합니다.

HTTP 요청

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

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

경로 매개변수

매개변수
packageName

string

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

string

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

string

필수 항목입니다. 업데이트된 모든 혜택이 동일한 구매 옵션에 속할 경우 상위 구매 옵션의 구매 옵션 ID입니다. 이 일괄 업데이트에 여러 구매 옵션이 포함될 경우 이 필드를 '-'로 설정합니다.

요청 본문

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

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

object (UpdateOneTimeProductOfferStateRequest)

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

응답 본문

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

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

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

object (OneTimeProductOffer)

업데이트된 일회성 제품 혜택 목록으로, 요청과 순서가 동일합니다.

승인 범위

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

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

UpdateOneTimeProductOfferStateRequest

일회성 제품 혜택의 상태를 업데이트하는 요청 메시지입니다.

JSON 표현 
{

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "activateOneTimeProductOfferRequest": {
    object (ActivateOneTimeProductOfferRequest)
  },
  "cancelOneTimeProductOfferRequest": {
    object (CancelOneTimeProductOfferRequest)
  },
  "deactivateOneTimeProductOfferRequest": {
    object (DeactivateOneTimeProductOfferRequest)
  }
  // End of mutually exclusive fields.
}
필드
적용할 상태 전환의 유형입니다. 정확히 하나만 설정해야 합니다. 다음은 상호 배타적인 필드 목록입니다. 응답에서 최대 하나의 필드가 설정됩니다.
activateOneTimeProductOfferRequest

object (ActivateOneTimeProductOfferRequest)

혜택을 활성화합니다. 활성화되면 조건이 충족되는 한 혜택이 사용자에게 제공됩니다.
cancelOneTimeProductOfferRequest

object (CancelOneTimeProductOfferRequest)

혜택을 취소합니다. 취소되면 혜택이 사용자에게 제공되지 않습니다. 이 혜택과 관련된 대기 중인 주문은 취소됩니다. 이 상태 전환은 선주문에만 적용됩니다.
deactivateOneTimeProductOfferRequest

object (DeactivateOneTimeProductOfferRequest)

혜택을 비활성화합니다. 비활성화되면 혜택이 사용자에게 더 이상 제공되지 않습니다. 이 상태 전환은 할인 및 게임 리워드 혜택에만 적용됩니다.
상호 배타적 필드의 끝입니다.

CancelOneTimeProductOfferRequest

offers.cancel의 요청 메시지입니다.

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

string

필수 항목입니다. 취소할 혜택의 상위 앱(패키지 이름)입니다.
productId

string

필수 항목입니다. 취소할 혜택의 상위 일회성 제품(ID)입니다.
purchaseOptionId

string

필수 항목입니다. 취소할 혜택의 상위 구매 옵션(ID)입니다.
offerId

string

필수 항목입니다. 취소할 혜택의 혜택 ID입니다.
latencyTolerance

enum (ProductUpdateLatencyTolerance)

선택사항입니다. 이 업데이트의 허용되는 전파 지연 시간입니다. 기본적으로 지연 시간에 민감하도록 설정됩니다.

DeactivateOneTimeProductOfferRequest

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

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

string

필수 항목입니다. 비활성화할 혜택의 상위 앱(패키지 이름)입니다.
productId

string

필수 항목입니다. 비활성화할 혜택의 상위 일회성 제품(ID)입니다.
purchaseOptionId

string

필수 항목입니다. 비활성화할 혜택의 상위 구매 옵션(ID)입니다.
offerId

string

필수 항목입니다. 비활성화할 혜택의 혜택 ID입니다.
latencyTolerance

enum (ProductUpdateLatencyTolerance)

선택사항입니다. 이 업데이트의 허용되는 전파 지연 시간입니다. 기본적으로 지연 시간에 민감하도록 설정됩니다.