次の方法で共有


アウトバウンド マーケティングでイベント API を使用する

注意

Dynamics 365 Marketing と Dynamics 365 Customer Insights は Customer Insights - Journeys と Customer Insights - Data になりました。 詳細については、Dynamics 365 Customer Insights のよくあるご質問 をご覧ください

Customer Insights - Journeys の新しい顧客には、リアルタイム体験機能のみが提供されます。 詳細については、既定のリアルタイム体験のインストールを参照してください。

重要

この記事は、2025年6月30日に製品から削除される予定の アウトバウンド マーケティング にのみ適用されます。 中断を避けるため、この日付より前にリアルタイムの旅程に移行してください。 詳細情報: 移行の概要

イベント API は、イベント、セッション、セッション トラック、パス、スピーカー、スポンサーシップのデータにアクセスするためのプログラムによる方法です。 また、それを使用してイベントやセッションに登録できます。

スキーマ

API アクセスは HTTPS プロトコル経由で行われ、Web アプリケーション トークンの作成中に受け取った API エンドポイントからアクセスされます。 すべてのデータは JSON として送受信されます。

空白のフィールドは、省略されずに null として含まれます。

エンドポイント

すべての顧客は独自のエンドポイント URL を持ちます。 イベント API のエンドポイント URL は 2 つの部分で構成されています:

  • エンドポイント ドメイン
  • サブディレクトリ

Web アプリケーション トークンを作成した後、ルート エンドポイントを取得します。 Web アプリケーション トークンの作成方法については、こちらを参照してください: Web アプリケーションの登録

ルート エンドポイントの例

https://b7c1ad1ab7fa4a7482b16315d94a26af.svc.dynamics.com 

サブディレクトリは常に EvtMgmt/api で始まり、その後に API のバージョンが続きます (それは、ここから利用可能な API ドキュメントから取得できます: イベント管理 API リファレンスのドキュメント

サブディレクトリの例

EvtMgmt/api/v2.0/ 

完全なエンドポイント URL の例

https://b7c1ad1ab7fa4a7482b16315d94a26af.svc.dynamics.com/EvtMgmt/api/v2.0/ 

認証

イベント API を使用するには、各リクエストごとに URL パラメーターとして web application token を提供する必要があります。 Web アプリケーション トークンが組織に関連付けられるコントロール API 要求に使用されます。 Web アプリケーションを作成および取得する方法の詳細は Web アプリケーションの登録 を参照してください。

web application token は、emApplicationtoken と呼ばれる URL パラメータを追加することで要求に追加できます。

https://b7c1ad1ab7fa4a7482b16315d94a26af.svc.dynamics.com/EvtMgmt/api/v2.0/events/published?emApplicationtoken=B7vdzdhCiLt9c5iT….

さらに、リクエストの送信元は、Web アプリケーション トークンの作成時に指定したものと同じである必要があります。

Web アプリケーション トークンまたはオリジン ヘッダーを指定しない場合、イベント API は HTTP 400 Bad Request を返します。

Web アプリケーション トークンが無効の場合、イベント API は HTTP 401 Unauthorized を返します。

Web アプリケーションの登録

イベント API を使用するには、各リクエストごとに Web アプリケーション トークンを指定する必要があります。 Web アプリケーション トークンが組織に関連付けられるコントロール API 要求に使用されます。 詳細: 独自の Web アプリケーションの登録