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 は指定できません。マップキーは、ISO 3166-2 形式の地域コードです。

"key": value ペアのリストを含むオブジェクト。例: { "name": "wrench", "mass": "1.3kg", "count": "3" }
listings

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

ローカライズされたタイトルと説明のデータを含む inappproducts.list。マップキーは、ローカライズされたデータの言語です（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 デフォルトのアイテムタイプ - 1 回だけの購入。
subscription 繰り返し期間のあるアプリ内アイテム。

InAppProductListing

1 つのアプリ内アイテムに関するストアの掲載情報。

JSON 表現 
{
  "title": string,
  "description": string,
  "benefits": [
    string
  ]
}
フィールド
title

string

ストアの掲載情報のタイトル。
description

string

ストアの掲載情報の説明。
benefits[]

string

定期購入に関してローカライズされた利用資格の特典。

ManagedProductTaxAndComplianceSettings

管理対象アイテムの税と法令遵守に関する詳細。

JSON 表現 
{
  "eeaWithdrawalRightType": enum (WithdrawalRightType),
  "taxRateInfoByRegionCode": {
    string: {
      object (RegionalTaxRateInfo)
    },
    ...
  },
  "isTokenizedDigitalAsset": boolean
}
フィールド
eeaWithdrawalRightType

enum (WithdrawalRightType)

欧州経済領域（EEA）内のユーザーに配信されるアイテムがデジタル コンテンツかサービスかの分類。EEA の消費者法に基づく取消権は、この分類によって異なります。詳しくは、ヘルプセンターの記事をご覧ください。
taxRateInfoByRegionCode

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

地域コードと税率情報のマッピング。キーは Unicode の「CLDR」で定義されている地域コードです。

"key": value ペアのリストを含むオブジェクト。例: { "name": "wrench", "mass": "1.3kg", "count": "3" }
isTokenizedDigitalAsset

boolean

このアプリ内アイテムが、トークン化されたデジタル資産を表すアイテムとして宣言されているかどうか。

メソッド

batchDelete

 アプリ内アイテム（管理対象アイテムまたは定期購入）を削除します。

batchGet

 複数のアプリ内アイテム（管理対象アイテムまたは定期購入）を読み取ります。

batchUpdate

 1 つ以上のアプリ内アイテム（管理対象アイテムまたは定期購入）を更新または挿入します。

delete

 アプリ内アイテム（管理対象アイテムまたは定期購入）を削除します。

get

 アプリ内アイテム（管理対象アイテムまたは定期購入）を取得します。

insert

 アプリ内アイテム（管理対象アイテムまたは定期購入）を作成します。

list

 アプリ内アイテム（管理対象アイテムおよび定期購入）を一覧表示します。

patch

 アプリ内アイテム（管理対象アイテムまたは定期購入）にパッチを適用します。

update

 アプリ内アイテム（管理対象アイテムまたは定期購入）を更新します。

エラーコード

このリソースのオペレーションは、次の HTTP エラーコードを返します。

エラーコード 理由 解決策
5xx Google Play サーバーの一般的なエラー。 リクエストを再試行してください。

問題が解決しない場合は、Google Play アカウント マネージャーにお問い合わせいただくか、サポート リクエストを送信してください。Google Play ステータス ダッシュボードで、既知のサービス停止がないか確認してください。
409 同時実行更新エラー。

更新中のオブジェクトを更新しようとしました。たとえば、Play Billing Library の acknowledgePurchase() メソッドを呼び出すと同時に、Play Developer API の purchases.products.acknowledge を呼び出すことで、購入が承認されます。

 リクエストを再試行してください。