- Publishing API を使用してアイテムを一括管理する
- 価格設定テンプレートを使用して価格を一括管理する
- Google Play Console を使用してアイテムを個別に管理する
Google Play の課金システムを使用すると、ユーザーに 1 回限りの請求を行うアプリ内アイテムを提供できます。アプリ内アイテムとしては、Google Play のアプリ内における仮想アイテム（ゲームのレベルやポーションなど）、有料サービスがあります。
ユーザーに定期的に請求を行う定期購入を作成することもできます。
重要: アプリ内アイテムと定期購入には、Google Play デベロッパー プログラム ポリシーとサービス手数料が適用されます。
提供状況
Google Play の課金システムは、販売者の登録がサポートされている国や地域でご利用になれます。
サポート対象の国 / 地域にお住まいで、ご自身のアプリで Google Play の課金システム機能を初めて使用する場合は、お支払いプロファイルを設定し、デベロッパー向け Android のサイトで Google Play の課金システムの設定方法をご確認ください。
アプリ内アイテムを購入可能にするには、そのアプリ内アイテムを有効にし、アプリをユーザーの国 / 地域に配信する必要があります。アプリ内アイテムは、アプリが非公開であっても、有効である限り購入可能です。アプリ内アイテムを入手できないようにするには、無効にする必要があります。
テスト アカウントをお使いの場合は、デベロッパー向け Android のサイトで Google Play Billing Library 統合のテスト方法をご確認ください。
作成したアプリ内アイテムは、Google Play ストアの最新版を使用しているユーザーが入手できるようになります。
注: Google Play Console でこの設定を行うと、カート放棄リマインダー機能の一環として、ユーザーがアプリ内ではなく、Google Play ストアのゲームホームから直接 SKU を購入できるようになります。この機能は、以前に中断した購入を完了するようユーザーに促すものです（アプリ外で行われた購入について詳しくは、こちらをご覧ください）。この機能は、すべてのデベロッパーに対してデフォルトでオンになっています。
アプリのカートの放棄リマインダー機能を無効にするには、こちらのフォームにご記入ください。
必要な権限
アプリ内アイテムを提供するには、アプリの APK マニフェスト ファイルで com.android.vending.BILLING 権限を宣言する必要があります。アプリをグローバルに配信する場合、すべての国で com.android.vending.BILLING 権限を指定して、アプリを公開できます。
アプリ内アイテムを作成する
アプリ内アイテムを 1 つ作成する
- アイテム ID は、先頭を必ず数字または英小文字とし、全体を数字（0～9）、小文字（a～z）、アンダースコア（_）、ピリオド（.）のみで構成します。
- アイテムを作成した後でアイテム ID を変更したり再利用したりすることはできません。
- 注:
android.testというアイテム ID や、android.testで始まるアイテム ID はすべて使用できません。
アプリ内アイテムを作成するには:
- Google Play Console を開きます。
- [アプリ内アイテム] ページ（[Google Play で収益化する] > [商品] > [アプリ内アイテム]）に移動します。
- [アイテムを作成] をクリックします。
- アイテムの詳細を入力します。
- アイテム ID: アプリ内アイテムの一意の ID。
- タイトル: 「睡眠薬」など、アイテムの短い名前（最大半角 55 文字（全角 27 文字）を入力できますが、常に正しく表示されるように半角 25 文字（全角 12 文字）以内にすることをおすすめします）。
- 説明: 「怪物を即時に眠らせる」など、アイテムの長い説明（半角 200 文字、全角 100 文字まで）。
- アイコン: アイテムに固有で正確な画像。テキスト、プロモーション、ブランディングは含めないでください。アイテムのアイコンは、ストアの掲載情報と購入フローで表示されます。
- 32 ビット PNG
- 512 x 512 ピクセル
- 1 MB 以下
- 価格: デベロッパーの現地通貨で価格を入力するか、価格設定テンプレートを選択します。
- 複数数量: このアイテムで複数数量のご購入手続きを行えるようにします。ユーザーの国 / 地域のしきい値内で複数数量を購入できます。次の点にご注意ください。
- Google Play Console で複数数量のご購入手続きを設定するには、アプリに Google Play Billing Library 4.0 が必要です。Google Play Billing Library をアプリに統合する方法については、デベロッパー向け Android のサイトをご覧ください。
- 複数数量のご購入手続きは一部の国 / 地域ではご利用いただけません
- 複数数量のご購入手続きが可能なほとんどの国 / 地域では、SKU の価格しきい値はおよそ USD 100 です。複数数量のご購入手続きを行えるようにするには、各国 / 地域のしきい値を下回るように価格（税抜き）を調整する必要があります。
- Play Points 限定: Google Play Points でのみアイテムを入手できるようにします。
- 変更を保存し、[有効にする] をクリックして、ユーザーがアプリ内アイテムを入手できるようにします。
言語と翻訳
アプリ内アイテムは、アプリと同じデフォルト言語を使用します。特定の言語での翻訳を追加するには、アプリ内アイテムを選択して、[翻訳を管理] をクリックし、目的の言語を適用します。ローカライズ版をユーザーに提供する方法について詳しくは、アプリの翻訳とローカライズをご覧ください。
複数のアプリ内アイテムを一括して作成する
- Publishing API を使用してアイテムを一括管理する
- 価格設定テンプレートを使用して価格を一括管理する
- Google Play Console を使用してアイテムを個別に管理する
アプリ内アイテムの CSV ファイルをアップロードする
CSV ファイルをアップロードするには:
- Google Play Console を開きます。
- [アプリ内アイテム] ページ（[Google Play で収益化する] > [商品] > [アプリ内アイテム]）に移動します。
- [インポート] をクリックします。
- CSV ファイルをアップロードすることで複数のアイテムをインポートすると、CSV ファイル内の
Product IDの値が、アプリ内アイテムリストの既存のProduct IDと一致する場合にのみ、既存のアイテムが上書きされます。アイテムが上書きされる場合でも、CSV に含まれていないアプリ内アイテムが削除されることはありません。
- CSV ファイルをアップロードすることで複数のアイテムをインポートすると、CSV ファイル内の
- アップロードする CSV ファイルをドロップするか、[アップロード] をクリックします。
既存のアプリ内アイテムの CSV ファイルをエクスポートする
CSV ファイルをエクスポートするには:
- Google Play Console を開きます。
- [アプリ内アイテム] ページ（[Google Play で収益化する] > [商品] > [アプリ内アイテム]）に移動します。
- [エクスポート] をクリックします。
CSV ファイルの例を確認する
- 最初の例では、タイトルと説明を 2 つの言語（
en_USとes_ES）で指定しています。アイテムの価格は価格設定テンプレートで定義しています。 - 2 番目の例では価格設定テンプレートを使用しません。代わりに、デフォルトの国（米国）の価格を指定しています。Google Play Console によって、現在の為替レートと現地の一般的な価格の付け方に基づき、アプリを配信する他のすべての国での価格が自動的に設定されます。
- 3 番目の例でも価格設定テンプレートを使用しません。アイテムの価格は、アプリを配信する国ごとに手動で指定しています。
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 ファイルのデータ値
Product ID |
CSV ファイルでこの値を設定すると、新しいアプリ内アイテムの作成時にアイテム ID を入力するのと同じ働きになります。 すでにアイテムリストに存在するアプリ内アイテムに割り当てられている |
Publish State |
この値には published または unpublished を設定する必要があります。これは、アプリ内アイテムを [有効] または [無効] に設定することと同じです。 |
Purchase Type |
この値には |
Auto Translate |
アプリ内アイテムの詳細の自動翻訳はサポートされていないため、この値は アプリ内アイテムのタイトルや説明の翻訳を提供する場合は、該当する翻訳を |
|
|
アイテムの言語 / 地域を 1 つだけ含める場合は、以下のように、アプリのデフォルトの言語 / 地域と、アイテムのデフォルトのタイトルと説明を指定する必要があります。
注: アイテムのタイトルや説明の翻訳を含める場合は、デフォルトの言語 / 地域、タイトル、説明を指定した後で、翻訳ごとに言語 / 地域、タイトル、説明を指定する必要があります。次の例では、アプリ内アイテムのデフォルトの言語 / 地域として
注: アプリごとにデフォルト言語は 1 つですが、アプリ内アイテムの翻訳はそれぞれ独立して管理されます。各アイテムの |
Auto Fill Prices、Country、Price |
注: CSV ファイルで指定するアイテムの価格は、マイクロ単位で指定します。その場合、1,000,000 マイクロ単位が実際の通貨の 1 単位に相当します。 価格の自動換算を使用する 以下のセクションでは、
たとえば、以下の条件があるとします。
この場合、CSV ファイルの行の最後で 国ごとに独自の価格を設定する
注: アプリを配信する国ごとに、国コードと価格を指定する必要があります。アプリを配信する国の一覧は、[製品版] ページの [国 / 地域] タブで確認、編集できます。
たとえば、他の国でアプリを以下の価格（すべて税込）で提供するとします。
この場合、CSV ファイルの行の最後で
|
Pricing Template ID |
アイテムが価格設定テンプレートにリンクしている場合は、 CSV ファイルをインポートする場合、アプリ内アイテムと価格設定テンプレートのリンクを更新できます。アイテムを特定の価格設定テンプレートにリンクするには、 各価格設定テンプレートに、最大 1,000 件までアプリの価格またはアプリ内アイテムの価格を設定できます。したがって、CSV ファイルで 1,000 を超える行に同じ |
|
|
欧州経済領域（EEA）のユーザーに配信する場合は、値を DIGITAL_CONTENT または SERVICE に設定します。 |
|
|
複数の国 / 地域でデジタル版のニュース、雑誌、新聞、書籍、動画、音楽、音声、オーディオブックを販売するデベロッパーは、VAT 軽減税率の対象となることがあります。 このフィールドでは軽減税率の値を次の形式で入力します。 CountryCode;VATRate; 国と税率のペアを追加する場合は、それぞれの国と税率のペアをセミコロンで区切ります。 次に例を示します。
BOOKS_1、NEWS_1、NEWS_2、MUSIC_OR_AUDIO_1、LIVE_OR_BROADCAST_1（大文字または小文字）として設定できます。 |
|
|
該当する州の通信税と遊興税を徴収する場合は、対象のアプリやアイテムがストリーミング サービスであることを指定し、このフィールドを 現在、この種の税金が認められている国は米国のみです。 このフィールドの値は常に次のように設定します。 CountryCode;Eligibility;Rate 次に例を示します。
対象となる場合は、次のカテゴリに基づいてフィールドを設定できます。
AUDIO_MULTI_CHANNEL: 音声ストリーミング - マルチチャンネル |