アプリ内購入を構成する
アプリ内購入は、ユーザーがアプリ内の無料プランから有料プランにアップグレードできるアップグレード オプションです。 Microsoft Teamsは、アプリ内購入を実装するための API を提供します。 アプリ内購入オプションは、アプリが取引可能な SaaS オファーで有効になっている場合にのみ適用されます。
ユーザーは、アプリ内購入を通じて新しい有料サブスクリプションを購入できます。 ただし、既存の有料サブスクリプションで追加または異なるライセンスを購入することはできません。 プランを変更するには、アプリ内購入を通じて新しいプランを取得する前に、ユーザーが現在のサブスクリプションを取り消す必要があります。
注:
アプリ内購入は、 個人用アプリ コンテキストでのみサポートされます。
アプリ内購入の実装
アプリ ユーザーのアプリ内購入エクスペリエンスを容易にするには、次の前提条件が満たされていることを確認します。
アプリは、 Microsoft Teams JavaScript クライアント ライブラリ (TeamsJS) を使用してビルドされます。
アプリは、取引可能な SaaS オファーで有効になっています。
アプリは RSC アクセス許可で有効になっています。
アプリは、
openPurchaseExperience
API を使用して呼び出されます。
アプリ内購入をアクティブ化する
アプリ内購入エクスペリエンスは、次のいずれかの方法でアクティブ化できます。
開発者ポータルからの更新
- Teams 開発者ポータルで、[ アクセス許可] に移動します。
- [ アプリ内購入オファーの表示] を有効にします。
マニフェストを更新する
アプリ内購入エクスペリエンスを有効にするには、RSC アクセス許可を追加して Teams アプリmanifest.json
ファイルを更新します。 これにより、アプリ ユーザーは有料バージョンのアプリにアップグレードし、新機能にアクセスできます。 次のコード スニペットに示すように、アプリ マニフェストを更新します。
"authorization": {
"permissions": {
"resourceSpecific": [
{
"name": "InAppPurchase.Allow.User",
"type": "Delegated"
}
]
}
}
購入エクスペリエンス API
アプリのアプリ内購入をトリガーするには、Web アプリから openPurchaseExperience
API を呼び出します。 次のコード スニペットは、TeamsJS を使用してビルドされた Teams アプリから API を呼び出す例です。
<div>
<div class="sectionTitle">openPurchaseExperience</div>
<button onclick="openPurchaseExperience()">openPurchaseExperience</button>
</div>
</body>
<script>
function openPurchaseExperience() {
micorosftTeams.app.initialize();
var planInfo = {
planId: "<Plan id>", // Plan Id of the published SAAS Offer
term: "<Plan Term>" // Term of the plan.
}
monetization.openPurchaseExperience(planInfo);
}
</script>
関連項目
Platform Docs