REST Resource: monetization.onetimeproducts

리소스: OneTimeProduct

앱의 단일 일회성 제품입니다.

JSON 표현 
{
  "packageName": string,
  "productId": string,
  "listings": [
    {
      object (OneTimeProductListing)
    }
  ],
  "taxAndComplianceSettings": {
    object (OneTimeProductTaxAndComplianceSettings)
  },
  "purchaseOptions": [
    {
      object (OneTimeProductPurchaseOption)
    }
  ],
  "restrictedPaymentCountries": {
    object (RestrictedPaymentCountries)
  },
  "offerTags": [
    {
      object (OfferTag)
    }
  ],
  "regionsVersion": {
    object (RegionsVersion)
  }
}
필드
packageName

string

필수 항목입니다. 변경할 수 없습니다. 상위 앱의 패키지 이름입니다.
productId

string

필수 항목입니다. 변경할 수 없습니다. 제품의 고유 제품 ID입니다. 상위 앱 내에서 고유합니다. 제품 ID는 숫자 또는 소문자로 시작해야 하며 숫자 (0~9), 소문자 (a~z), 밑줄 (_), 마침표 (.)를 포함할 수 있습니다.
listings[]

object (OneTimeProductListing)

필수 항목입니다. 현지화된 제목 및 설명 데이터 집합입니다. languageCode가 동일한 중복 항목이 없어야 합니다.
taxAndComplianceSettings

object (OneTimeProductTaxAndComplianceSettings)

세금 및 법률 규정 준수에 관한 세부정보입니다.
purchaseOptions[]

object (OneTimeProductPurchaseOption)

필수 항목입니다. 이 일회성 제품의 구매 옵션 집합입니다.
restrictedPaymentCountries

object (RestrictedPaymentCountries)

선택사항입니다. 이 일회성 제품의 구매가 동일한 국가에 등록된 결제 수단으로 제한된 국가입니다. 비어 있는 경우 결제 위치 제한이 적용되지 않습니다.
offerTags[]

object (OfferTag)

선택사항입니다. 이 일회성 제품에 지정되고 결제 라이브러리를 통해 앱에 반환되는 최대 20개의 맞춤 태그 목록입니다. 이 제품의 구매 옵션과 혜택도 결제 라이브러리에서 이러한 태그를 수신합니다.
regionsVersion

object (RegionsVersion)

출력 전용입니다. 일회성 제품을 생성하는 데 사용된 지역 구성의 버전입니다.

OneTimeProductListing

일회성 제품의 지역 스토어 등록정보입니다.

JSON 표현 
{
  "languageCode": string,
  "title": string,
  "description": string
}
필드
languageCode

string

필수 항목입니다. 이 등록정보의 언어이며 BCP-47에 따라 정의됩니다(예: 'en-US').
title

string

필수 항목입니다. 이 등록정보의 언어로 표시되는 이 제품의 제목입니다. 최대 길이는 55자(영문 기준)입니다.
description

string

필수 항목입니다. 이 등록정보의 언어로 된 이 제품의 설명입니다. 최대 길이는 200자(영문 기준)입니다.

OneTimeProductTaxAndComplianceSettings

일회성 제품의 세금, Google Play 정책, 법률 준수에 관한 세부정보입니다.

JSON 표현 
{
  "regionalTaxConfigs": [
    {
      object (RegionalTaxConfig)
    }
  ],
  "isTokenizedDigitalAsset": boolean
}
필드
regionalTaxConfigs[]

object (RegionalTaxConfig)

지역세 구성입니다.
isTokenizedDigitalAsset

boolean

이 일회성 제품이 토큰화된 디지털 애셋을 나타내는 제품으로 선언되었는지 여부입니다.

RegionalTaxConfig

주어진 지리적 지역의 과세에 관한 세부정보입니다.

JSON 표현 
{
  "regionCode": string,
  "taxTier": enum (TaxTier),
  "eligibleForStreamingServiceTaxRate": boolean,
  "streamingTaxType": enum (StreamingTaxType)
}
필드
regionCode

string

필수 항목입니다. 이 구성에는 ISO 3166-2에 정의된 지역 코드(예: 'US')가 적용됩니다.
taxTier

enum (TaxTier)

감면된 세율을 지정하는 세금 등급입니다. 여러 지역에서 디지털 뉴스, 잡지, 신문, 도서 또는 오디오북을 판매하는 개발자는 감면된 세율 대상일 수 있습니다.

자세히 알아보기
eligibleForStreamingServiceTaxRate

boolean

미국 주 및 지방 판매세를 정확하게 청구할 수 있도록 앱에 스트리밍 상품이 포함되어 있는지 Google에 알려야 합니다. 미국에서만 지원되는 필드입니다.
streamingTaxType

enum (StreamingTaxType)

미국에서 통신세 또는 유흥세를 징수하려면 적절한 세금 카테고리를 선택하세요.

자세히 알아보기

OneTimeProductPurchaseOption

일회성 제품의 단일 구매 옵션입니다.

JSON 표현 
{
  "purchaseOptionId": string,
  "state": enum (State),
  "regionalPricingAndAvailabilityConfigs": [
    {
      object (RegionalPricingAndAvailabilityConfig)
    }
  ],
  "newRegionsConfig": {
    object (OneTimeProductPurchaseOptionNewRegionsConfig)
  },
  "offerTags": [
    {
      object (OfferTag)
    }
  ],
  "taxAndComplianceSettings": {
    object (PurchaseOptionTaxAndComplianceSettings)
  },

  // Union field purchase_option_type can be only one of the following:
  "buyOption": {
    object (OneTimeProductBuyPurchaseOption)
  },
  "rentOption": {
    object (OneTimeProductRentPurchaseOption)
  }
  // End of list of possible types for union field purchase_option_type.
}
필드
purchaseOptionId

string

필수 항목입니다. 변경할 수 없습니다. 이 구매 옵션의 고유 식별자입니다. 일회성 제품 내에서 고유해야 합니다. 숫자 또는 소문자로 시작해야 하며, 소문자(a~z), 숫자(0~9), 하이픈(-)만 포함할 수 있습니다. 최대 길이는 63자(영문 기준)입니다.
state

enum (State)

출력 전용입니다. 구매 옵션의 상태(활성 상태 여부)입니다. 이 필드는 리소스를 업데이트하여 변경할 수 없습니다. 대신 전용 엔드포인트를 사용하세요.
regionalPricingAndAvailabilityConfigs[]

object (RegionalPricingAndAvailabilityConfig)

이 구매 옵션의 지역별 가격 및 이용 가능 여부 정보입니다.
newRegionsConfig

object (OneTimeProductPurchaseOptionNewRegionsConfig)

향후 Play가 출시될 수 있는 새 지역의 가격 정보입니다. 생략되는 경우 구매 옵션은 향후 Play가 출시될 수 있는 새 지역에서 자동으로 제공되지 않습니다.
offerTags[]

object (OfferTag)

선택사항입니다. 이 구매 옵션에 지정되고 결제 라이브러리를 통해 앱에 반환되는 최대 20개의 맞춤 태그 목록입니다. 이 구매 옵션의 혜택은 결제 라이브러리에서 이러한 태그를 수신합니다.
taxAndComplianceSettings

object (PurchaseOptionTaxAndComplianceSettings)

선택사항입니다. 세금 및 법률 규정 준수에 관한 세부정보입니다.
통합 필드 purchase_option_type. 이 구매 옵션의 유형입니다. 정확히 하나를 설정해야 합니다. purchase_option_type은 다음 중 하나여야 합니다.
buyOption

object (OneTimeProductBuyPurchaseOption)

구매할 수 있는 구매 옵션입니다.
rentOption

object (OneTimeProductRentPurchaseOption)

대여할 수 있는 구매 옵션입니다.

주

구매 옵션의 현재 상태입니다.

열거형
STATE_UNSPECIFIED 기본값이며 사용하면 안 됩니다.
DRAFT 구매 옵션이 사용자에게 제공되지 않으며 제공된 적도 없습니다.
ACTIVE 사용자에게 제공되는 구매 옵션입니다.
INACTIVE 더 이상 사용자에게 제공되지 않는 구매 옵션입니다.
INACTIVE_PUBLISHED 이 구매 옵션은 더 이상 구매에서 제공되지 않지만 하위 호환성을 위해 Play 결제 라이브러리를 통해 그 혜택은 계속 노출됩니다. 자동으로 이전된 구매 옵션만 이 상태에 있을 수 있습니다.

OneTimeProductBuyPurchaseOption

구매할 수 있는 구매 옵션입니다.

JSON 표현 
{
  "legacyCompatible": boolean,
  "multiQuantityEnabled": boolean
}
필드
legacyCompatible

boolean

선택사항입니다. 일회성 제품 모델을 지원하지 않는 기존 PBL 흐름에서 이 구매 옵션을 사용할 수 있는지 여부입니다.

최대 하나의 '구매' 구매 옵션을 하위 호환으로 표시할 수 있습니다.
multiQuantityEnabled

boolean

선택사항입니다. 이 구매 옵션에서 다중 수량을 허용하는지 여부입니다. 다중 수량을 사용하면 구매자가 단일 결제에서 두 개 이상의 상품을 구매할 수 있습니다.

OneTimeProductRentPurchaseOption

대여할 수 있는 구매 옵션입니다.

JSON 표현 
{
  "rentalPeriod": string,
  "expirationPeriod": string
}
필드
rentalPeriod

string

필수 항목입니다. 사용자가 권한을 보유하는 기간입니다. 구매 흐름 완료 시 시작됩니다. ISO 8601 형식으로 지정됩니다.
expirationPeriod

string

선택사항입니다. 사용자가 사용 권한을 사용하기 시작한 후 취소되기까지의 시간입니다. ISO 8601 형식으로 지정됩니다.

RegionalPricingAndAvailabilityConfig

구매 옵션의 지역별 가격 및 이용 가능 여부 구성입니다.

JSON 표현 
{
  "regionCode": string,
  "price": {
    object (Money)
  },
  "availability": enum (Availability)
}
필드
regionCode

string

필수 항목입니다. 이 구성이 적용되는 지역 코드입니다. 지역 코드는 ISO 3166-2에 따라 정의됩니다(예: 'US').
price

object (Money)

지정된 지역의 구매 옵션 가격입니다. 지정된 지역에 연결된 통화로 설정해야 합니다.
availability

enum (Availability)

구매 옵션의 사용 가능 여부입니다.

가용성

구매 옵션의 사용 가능 여부입니다.

열거형
AVAILABILITY_UNSPECIFIED 사용 가능 여부가 지정되지 않았습니다. 사용하면 안 됩니다.
AVAILABLE 사용자에게 제공되는 구매 옵션입니다.
NO_LONGER_AVAILABLE 더 이상 사용자에게 제공되지 않는 구매 옵션입니다. 이 값은 사용 가능 여부가 이전에 AVAILABLE로 설정된 경우에만 사용할 수 있습니다.
AVAILABLE_IF_RELEASED 이 구매 옵션은 처음에는 사용할 수 없지만 출시된 선주문 혜택을 통해 사용할 수 있습니다.

OneTimeProductPurchaseOptionNewRegionsConfig

향후 Play가 출시될 수 있는 새 지역의 가격 정보입니다.

JSON 표현 
{
  "usdPrice": {
    object (Money)
  },
  "eurPrice": {
    object (Money)
  },
  "availability": enum (Availability)
}
필드
usdPrice

object (Money)

필수 항목입니다. Play가 출시될 수 있는 새 지역에 사용할 가격(USD)입니다.
eurPrice

object (Money)

필수 항목입니다. Play가 출시될 수 있는 새 지역에 사용할 가격(EUR)입니다.
availability

enum (Availability)

필수 항목입니다. 새 지역 구성의 지역별 사용 가능 여부입니다. AVAILABLE로 설정되면 가격 정보는 향후 Play가 출시될 수 있는 새 지역에 사용됩니다.

가용성

새 지역 구성의 사용 가능 여부입니다.

열거형
AVAILABILITY_UNSPECIFIED 사용 가능 여부가 지정되지 않았습니다. 사용하면 안 됩니다.
AVAILABLE 이 구성은 향후 Play가 출시될 수 있는 새 지역에 사용됩니다.
NO_LONGER_AVAILABLE 이 구성은 더 이상 사용할 수 없고 향후 Play가 출시될 수 있는 새 지역에도 사용되지 않습니다. 이 값은 사용 가능 여부가 이전에 AVAILABLE로 설정된 경우에만 사용할 수 있습니다.

PurchaseOptionTaxAndComplianceSettings

일회성 제품 구매 옵션의 세금, Google Play 정책, 법률 준수에 관한 세부정보입니다.

JSON 표현 
{
  "withdrawalRightType": enum (WithdrawalRightType)
}
필드
withdrawalRightType

enum (WithdrawalRightType)

선택사항입니다. 자격 요건을 충족하는 지역의 사용자에게 배포되는 제품의 디지털 콘텐츠 또는 서비스 분류입니다.

설정되지 않은 경우 기본값은 WITHDRAWAL_RIGHT_DIGITAL_CONTENT입니다.

자세한 내용은 고객센터 도움말을 참고하세요.

메서드

batchDelete

 하나 이상의 일회성 제품을 삭제합니다.

batchGet

 하나 이상의 일회성 제품을 읽어옵니다.

batchUpdate

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

delete

 일회성 제품을 삭제합니다.

get

 단일 일회성 제품을 읽습니다.

list

 지정된 앱의 모든 일회성 제품을 나열합니다.

patch

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

오류 코드

이 리소스의 작업은 다음 HTTP 오류 코드를 반환합니다.

오류 코드 이유 해상도
5xx Google Play 서버의 일반 오류입니다. 요청을 다시 시도하세요.

문제가 계속되면 Google Play 계정 관리자에게 문의하거나 지원 요청을 제출하세요. Play 상태 대시보드에서 알려진 서비스 중단이 있는지 확인해 보세요.
409 동시 실행 업데이트 오류입니다.

업데이트 중인 객체를 업데이트하려고 시도했습니다. 예를 들어 Play 결제 라이브러리의 acknowledgePurchase() 메서드를 호출하고 Play Developer API의 purchases.products.acknowledge를 동시에 호출하여 구매를 확인합니다.

 요청을 다시 시도하세요.