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,
  "regionalProductAgeRatingInfos": [
    {
      object (RegionalProductAgeRatingInfo)
    }
  ],
  "productTaxCategoryCode": string
}
フィールド
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

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

object (RegionalProductAgeRatingInfo)

地域別の年齢制限情報。現在、このフィールドはリージョン コード US でのみサポートされています。
productTaxCategoryCode

string

アプリ内アイテムに割り当てる商品の税金カテゴリ コード。商品の税金カテゴリは、商品に適用される取引税率を決定します。詳しくは、ヘルプセンターの記事をご覧ください。

メソッド

batchDelete

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

batchGet

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

batchUpdate

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

delete

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

get

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

insert

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

list

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

patch

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

update

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

エラーコード

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

エラーコード 理由 説明 解決策
400 invalidValue リクエストで無効な値が指定されました。多くの場合、これは形式が正しくないか無効な購入トークンに対して返されます。 API リファレンスに基づいて、リクエスト本文またはパラメータの無効なフィールド値を修正します。
400 required リクエストに必須のフィールドまたはパラメータがありません。 API のドキュメントを参照して、すべての必須フィールドとパラメータが含まれていることを確認します。
403 userInsufficientPermission リクエストされたオペレーションを実行する権限がユーザーにありません。 認証済みユーザーが Google Play Console で必要な権限を持っていることを確認します。詳細については、 サービス アカウントの使用をご覧ください。
404 notFound リクエストされたリソースが見つかりませんでした。 ID（購入トークン、パッケージ名、商品 ID、定期購入 ID など）が正しいことを確認します。
409 concurrentUpdate 同時に更新されているオブジェクトを更新しようとしました。 指数バックオフを使用してリクエストを再試行します。同じリソースへの同時変更は避けてください。
5xx Generic error Google Play サーバーの一般的なエラー。 リクエストを再試行してください。

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