Dynamics 365 Customer Insights (プレビュー)
Dynamics 365 Customer Insights connector は、Dynamics 365 Customer Insights インスタンスと対話するための一連の API を提供します。
このコネクタは、次の製品および地域で利用可能です:
| Service | クラス | 地域 |
|---|---|---|
| Logic Apps | 標準 | 以下を除くすべての Logic Apps 地域 : - Azure China の地域 - 米国国防総省 (DoD) |
| Power Automate | プレミアム | 以下を除くすべての Power Automate 地域 : - US Government (GCC High) - 21 Vianet が運用する中国のクラウド - 米国国防総省 (DoD) |
| Power Apps | プレミアム | 以下を除くすべての Power Apps 地域 : - US Government (GCC High) - 21Vianet が運用する中国のクラウド - 国防総省 (DoD) |
| 連絡先 | |
|---|---|
| 件名 | Microsoft |
| URL | Microsoft LogicApps サポート Microsoft Power Automate サポート Microsoft Power Apps サポート |
| コネクタ メタデータ | |
|---|---|
| 公開元 | Microsoft |
Dynamics 365 Customer Insights にサインアップするには、ここをクリックしてください。
Power Apps でこのコネクタを使用するには、ここで詳細をご覧ください。
調整制限
| 名前 | 呼び出し | 更新期間 |
|---|---|---|
| 接続ごとの API 呼び出し | 100 | 60 秒 |
アクション
| アイテムの作成 (プレビュー) |
この操作では、エンティティのアイテムを作成します |
| アイテムの更新 (プレビュー) |
この操作では、エンティティのアイテムを更新します |
| エンティティから項目を取得する |
この操作では、エンティティから項目を取得します。 エンティティに応じて、フィールドはフィルターとして定義できます:
|
| エンティティのパーティションを取得します (プレビュー) |
エンティティのパーティションを取得します。 |
| エンティティのパーティションを取得する (V2) (プレビュー) |
エンティティのパーティションを取得します (V2)。 |
| エンティティを取得 |
この操作では、インスタンスからエンティティを取得します |
| パーティションからデータを取得します (プレビュー) |
パーティションからデータを取得します。 |
| 状態レポート V2 を送信する |
状態レポート V2 を送信します。 |
| 状態レポートの送信 |
状態レポートを送信します。 |
| 項目を取得する |
この操作では、エンティティから項目を取得します |
アイテムの作成 (プレビュー)
この操作では、エンティティのアイテムを作成します
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
InstanceId
|
dataset | True | string |
インスタンスの識別子 |
|
entityName
|
table | True | string |
エンティティの名前 |
|
recordItem
|
item | True | dynamic |
作成するレコード |
アイテムの更新 (プレビュー)
この操作では、エンティティのアイテムを更新します
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
InstanceId
|
dataset | True | string |
インスタンスの識別子 |
|
entityName
|
table | True | string |
エンティティの名前 |
|
itemIdentifier
|
id | True | string |
項目の識別子 |
|
recordItem
|
item | True | dynamic |
更新するレコード |
戻り値
エンティティから項目を取得する
この操作では、エンティティから項目を取得します。 エンティティに応じて、フィールドはフィルターとして定義できます:
- UnifiedActivity エンティティ: ActivityId および CustomerId フィールド
- Customer エンティティ: Customer Insights インスタンスでインデックス付けされた CustomerId フィールドおよびその他のフィールド
- その他のエンティティ: CustomerId フィールド。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
instanceId
|
dataset | True | string |
インスタンスの識別子 |
|
entityName
|
table | True | string |
エンティティの名前 |
|
フィルター クエリ
|
$filter | string |
返されるエントリを制限する ODATA フィルター クエリです (例: stringColumn eq 'string' OR numberColumn lt 123)。 |
|
|
上位カウント
|
$top | integer |
取得するエントリの合計数です (既定値 = すべて)。 |
|
|
クエリを選択する
|
$select | string |
エントリから取得する特定のフィールドです (既定値 = すべて)。 |
戻り値
エンティティのパーティションを取得します (プレビュー)
エンティティのパーティションを取得します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
Customer Insights データセット
|
dataset | True | string |
Customer Insights のデータセットです。 |
|
エンティティ
|
table | True | string |
エンティティです。 |
戻り値
エンティティのパーティションを取得する (V2) (プレビュー)
エンティティのパーティションを取得します (V2)。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
Customer Insights データセット
|
dataset | True | string |
Customer Insights のデータセットです。 |
|
エンティティ
|
table | True | string |
エンティティです。 |
|
フィルターする partitionDisplayName 値
|
partitionDisplayName | string |
フィルターする partitionDisplayName 値です。 |
戻り値
パーティションの一覧
エンティティを取得
この操作では、インスタンスからエンティティを取得します
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
InstanceId
|
dataset | True | string |
インスタンスの識別子 |
戻り値
テーブルの一覧を表します。
- 本文
- TablesList
パーティションからデータを取得します (プレビュー)
パーティションからデータを取得します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
Customer Insights データセット
|
dataset | True | string |
Customer Insights データセットです。 |
|
エンティティ
|
table | True | string |
エンティティ。 |
|
パーティションの参照 (URI または名前)
|
partitionUri | True | string |
パーティションの参照 (URI または名前)。 |
|
列のコンマ区切り行
|
select | string |
列のコンマ区切り行。 |
|
|
読み取りを開始する位置 (バイト単位)
|
offsetStart | integer |
読み取りを開始する位置 (バイト単位)。 |
|
|
読み取る最大バイト数
|
maxSize | integer |
読み取る最大バイト数。 |
|
|
返す最大レコード数
|
maxResults | integer |
返す最大レコード数。 |
戻り値
パーティションからのデータ。
状態レポート V2 を送信する
状態レポート V2 を送信します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
インスタンス ID
|
dataset | True | string |
インスタンスを選択します。 |
|
Report type
|
reportType | True | string |
レポートの種類を選択します。 |
状態レポートの送信
状態レポートを送信します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
インスタンス ID
|
dataset | True | string |
インスタンスを選択します。 |
|
レポートの種類
|
reportType | True | string |
レポートの種類を選択します。 |
項目を取得する
この操作では、エンティティから項目を取得します
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
InstanceId
|
dataset | True | string |
インスタンスの識別子 |
|
entityName
|
table | True | string |
エンティティの名前 |
|
itemIdentifier
|
id | True | string |
項目の識別子 |
戻り値
トリガー
| Customer Insights でプロセスが完了したときにフローをトリガーする |
選択したプロセスのスケジュールされた更新に対してフローがトリガーされます。 さらに、手動更新のフローをトリガーすることを選択できます。 |
| Customer Insights で完全な更新が完了した際にフローをトリガーする |
この操作は Customer Insights (データ ソース、セグメント、メジャーなど) の完全な更新が完了するとフローをトリガーします。 |
| セグメントのしきい値を超えたときにフローをトリガーします |
この操作は、Dynamics 365 Customer Insights でセグメントのしきい値を超えたときにフローをトリガーします。 |
| ビジネス メジャーのしきい値を超えたときにフローをトリガーします |
この操作は、Dynamics 365 Customer Insights でビジネス メジャーのしきい値を超えたときにフローをトリガーします。 |
| 更新の失敗時にデータソースのフローをトリガーする |
この操作は、Dynamics 365 Customer Insights で更新が失敗したときに、データ ソースのフローをトリガーします。 |
| 更新の完了時にデータソースのフローをトリガーする |
この操作は、Dynamics 365 Customer Insights で更新が完了したときに、データ ソースのフローをトリガーします。 |
Customer Insights でプロセスが完了したときにフローをトリガーする
選択したプロセスのスケジュールされた更新に対してフローがトリガーされます。 さらに、手動更新のフローをトリガーすることを選択できます。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
インスタンス名
|
dataset | True | string |
インスタンスを選択します。 |
|
プロセス
|
process | string |
プロセスを選択します。 |
|
|
手動でトリガーするプロセスを含める
|
includingManualRefreshes | boolean |
手動でトリガーするプロセスを含める場合は [はい] を選択します。 |
戻り値
実行済みのプロセスに関する情報
- 本文
- ProcessData
Customer Insights で完全な更新が完了した際にフローをトリガーする
この操作は Customer Insights (データ ソース、セグメント、メジャーなど) の完全な更新が完了するとフローをトリガーします。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
インスタンス名
|
dataset | True | string |
インスタンスを選択します。 |
戻り値
実行済みの完全更新に関する情報
セグメントのしきい値を超えたときにフローをトリガーします
この操作は、Dynamics 365 Customer Insights でセグメントのしきい値を超えたときにフローをトリガーします。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
インスタンス名
|
dataset | True | string |
インスタンスを選択します。 |
|
セグメント名
|
segment | True | string |
セグメントを選択します。 |
|
しきい値
|
threshold | True | integer |
任意の数をしきい値として設定します。 |
戻り値
セグメント データ
- 本文
- SegmentData
ビジネス メジャーのしきい値を超えたときにフローをトリガーします
この操作は、Dynamics 365 Customer Insights でビジネス メジャーのしきい値を超えたときにフローをトリガーします。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
インスタンス名
|
dataset | True | string |
インスタンスを選択します。 |
|
ビジネス メジャー名
|
measure | True | string |
メジャーを選択する。 |
|
しきい値
|
threshold | True | double |
任意の数をしきい値として設定します。 |
戻り値
ビジネス メジャー データ
- 本文
- MeasureData
更新の失敗時にデータソースのフローをトリガーする
この操作は、Dynamics 365 Customer Insights で更新が失敗したときに、データ ソースのフローをトリガーします。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
環境
|
dataset | True | string |
データセット名。 |
戻り値
DataSourcesList
- 本文
- DataSourcesList
更新の完了時にデータソースのフローをトリガーする
この操作は、Dynamics 365 Customer Insights で更新が完了したときに、データ ソースのフローをトリガーします。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
環境
|
dataset | True | string |
データセット名。 |
戻り値
DataSourcesList
- 本文
- DataSourcesList
定義
DataSourcesList
DataSourcesList
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
値
|
value | array of DataSource |
データ ソース一覧 |
DataSource
DataSource クラス
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
RefreshType
|
RefreshType | string |
データ更新の種類 |
|
RefreshObjectId
|
RefreshObjectId | string |
更新オブジェクト ID |
|
RefreshObjectVersion
|
RefreshObjectVersion | integer |
更新オブジェクトのバージョン |
|
操作
|
Operation | string |
操作名 |
|
JobType
|
JobType | string |
ジョブの種類 |
|
エラーコード
|
ErrorCode | string |
データを更新する際のエラー コード。 |
|
エラーメッセージ
|
ErrorMessage | string |
更新する際のエラー メッセージ |
|
ErrorSeverity
|
ErrorSeverity | string |
更新する際のエラー重大度 |
|
StartTimeUtc
|
StartTimeUtc | string |
データ更新の開始時刻 |
|
EndTimeUtc
|
EndTimeUtc | string |
データ更新の終了時刻 |
SegmentData
セグメント データ
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
件名
|
Name | string |
セグメント名 |
|
表示名
|
DisplayName | string |
セグメントの表示名 |
|
EvaluationDate
|
EvaluationDate | date-time |
セグメントの評価日 |
|
EntityCount
|
EntityCount | integer |
セグメント メンバーの実際の数 |
|
しきい値
|
Threshold | integer |
セグメントのしきい値 |
MeasureData
ビジネス メジャー データ
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
件名
|
Name | string |
メジャー名 |
|
表示名
|
DisplayName | string |
メジャーの表示名 |
|
EvaluationDate
|
EvaluationDate | date-time |
メジャーの評価日 |
|
値
|
Value | double |
メジャーの値 |
|
ValueDisplayName
|
ValueDisplayName | string |
値の表示名 |
|
しきい値
|
Threshold | double |
メジャーのしきい値 |
FullRefreshProcessData
実行済みの完全更新に関する情報
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
NumberOfFailedTasks
|
NumberOfFailedTasks | integer |
失敗したタスクの件数 |
|
StartTime
|
StartTime | date-time |
ワークフロー ステップの開始時間 |
|
EndTime
|
EndTime | date-time |
ワークフロー ステップの終了時間 |
|
時間
|
Duration | integer |
プロセスの期間 (分) |
|
ステータス
|
Status | string |
ワークフロー ステップの状態 |
|
StatusPage
|
StatusPage | string |
状態ページへのリンク |
ProcessData
実行済みのプロセスに関する情報
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
StartTime
|
StartTime | date-time |
ワークフロー ステップの開始時間 |
|
EndTime
|
EndTime | date-time |
ワークフロー ステップの終了時間 |
|
時間
|
Duration | integer |
プロセスの期間 (分) |
|
ステータス
|
Status | string |
ワークフロー ステップの状態 |
|
StatusPage
|
StatusPage | string |
状態ページへのリンク |
テーブル
テーブルを表します。
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
件名
|
Name | string |
テーブルの名前です。 名前は実行時に使用されます。 |
|
表示名
|
DisplayName | string |
テーブルの表示名です。 |
|
DynamicProperties
|
DynamicProperties | object |
コネクタによってクライアントに提供された追加のテーブル プロパティです。 |
PartitionListResponse
パーティションの一覧
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
ヘッダー
|
Header | string |
エンティティの属性を含むヘッダー |
|
Partitions
|
Partitions | array of Table |
パーティションの一覧 |
PartitionDataResponse
パーティションからのデータ。
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
OffsetStart
|
OffsetStart | integer |
開始オフセット。 |
|
OffsetEnd
|
OffsetEnd | integer |
終了オフセット。 |
|
サイズ
|
Size | integer |
返されるデータ件数。 |
|
項目
|
Items | array of object |
オフセット「OffsetStart」から「OffsetEnd」までの、パーティションからの最大「サイズ」アイテムのデータを含む辞書。 |
|
項目
|
Items | object |
TablesList
テーブルの一覧を表します。
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
値
|
value | array of Table |
テーブルの一覧 |