管理対象アイテムの作成

Google Play の課金サービスを使用して、ユーザーに 1 回限りの請求を行うアプリ内アイテムを提供できます。これを「管理対象アイテム」と呼びます。管理対象アイテムでは、ゲームのレベルやポーションといった仮想アイテムや、Google Play で配信中のアプリ内でのプレミアム サービスなどのアイテムを提供できます。

重要: アプリ内アイテム(管理対象アイテムと定期購入を含む)には、Google Play デベロッパー プログラム ポリシー取引手数料が適用されます。

ご利用いただける国

販売者の登録がサポートされている国や地域では、Google Play の課金サービスをご利用いただけます。

サポートされている国や地域にお住まいで、アプリで Google Play の課金サービス機能を初めて使用する場合は、お支払いプロファイルを設定して、Google Play Billing API のドキュメントをご覧ください。

管理対象アイテムを作成すると、最新バージョンの Google Play ストアを使用しているユーザーが利用できるようになります。

必要な権限

管理対象アイテムを提供するには、アプリの APK マニフェスト ファイルで com.android.vending.BILLING 権限を宣言する必要があります。アプリをグローバルに配信する場合でも、com.android.vending.BILLING 権限を使用するアプリをすべての国で配信できます。

管理対象アイテムの作成

管理対象アイテムを 1 つ作成する

管理対象アイテムを作成する前に、商品 ID を慎重に設定してください。商品 ID はアプリに固有のものである必要があり、作成後に変更したり、再利用したりすることはできません。
  • 商品 ID は、先頭を必ず小文字の英字または数字とし、全体をアルファベットの小文字(a~z)、数字(0~9)、アンダースコア(_)、ピリオド(.)のみで構成する必要があります。
  • : android.test という商品 ID、および android.test で始まる商品 ID は使用できません。

管理対象アイテムを作成するには:

  1. Play Console にログインします。
  2. アプリを選択します。
  3. 左側のメニューで [ストアでの表示] > [アプリ内アイテム] をクリックします。
  4. 画面の右側で [管理対象アイテムを作成] をクリックします。
  5. アイテムの詳細を入力します。
    • タイトル: 「睡眠薬」など、アイテムの短い名前(最大 55 文字(半角相当)を入力できますが、常に正しく表示されるように 25 文字以内にすることをおすすめします)。
    • 説明: 「怪物を即時に眠らせる」など、アイテムの長い説明(80 文字(半角相当)以内)。
    • 価格: 現地通貨で価格を入力するか、価格設定テンプレートを選択します。
  6. [ステータス] の横にある [有効] または [無効] を選択します。
    • 購入できるようにするには、アイテムを有効にし、そのアプリを公開する必要があります。
    • テスト アカウントを使用している場合は、有効なアイテムを未公開アプリで利用できます。詳細については、Android デベロッパー サイトをご覧ください。
  7. [保存] をクリックします。

言語と翻訳

管理対象アイテムでは、アプリと同じデフォルトの言語を使用します。特定の言語の翻訳を追加するには、管理対象アイテムを選択して [翻訳を追加] をクリックします。アプリの翻訳についての詳細

複数の管理対象アイテムを一括で作成する

一度に複数の管理対象アイテムを作成するには、各アイテムの詳細を記述した CSV ファイルをアップロードします。
CSV ファイルでは、カンマ(,)やセミコロン(;)を使ってデータ値を区切ります。主要なデータ値はカンマで区切り、二次的な値はセミコロンで区切ります。
管理対象アイテムを記述する CSV ファイルを作成する場合は、最初の行に CSV の構文を指定し、次の行以降にアイテムの詳細を記述します。
重要: それぞれのアイテムについて、CSV ファイル内の 1 つの行にすべての情報を記述する必要があります。

管理対象アイテムの CSV ファイルをアップロードする

  1. Play Console にログインします。
  2. アプリを選択します。
  3. 左側のメニューで [ストアでの表示] > [アプリ内アイテム] をクリックします。
  4. [管理対象のアイテム] タブで、[インポート / エクスポート] > [管理対象アイテムを CSV ファイルからインポート] をクリックします。
    • アイテムリスト内の既存の管理対象アイテムを上書きするには、[既存のアイテムを上書きする] チェックボックスをオンにします。オンにすると、CSV ファイル内の Product ID とアイテムリスト内の既存の管理対象アイテムの Product ID の値が一致する場合にのみ、既存のアイテムが上書きされます。アイテムの上書きによって、CSV に含まれていない管理対象アイテムが削除されることはありません。
  5. [ファイルを選択] をクリックし、CSV ファイルを選択します。

既存の管理対象アイテムの CSV ファイルを書き出す

Play Console で 1 件ずつ作成した管理対象アイテムがある場合は、CSV ファイルを書き出すことで、アイテムの作成を CSV ファイルを使って簡単に開始できます。

  1. Play Console にログインします。
  2. アプリを選択します。
  3. 左側のメニューで [ストアでの表示] > [アプリ内アイテム] をクリックします。
  4. [管理対象のアイテム] タブで、[インポート / エクスポート] > [アプリ内アイテムを CSV ファイルにエクスポート] をクリックします。

CSV ファイルの例を確認する

使用する CSV 構文と管理対象アイテムの 3 つの例を以下に示します。
  • 最初の例では、タイトルと説明を 2 つの言語(en_USes_ES)で指定しています。アイテムの価格は価格設定テンプレートで定義しています。
  • 2 番目の例では価格設定テンプレートを使用しません。代わりに、デフォルトの国(米国)の価格を指定しています。Play Console によって、現在の為替レートと現地の一般的な価格の付け方を使用して、アプリを配信する他のすべての国での価格が自動的に設定されます。
  • 2 番目の例でも価格設定テンプレートを使用しません。アイテムの価格は、アプリを配信する国ごとに手動で指定します。

CSV 構文の例

Product ID,Published State,Purchase Type,Auto Translate,Locale; Title; Description,Auto Fill Prices,Price,Pricing Template ID

管理対象アイテムの例

例 1

basic_sleeping_potion,published,managed_by_android,false,en_US; Basic Sleeping Potion; Puts small creatures to sleep.; es_ES; Poción básica de dormir; Causa las criaturas pequeñas ir a dormir.,false,,4637138456024710495

例 2

standard_sleeping_potion, published,managed_by_android,false,en_US; Standard Sleeping Potion; Puts all creatures to sleep for 2 minutes.,true, 1990000,

例 3

invisibility_potion,published, managed_by_android,false,en_US; Invisibility Potion; Invisible to all enemies for 5 minutes.,false, US; 1990000; BR; 6990000; RU; 129000000; IN; 130000000; ID; 27000000000; MX; 37000000;

CSV ファイルのデータ値

管理対象アイテムの CSV ファイルの各行には、以下の値を含めることができます。ただし、各行において、こうした値のなかで定義しないものが 1 つ以上あります。
Product ID

CSV ファイルでこの値を設定すると、新しい管理対象アイテムの作成時に商品 ID を入力するのと同じ働きになります。

すでにアイテムリストに存在する管理対象アイテムに割り当てられている Product ID を指定した場合、[アプリ内アイテムのインポート] ダイアログで [既存のアイテムを上書きする] チェックボックスがオンになっていると、該当する既存の管理対象アイテムのデータが CSV ファイルに指定した値で上書きされます。

Publish State この値には published または unpublished を設定する必要があります。これは、管理対象アイテムを [有効] または [無効] に設定するのと同じ働きになります。
Purchase Type

この値には managed_by_android を設定する必要があります。

Auto Translate

管理対象アイテムの詳細の自動翻訳はサポートされていないため、この値には false を設定する必要があります。

管理対象アイテムのタイトルや説明の翻訳を提供する場合は、該当する翻訳を Locale の値として明示的に指定します。

LocaleTitleDescription

アイテムの言語 / 地域を 1 つだけ含める場合は、以下のように、アプリのデフォルトの言語 / 地域と、アイテムのデフォルトのタイトルと説明を指定する必要があります。

app_default_locale; item_default_title; item_default_description;

Locale の値を設定する際は、ストアの掲載情報の翻訳を追加するときに表示される言語コードを使用できます。

: TitleDescription の値を指定する際は、バックスラッシュを使用してセミコロン(\;)およびバックスラッシュ文字(\\)をエスケープします。

アイテムのタイトルや説明の翻訳を含める場合は、デフォルトの言語 / 地域、タイトル、説明を指定した後で、それぞれの翻訳ごとに言語 / 地域、タイトル、説明を指定する必要があります。以下の例では、管理対象アイテムのデフォルトの言語 / 地域として en_US(英語(米国))を使用し、翻訳として es_ES(スペイン語(スペイン))を使用します。

en_US; Invisibility Cloak; Makes you invisible.; es_ES; Capote Invisible; Se vuelven invisible.

: アプリにはデフォルトの言語が 1 つありますが、各管理対象アイテムの翻訳は独立して管理されます。各アイテムの Locale の値で最初に指定する言語 / 地域は CSV ファイル全体で同じにする必要がありますが、それ以外の言語 / 地域はアイテムごとに違っていても問題ありません。

Auto Fill PricesCountryPrice

Auto Fill Pricestrue または false に設定できます。管理対象アイテムで価格設定テンプレートを使用する場合は、Auto Fill Pricesfalse を設定したうえで、Price には値を設定しないようにする必要があります。

: CSV ファイルでアイテムの価格を指定する際は、価格をマイクロ単位で指定します。その場合、1,000,000 マイクロ単位が実際の通貨の 1 単位に相当します。

価格の自動換算を使用する

以下のセクションでは、Auto Fill Prices の値が CountryPrice の値の構文と意味にどう影響するかについて説明します。

Auto Fill Pricestrue を設定する場合は、アイテムのデフォルトの価格のみを指定し、Country の値は含めません。

たとえば、以下の条件があるとします。

  • アプリのデフォルトの言語 / 地域は en_US です。
  • 管理対象アイテムのデフォルトの価格(税抜)は $1.99 です。
  • 他の国での価格には自動換算を使用します。

この場合、CSV ファイルの行の最後で Auto Fill PricesPrice の値として、true,1990000, と指定します。

国ごとに独自の価格を設定する

Auto Fill Pricesfalse を設定する場合は、アプリを配信するすべての国(アプリのデフォルトの言語 / 地域に対応する国を含む)について、それぞれ CountryPrice の値を指定できます。Country の値にはそれぞれ、アプリを配信する国を表す英大文字 2 文字の ISO 国コードを指定します。

: アプリを配信する国ごとに、国コードと価格を指定する必要があります。アプリを配信する国の一覧は、[価格と販売 / 配布地域] ページで表示、編集できます。

Price の値は、アイテムの価格を、その国で使用されている通貨のマイクロ単位で表したものです。

たとえば、他の国でアプリを以下の価格(すべて税込)で提供するとします。

  • ブラジル: R$6.99
  • ロシア: 129 ₽
  • インド: ₹130
  • インドネシア: Rp 27,000
  • メキシコ: $37

この場合、CSV ファイルの行の最後で Auto Fill PricesCountryPrice の値を以下のように設定できます。

false, BR; 6990000; RU; 129000000; IN; 130000000; ID; 27000000000; MX; 37000000;

Pricing Template ID

アイテムが価格設定テンプレートにリンクしている場合は、Auto Fill Pricesfalse を設定したうえで、Price 列には値を設定しないでください。アイテムが価格設定テンプレートにリンクしていない場合は、Pricing Template ID には値を設定しないでください。代わりに、管理対象アイテムの価格をどう設定するかに基づいて、Auto Fill PricesCountryPrice を設定する必要があります。

CSV ファイルをインポートする場合、[アプリ内アイテムのインポート] ダイアログで [既存のアイテムを上書きする] チェックボックスをオンにしておくと、管理対象アイテムと価格設定テンプレートとの間のリンクを更新できます。アイテムを特定の価格設定テンプレートにリンクするには、Pricing Template ID の値にその価格設定テンプレートの ID を設定します。管理対象アイテムとすべての価格設定テンプレートとの間のリンクを解除する場合は、Pricing Template ID に値を設定しません。

1 つの価格設定テンプレートに対して、アプリの価格や管理対象アイテムの価格を最大 1,000 件リンクできます。そのため、CSV ファイルで 1,000 を超える行に同じ Pricing Template ID の値を指定しないでください。

関連コンテンツ

この記事は役に立ちましたか?
改善できる点がありましたらお聞かせください。