次の方法で共有

Microsoft コマーシャル マーケットプレースの SaaS フルフィルメント API

  • [アーティクル]

SaaS Fulfillment API を使用すると、発行元 (独立系ソフトウェア ベンダー (ISV) とも呼ばれます) は、Microsoft AppSource、Azure Marketplace、および Azure portal で SaaS アプリケーションを発行および販売できます。 これらの API を使用すると、ISV アプリケーションは、ダイレクト、パートナー主導 (リセラー)、フィールド主導のすべてのコマース対応チャネルに参加できます。 これらの API との統合は、パートナー センターで取引可能な SaaS オファーを作成して発行するための要件です。

SaaS フルフィルメント API の詳細については、次の記事も参照することをお勧めします。

API フロー

ISV と Microsoft の両方で同じサブスクリプションの状態を維持するために、ISV が SaaS サービス コードに追加して、次の API フローを実装する必要があります。

  • ランディング ページ フロー: Microsoft は、パブリッシャーの SaaS オファーがマーケットプレースの顧客によって購入されたことをパブリッシャーに通知します。
  • アクティブ化フロー: パブリッシャーは、新しく購入した SaaS アカウントがパブリッシャー側で構成されたことを Microsoft に通知します。
  • 更新フロー: 購入プランの変更、または購入したシートの数、またはその両方。
  • フローを中断して再開する: 顧客の支払い方法が無効になった場合に備え、購入した SaaS オファーを中断します。 支払い方法に関する問題が解決されると、中断されたオファーを元に戻すことができます。
  • Webhook フロー: Microsoft は、顧客によってトリガーされた SaaS サブスクリプションの変更と取り消しについて、Microsoft 側からパブリッシャーに通知します。

購入した SaaS サブスクリプションの取り消しについては、Microsoft 側から顧客が行うことができるため、統合は省略可能です。

SaaS Fulfillment API との正しい統合は、次の点を確認するために重要です。

  • 発行元の SaaS オファーを購入したエンド カスタマーは、Microsoft によって正しく課金されます。
  • エンド カスタマーは、マーケットプレースで購入した SaaS サブスクリプションの購入、構成、使用、管理に関する適切なユーザー エクスペリエンスを得ています。

これらの API を使用すると、パブリッシャーのオファーがすべてのコマース対応チャネルに参加できるようになります。

  • 直接
  • パートナー主導 (リセラー、クラウド ソリューション プロバイダー [CSP])
  • フィールド主導

リセラー (CSP) シナリオでは、CSP がエンド カスタマーに代わって SaaS オファーを購入しています。 顧客は SaaS オファーを使用することが期待されますが、CSP は次のタスクを実行するエンティティです。

  • 顧客に請求する
  • サブスクリプション プラン/購入したシートの量を変更する
  • サブスクリプションを取り消します

パブリッシャーは、このシナリオで異なる方法で API 呼び出しフローを実装する必要はありません。

詳細については、「クラウド ソリューション プロバイダー (CSP)」を参照してください。

重要

SaaS Fulfillment API バージョン 1 は非推奨になりました。代わりに、V2 を使用します。 V1 は現在、既存のパブリッシャーにサービスを提供するためにのみ保守されており、V1 のドキュメントは使用できなくなりました。 あなたがそれにアクセスする必要があると感じるなら、あなたは saas-api-v1@microsoft.com電子メールを送ることができます.

手記

SaaS フルフィルメント API は、パブリッシャーのバックエンド サービスからのみ呼び出すことを目的としています。 パブリッシャーの Web ページから直接 API との統合はサポートされていません。 サービス間認証フローのみを使用する必要があります。

関連コンテンツ

  • まだ登録していない場合は、「Microsoft Entra アプリケーションの登録」で説明されているように、Azure portal に SaaS アプリケーションを登録します。
  • その後、開発には、このインターフェースの最新バージョンを使用します。SaaS Fulfillment サブスクリプション API v2 と、そして SaaS Fulfillment Operations API v2 とをご利用ください。

ビデオ チュートリアル

  • .NET 用 SaaS クライアント ライブラリ