アウトバウンド マーケティングでイベント 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 アプリケーションの登録。