Method: monetization.onetimeproducts.purchaseOptions.batchUpdateStates

하나 또는 여러 개의 일회성 제품에서 구매 옵션을 활성화 또는 비활성화합니다.

HTTP 요청

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

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

경로 매개변수

매개변수
packageName

string

필수 항목입니다. 업데이트된 구매 옵션의 상위 앱 (패키지 이름)입니다.
productId

string

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

요청 본문

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

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

object (UpdatePurchaseOptionStateRequest)

필수 항목입니다. 최대 100개의 요소로 이루어진 업데이트 요청 목록입니다. 모든 요청은 서로 다른 구매 옵션을 업데이트해야 합니다.

응답 본문

purchaseOptions.batchUpdateStates에 대한 응답 메시지입니다.

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

JSON 표현 
{
  "oneTimeProducts": [
    {
      object (OneTimeProduct)
    }
  ]
}
필드
oneTimeProducts[]

object (OneTimeProduct)

업데이트된 일회성 제품의 목록입니다. 이 목록은 요청에 들어 있던 목록과 동일한 순서로 일대일 대응됩니다.

승인 범위

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

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

UpdatePurchaseOptionStateRequest

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

JSON 표현 
{

  // Union field state_transition_type can be only one of the following:
  "activatePurchaseOptionRequest": {
    object (ActivatePurchaseOptionRequest)
  },
  "deactivatePurchaseOptionRequest": {
    object (DeactivatePurchaseOptionRequest)
  }
  // End of list of possible types for union field state_transition_type.
}
필드
통합 필드 state_transition_type. 적용할 상태 전환의 유형입니다. 정확히 하나만 설정해야 합니다. state_transition_type은 다음 중 하나여야 합니다.
activatePurchaseOptionRequest

object (ActivatePurchaseOptionRequest)

구매 옵션을 활성화합니다. 활성화된 구매 옵션은 사용자에게 제공됩니다.
deactivatePurchaseOptionRequest

object (DeactivatePurchaseOptionRequest)

구매 옵션을 비활성화합니다. 비활성화된 구매 옵션은 사용자에게 제공되지 않습니다.

ActivatePurchaseOptionRequest

UpdatePurchaseOptionState에 대한 요청 메시지입니다.

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

string

필수 항목입니다. 활성화할 구매 옵션의 상위 앱 (패키지 이름)입니다.
productId

string

필수 항목입니다. 활성화할 구매 옵션의 상위 일회성 제품 (ID)입니다.
purchaseOptionId

string

필수 항목입니다. 활성화할 구매 옵션의 구매 옵션 ID입니다.
latencyTolerance

enum (ProductUpdateLatencyTolerance)

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

DeactivatePurchaseOptionRequest

UpdatePurchaseOptionState에 대한 요청 메시지입니다.

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

string

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

string

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

string

필수 항목입니다. 비활성화할 구매 옵션의 구매 옵션 ID입니다.
latencyTolerance

enum (ProductUpdateLatencyTolerance)

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