REST Resource: inappproducts

리소스: InAppProduct

인앱 상품입니다. InappproductsService의 리소스입니다.

JSON 표현 
{
  "packageName": string,
  "sku": string,
  "status": enum (Status),
  "purchaseType": enum (PurchaseType),
  "defaultPrice": {
    object (Price)
  },
  "prices": {
    string: {
      object (Price)
    },
    ...
  },
  "listings": {
    string: {
      object (InAppProductListing)
    },
    ...
  },
  "defaultLanguage": string,
  "subscriptionPeriod": string,
  "trialPeriod": string,
  "gracePeriod": string,

  // Union field TaxAndComplianceType can be only one of the following:
  "subscriptionTaxesAndComplianceSettings": {
    object (SubscriptionTaxAndComplianceSettings)
  },
  "managedProductTaxesAndComplianceSettings": {
    object (ManagedProductTaxAndComplianceSettings)
  }
  // End of list of possible types for union field TaxAndComplianceType.
}
필드
packageName

string

상위 앱의 패키지 이름입니다.
sku

string

제품의 재고 관리 단위 (SKU)입니다. 앱 내에서 고유합니다.
status

enum (Status)

제품의 상태입니다(예: 활성 상태인지 여부).
purchaseType

enum (PurchaseType)

제품의 유형입니다(예: 반복 정기 결제).
defaultPrice

object (Price)

기본 가격입니다. 인앱 상품은 무료인 경우가 없으므로 0일 수 없습니다. 단위는 항상 개발자의 Checkout 판매자 계정 통화입니다.
prices

map (key: string, value: object (Price))

구매자 지역별 가격입니다. 인앱 상품은 무료인 경우가 없으므로 둘 다 0일 수 없습니다. map key는 지역 코드입니다. 지역 코드는 ISO 3166-2의 정의를 따릅니다.

"key": value 쌍 목록을 포함하는 객체입니다. 예: { "name": "wrench", "mass": "1.3kg", "count": "3" }
listings

map (key: string, value: object (InAppProductListing))

현지화된 제목 및 설명 데이터로 이루어진 inappproducts.list입니다. map key는 현지화된 데이터의 언어입니다. 언어는 BCP-47의 정의를 따릅니다(예 'en-US').

"key": value 쌍 목록을 포함하는 객체입니다. 예: { "name": "wrench", "mass": "1.3kg", "count": "3" }
defaultLanguage

string

현지화된 데이터의 기본 언어입니다. 언어는 BCP-47의 정의를 따릅니다(예: 'en-US').
subscriptionPeriod

string

ISO 8601 형식으로 지정된 정기 결제 기간입니다. 허용되는 값은 P1W (1주일), P1M (1개월), P3M (3개월), P6M (6개월), P1Y (1년)입니다.
trialPeriod

string

체험 기간입니다. ISO 8601 형식으로 지정됩니다. 허용되는 값은 P7D (7일)와 P999D (999일) 사이의 모든 값입니다.
gracePeriod

string

ISO 8601 형식으로 지정된 정기 결제 유예 기간입니다. 새 반복 기간에 대한 결제가 거부된 경우 개발자가 이 필드를 사용하여 구독자에게 유예 기간을 제공할 수 있습니다. 허용되는 값은 P0D (0일), P3D (3일), P7D (7일), P14D (14일), P30D (30일)입니다.

통합 필드 TaxAndComplianceType.

TaxAndComplianceType는 다음 중 하나여야 합니다.
subscriptionTaxesAndComplianceSettings

object (SubscriptionTaxAndComplianceSettings)

세금 및 법적 규정 준수에 관한 세부정보입니다. 정기 결제 제품에만 적용됩니다.
managedProductTaxesAndComplianceSettings

object (ManagedProductTaxAndComplianceSettings)

세금 및 법적 규정 준수에 관한 세부정보입니다. 관리 제품에만 적용됩니다.

상태

인앱 상품의 상태입니다.

열거형
statusUnspecified 미지정 상태입니다.
active 제품이 스토어에 게시되었으며 활성 상태입니다.
inactive 제품이 스토어에 게시되지 않았으며 비활성 상태입니다.

PurchaseType

제품 유형입니다.

열거형
purchaseTypeUnspecified 지정되지 않은 구매 유형입니다.
managedUser 기본 제품 유형인 일회성 구매입니다.
subscription 반복 기간이 있는 인앱 상품입니다.

InAppProductListing

단일 인앱 상품의 스토어 등록정보입니다.

JSON 표현 
{
  "title": string,
  "description": string,
  "benefits": [
    string
  ]
}
필드
title

string

스토어 등록정보의 제목입니다.
description

string

스토어 등록정보의 설명입니다.
benefits[]

string

정기 결제의 현지화된 사용 권한 혜택입니다.

ManagedProductTaxAndComplianceSettings

관리 제품의 세금 및 법적 규정 준수에 관한 세부정보입니다.

JSON 표현 
{
  "eeaWithdrawalRightType": enum (WithdrawalRightType),
  "taxRateInfoByRegionCode": {
    string: {
      object (RegionalTaxRateInfo)
    },
    ...
  },
  "isTokenizedDigitalAsset": boolean,
  "regionalProductAgeRatingInfos": [
    {
      object (RegionalProductAgeRatingInfo)
    }
  ],
  "productTaxCategoryCode": string
}
필드
eeaWithdrawalRightType

enum (WithdrawalRightType)

유럽 경제 지역 (EEA)에 있는 사용자에게 배포되는 제품의 디지털 콘텐츠 또는 서비스 분류입니다. EEA 소비자법의 철회 제도는 이 분류에 따라 달라집니다. 자세한 내용은 고객센터 도움말을 참고하세요.
taxRateInfoByRegionCode

map (key: string, value: object (RegionalTaxRateInfo))

지역 코드와 세율 세부정보 간의 매핑입니다. key는 지역 코드입니다. 지역 코드는 유니코드의 'CLDR' 정의를 따릅니다.

"key": value 쌍 목록을 포함하는 객체입니다. 예: { "name": "wrench", "mass": "1.3kg", "count": "3" }
isTokenizedDigitalAsset

boolean

이 인앱 상품이 토큰화된 디지털 애셋을 나타내는 제품으로 선언되었는지 여부입니다.
regionalProductAgeRatingInfos[]

object (RegionalProductAgeRatingInfo)

지역별 연령 등급 정보입니다. 현재 이 필드는 지역 코드 US에만 지원됩니다.
productTaxCategoryCode

string

인앱 상품에 할당할 제품 세금 카테고리 코드입니다. 제품 세금 카테고리에 따라 제품에 적용되는 거래 세율이 결정됩니다. 자세한 내용은 고객센터 도움말을 참고하세요.

메서드

batchDelete

 인앱 상품 (관리 제품 또는 정기 결제)을 삭제합니다.

batchGet

 여러 개의 인앱 상품을 읽어옵니다. 읽어오는 인앱 상품은 관리 제품 또는 정기 결제일 수 있습니다.

batchUpdate

 하나 이상의 인앱 상품 (관리 제품 또는 정기 결제)을 업데이트하거나 삽입합니다.

delete

 인앱 상품 (관리 제품 또는 정기 결제)을 삭제합니다.

get

 하나의 인앱 상품을 가져옵니다. 가져오는 인앱 상품은 관리 제품 또는 정기 결제일 수 있습니다.

insert

 인앱 상품 (관리 제품 또는 정기 결제)을 만듭니다.

list

 모든 인앱 상품(관리 제품과 정기 결제 모두)을 나열합니다.

patch

 인앱 상품 (관리 제품 또는 정기 결제)에 패치를 적용합니다.

update

 인앱 상품 (관리 제품 또는 정기 결제)을 업데이트합니다.

오류 코드

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

오류 코드 이유 설명 해상도
400 invalidValue 요청에 잘못된 값이 제공되었습니다. 잘못되었거나 유효하지 않은 구매 토큰에 대해 반환되는 경우가 많습니다. API 참조에 따라 요청 본문 또는 매개변수의 잘못된 필드 값을 수정합니다.
400 required 요청에 필수 필드 또는 매개변수가 누락되었습니다. API 문서를 참고하여 모든 필수 입력란과 매개변수가 포함되어 있는지 확인하세요.
403 userInsufficientPermission 사용자에게 요청된 작업을 수행할 수 있는 충분한 권한이 없습니다. 인증된 사용자에게 Google Play Console에서 필요한 권한이 있는지 확인합니다. 자세한 내용은 서비스 계정 사용을 참고하세요.
404 notFound 요청된 리소스를 찾을 수 없습니다. 식별자 (예: 구매 토큰, 패키지 이름, 제품 ID, 정기 결제 ID)가 올바른지 확인합니다.
409 concurrentUpdate 동시에 업데이트되고 있는 객체를 업데이트하려고 시도했습니다. 지수 백오프로 요청 재시도 동일한 리소스를 동시에 수정하지 마세요.
5xx Generic error Google Play 서버의 일반 오류입니다. 요청을 다시 시도하세요.

문제가 계속되면 Google Play 계정 관리자에게 문의하거나 지원 요청을 제출하세요. Play 상태 대시보드에서 알려진 서비스 중단이 있는지 확인해 보세요.