Dynamics 365 Commerce - 评级和评论
利用 Dynamics 365 商业评级和评论 API 导入新评论、导出现有评论等!
此连接器在以下产品和区域中可用:
| 服务 | Class | 区域 |
|---|---|---|
| Copilot Studio | 高级 | 除以下各项外的所有 Power Automate 区域 : - 美国政府 (GCC) - 美国政府 (GCC High) - 由世纪互联运营的中国云 - 美国国防部(DoD) |
| 逻辑应用程序 | 标准 | 除以下各项外的所有 逻辑应用区域 : - Azure 政府区域 - Azure 中国区域 - 美国国防部(DoD) |
| Power Apps | 高级 | 除以下各项外的所有 Power Apps 区域 : - 美国政府 (GCC) - 美国政府 (GCC High) - 由世纪互联运营的中国云 - 美国国防部(DoD) |
| Power Automate | 高级 | 除以下各项外的所有 Power Automate 区域 : - 美国政府 (GCC) - 美国政府 (GCC High) - 由世纪互联运营的中国云 - 美国国防部(DoD) |
| 联系人 | |
|---|---|
| Name | Dynamics 365 Commerce-Ratings 和评论 |
| URL | https://dynamics.microsoft.com/en-us/support/ |
| d365ratingreviewconn@microsoft.com |
| 连接器元数据 | |
|---|---|
| 发布者 | Microsoft |
| 网站 | https://dynamics.microsoft.com/en-us/commerce/overview/ |
| 隐私策略 | https://privacy.microsoft.com/privacystatement |
| 类别 | 商业;业务管理 |
Dynamics 365 Commerce - Ratings and Reviews 连接器提供了一组作来与 Dynamics 365 评级和评审服务 API 进行交互。 这些作有助于导入和导出评审数据。 有两个作可用:导出所有评审并提交审阅。
先决条件
需要满足以下条件才能继续作:
- Microsoft Dynamics 365 Commerce 订阅
- 已启用的评分和评论解决方案 详细信息
请在此处联系 Dynamics 365 商业合作伙伴,详细了解如何开始使用 Microsoft Dynamics 365。
如何获取凭据
第一步是在 Microsoft Entra ID 中将连接器注册为应用程序。 这允许连接器标识自己以Microsoft Entra ID,并请求有权代表最终用户访问评级和评审数据。 在此处阅读 有关此内容 的详细信息,并按照以下步骤作:
1.创建Microsoft Entra ID 应用程序:
此Microsoft Entra ID 应用程序将用于标识与评级和评价的连接。 可以使用 Azure 门户完成此作,方法是按照 此处 的步骤在 Microsoft Entra ID 上注册应用并启用身份验证。
在注册期间,捕获以下信息,因为它将用于使用服务主体与连接器建立经过身份验证的连接:
- 客户端应用程序 ID
- 客户端密码(请记住记下此密码,因为它只显示一次)。
- 客户端目录(租户)ID。
创建Microsoft Entra ID 应用程序后,它现在可用于从最终用户获取权限。 使用保存的字段通过服务主体使用 Dynamics 365 Commerce - Ratings 和 Reviews Connector 建立经过身份验证的连接。
下一步是在“评分和评论审查工具设置”页中注册此应用。
2. 在评级和评审审查工具中注册Microsoft条目 ID 应用程序
为了使评级和评价服务对来自连接器的作进行身份验证,客户端必须在“评级和审阅审查”工具设置页中注册其Microsoft Entra ID 应用。 使用上一步中的客户端应用程序 ID 和客户端目录 ID 将服务添加到服务(S2S)应用程序条目。 有关如何从审查工具管理评级和评论设置的更多详细信息,请参阅 此处。
连接器入门
若要开始使用 Dynamics 365 Commerce - Ratings and Reviews Connector,只需添加现有流,或首先搜索示例模板流以导入和导出评论。
注意:Dynamics 365 Commerce - Ratings and Reviews Connector 将在所有 Power Automate 区域中可用,但分级和评论将仅处理租户支持的区域调用。 请务必查看组织的符合性要求,并在符合合规性需求的区域中创建 Power Automate 环境。
FAQ
审阅文本正文和审阅标题的最大长度是多少?
审阅标题的最大长度为 55 个字符。 审阅文本正文的最大长度为 1,000 个字符。
提交评审作中的 encodedUser 参数的结构是什么?
encodedUser 增加了额外的安全性,以便传递用户信息。 它将用户标识架构编码为 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。
正在创建连接
连接器支持以下身份验证类型:
| 默认 | 用于创建连接的参数。 | 所有区域 | 不可共享 |
违约
适用:所有区域
用于创建连接的参数。
这是不可共享的连接。 如果 Power App 与另一个用户共享,系统会提示其他用户显式创建新连接。
限制
| 名称 | 调用 | 续订期 |
|---|---|---|
| 每个连接的 API 调用数 | 100 | 60 秒 |
操作
| 导出所有评论 |
将所有评审导出为可下载的 SAS URL。 |
| 提交用户评审 |
将用户评审提交到 RnR 租户。 |
导出所有评论
将所有评审导出为可下载的 SAS URL。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
RnR 租户 ID
|
tenantId | True | string |
指定 RnR 租户的 ID。 |
返回
提交用户评审
将用户评审提交到 RnR 租户。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
产品 ID
|
productId | True | string |
指定要审阅的产品的 ID。 |
|
RnR 租户 ID
|
tenantId | True | string |
指定 RnR 租户的 ID。 |
|
通道 ID
|
channelId | string |
指定此评审的频道 ID。 |
|
|
市场
|
market | string |
指定与此评审关联的市场。 |
|
|
区域设置
|
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 | object |
将任何其他审阅属性指定为键值对。 请参阅 JSON 格式的文档。 |
|
|
submittedDateTime
|
submittedDateTime | string |
以 UTC 格式指定审阅的提交日期/时间(默认值为当前 UTC 时间)。 |
返回
提交的评审的审阅 ID。
- response
- SubmitReviewResponse
定义
SubmitReviewResponse
ExportSuccessfulResponse
| 名称 | 路径 | 类型 | 说明 |
|---|---|---|---|
|
Blob SAS Url
|
blobSasUrl | string |
从 Blob 存储生成的 SAS URL。 |
|
日期过期
|
expires | string |
SAS URL 过期的日期。 |
|
创建日期
|
created | string |
创建 SAS URL 的日期。 |