Dynamics 365 Commerce - 評価とレビュー
Dynamics 365 Commerce Ratings and Reviews API を使用して、新規レビューのインポート、既存のレビューをエクスポートなどを行うことができます!
このコネクタは、次の製品および地域で利用可能です。
Service | クラス | 地域 |
---|---|---|
Logic Apps | 標準 | 以下を除くすべての Logic Apps 地域 : - Azure 政府の地域 - Azure 中国の地域 - 国防総省 (DoD) |
Power Automate | プレミアム | 以下を除くすべての Power Automate 地域 : - US Government (GCC) - US Government (GCC High) - 21 Vianet が運用する中国のクラウド - 米国国防総省 (DoD) |
Power Apps | プレミアム | 以下を除くすべての Power Apps 地域 : - US Government (GCC) - US Government (GCC High) - 21 Vianet が運用する中国のクラウド - 米国国防総省 (DoD) |
お問い合わせ先 | |
---|---|
件名 | Dynamics 365 Commerce-Ratings and Reviews |
[URL] | https://dynamics.microsoft.com/en-us/support/ |
メール | d365ratingreviewconn@microsoft.com |
Connector Metadata | |
---|---|
発行者 | マイクロソフト |
Web サイト | https://dynamics.microsoft.com/en-us/commerce/overview/ |
プライバシー ポリシー | https://privacy.microsoft.com/privacystatement |
カテゴリ | コマース; ビジネス管理 |
Dynamics 365 Commerce - Ratings and Reviews コネクタは、Dynamics 365 Ratings and Review Service API と対話するための一連のアクションを提供します。 これらのアクションにより、レビュー データのインポートとエクスポートが容易になります。 2 つのアクションがあります: すべてのレビューをエクスポートとレビューの送信。
続行するには、次のものが必要です:
- Microsoft Dynamics 365 Commerce のサブスクリプション
- 有効な Ratings and Reviews ソリューションの 詳細
Microsoft Dynamics 365 の使用方法の詳細については、こちら の Dynamics 365 Commerce パートナーにお問い合わせください。
最初のステップは、Microsoft Entra ID でコネクタをアプリケーションとして登録することです。 これにより、コネクタは Microsoft Entra ID に対して自身を識別し、エンド ユーザーに代わって Ratings and Reviews データにアクセスするためのアクセス許可を要求できます。 詳しくは こちら をご覧いただき、以下の手順に従ってください:
この Microsoft Entra ID アプリケーションは、Ratings and Reviews へのコネクタ接続を識別するために使用されます。 これは、Azure Portal を使用し、こちら の手順に従って Microsoft Entra ID にアプリを登録し、認証を有効にすることで行うことができます。
サービス プリンシパルを使用してコネクタとの認証接続を確立するために使用されるため、登録時に次の情報を取得します。
- クライアント アプリケーション ID
- クライアント シークレット (一度しか表示されないので、忘れずにメモしてください)。
- クライアント ディレクトリ (テナント) ID。
Microsoft Entra ID アプリケーションが作成されたことで、エンド ユーザーからアクセス許可を取得するために使用できるようになりました。 保存したフィールドを使用して、Dynamics 365 Commerce - Ratings and Reviews コネクタを使用したサービス プリンシパル経由の認証接続を確立します。
次の手順では、このアプリを Ratings and Reviews のモデレーション ツール設定ページに登録します。
Ratings and Reviews サービスがコネクタからの操作を認証するためには、クライアントは自身の Microsoft Entra ID アプリを Ratings and Review のモデレーション ツール設定ページに登録する必要があります。 前の手順のクライアント アプリケーション ID とクライアント ディレクトリ ID を使用して、サービス間 (S2S) アプリケーション エントリを追加します。 モデレーション ツールから Ratings and Reviews の設定を管理する方法の詳細については、こちら を参照してください。
Dynamics 365 Commerce - Ratings and Reviews コネクタの使用を開始するには、既存のフローに追加するか、レビューのインポートとエクスポート用のサンプル テンプレート フローを検索することから始めます。
注: Dynamics 365 Commerce - Ratings and Reviews コネクタはすべての Power Automate リージョンで利用可能ですが、Ratings and Reviews はテナントでサポートされているリージョンでのみ通話を処理します。 組織のコンプライアンス要件を確認し、コンプライアンスのニーズに適したリージョンに Power Automate 環境を作成してください。
レビュー テキスト本文とレビュー タイトルの最大長は?
レビュー タイトルの最大長は 55 文字です。 レビュー テキスト本文の最大長は 1,000 文字です。
レビューの送信アクションの encodedUser パラメーターの構造はどうなりますか?
encodedUser は、ユーザー情報を渡すために追加のセキュリティを追加します。 ユーザー ID スキーマを base64 にエンコードします。 以下のスキーマ構造を参照してフロー内のオブジェクトを構成し、組み込みの toBase64 () 関数を使用してエンコードしてから、SubmitReview アクションに渡します。
{ "p" : { "t" : "Unix epoch in seconds (should be within an hour of current time)", "email" : "Reviewer User Email Here", "name" : "Reviewer User Name Here", "id" : "Reviewer User Id Here" } }
詳細については、インポート レビュー テンプレート フローでこの例を確認してください。
もっとサポートが必要です。 どこに連絡すればいいですか?
一般的なサポートについては、Dynamics 365 Commerce サポートまでお問い合わせいただくか、d365ratingreviewconn@microsoft.com までメールでお問い合わせください。
このコネクタは、次の認証タイプをサポートしています:
既定 | 接続を作成するためのパラメーター。 | すべての地域 | 共有不可 |
適用できるもの: すべての領域
接続を作成するためのパラメーター。
これは共有可能な接続ではありません。 パワー アプリが別のユーザーと共有されている場合、別のユーザーは新しい接続を明示的に作成するように求められます。
名前 | 呼び出し | 更新期間 |
---|---|---|
接続ごとの API 呼び出し | 100 | 60 秒 |
すべてのレビューをエクスポート |
すべてのレビューをダウンロード可能な SAS URL としてエクスポートします。 |
ユーザー レビューの送信 |
RnR テナントにユーザー レビューを送信します。 |
すべてのレビューをダウンロード可能な SAS URL としてエクスポートします。
パラメーター
名前 | キー | 必須 | 型 | 説明 |
---|---|---|---|---|
RnR Tenant ID
|
tenantId | True | string |
RnR テナントの ID を指定します。 |
戻り値
RnR テナントにユーザー レビューを送信します。
パラメーター
名前 | キー | 必須 | 型 | 説明 |
---|---|---|---|---|
Product ID
|
productId | True | string |
レビューする製品の ID を指定します。 |
RnR Tenant ID
|
tenantId | True | string |
RnR テナントの ID を指定します。 |
Channel ID
|
channelId | string |
このレビューのチャネルの ID を指定します。 |
|
Market
|
market | string |
このレビューに関連付けられた市場を指定します。 |
|
Locale
|
locale | True | string |
このレビューに関連付けられたロケールを指定します。 |
encodedUser
|
encodedUser | True | string |
このレビューに関連付けられた base64 でエンコードされたユーザー情報文字列を指定します。 ユーザー名、メール、Id を含む JSON ブロック形式のドキュメントを参照してください。 |
Rating
|
Rating | True | string |
レビューの評価を整数で指定します。 |
Title
|
Title | True | string |
レビューのタイトルを指定します。 |
ReviewText
|
ReviewText | True | string |
レビューのテキスト本文を指定します。 |
Sku
|
Sku | string |
レビュー済み製品の SKU 番号を指定します。 |
|
ProductName
|
ProductName | True | string |
レビュー済み製品の名前を指定します |
LegalEntity
|
LegalEntity | string |
法人を指定します。 |
|
ExtendedProperties
|
ExtendedProperties | object |
追加のレビュー プロパティをキーと値のペアとして指定します。 JSON フォーマットの説明をご覧ください。 |
|
submittedDateTime
|
submittedDateTime | string |
レビューの送信 datetime を UTC 形式で指定します (既定値は現在の UTC 時間です)。 |
戻り値
送信されたレビューのレビュー ID。
- response
- SubmitReviewResponse
名前 | パス | 型 | 説明 |
---|---|---|---|
Blob SAS Url
|
blobSasUrl | string |
BLOB ストレージから生成された SAS URL。 |
Date Expires
|
expires | string |
SAS URLの有効期限が切れる日付。 |
Date Created
|
created | string |
SAS URL が作成された日付。 |