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 データにアクセスするためのアクセス許可を要求できます。 詳しくは こちら をご覧いただき、以下の手順に従ってください:

1. Microsoft Entra ID アプリケーションの作成:

この 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 のモデレーション ツール設定ページに登録します。

2. Microsoft Entra ID アプリケーションを 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 テナントにユーザー レビューを送信します。

すべてのレビューをエクスポート

操作 ID:
ExportReviews

すべてのレビューをダウンロード可能な SAS URL としてエクスポートします。

パラメーター

名前 キー 必須 型 説明
RnR Tenant ID
 tenantId True string

RnR テナントの ID を指定します。

戻り値

Body
ExportSuccessfulResponse

ユーザー レビューの送信

操作 ID:
SubmitReview

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

定義

SubmitReviewResponse

送信されたレビューのレビュー ID。

送信されたレビューのレビュー ID。

ReviewID
string

ExportSuccessfulResponse

名前 パス 型 説明
Blob SAS Url
 blobSasUrl string

BLOB ストレージから生成された SAS URL。
Date Expires
 expires string

SAS URLの有効期限が切れる日付。
Date Created
 created string

SAS URL が作成された日付。