SurveyMonkey Canada （预览版）

SurveyMonkey 是全球领先的基于 Web 的调查解决方案提供商。 这些解决方案由公司、组织和个人用来收集他们需要做出更明智的决策的见解。 此连接器连接到 SurveyMonkey Canada 数据中心，以满足合规性和数据驻留要求。

此连接器在以下产品和区域中可用：

服务	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	Microsoft
URL	https://support.microsoft.com

连接器元数据
发布者	SurveyMonkey
网站	https://www.surveymonkey.com/
隐私策略	https://www.surveymonkey.com/mp/legal/privacy-policy/
类别	内容和文件;生产力

SurveyMonkey Canada

SurveyMonkey 是全球领先的基于 Web 的调查解决方案提供商。 这些解决方案由公司、组织和个人用来收集他们需要做出更明智的决策的见解。 此连接器连接到 SurveyMonkey Canada 数据中心，以满足合规性和数据驻留要求。

先决条件

若要使用此集成，需要一个 SurveyMonkey 帐户，该帐户配置为使用加拿大数据中心。

发布者：Microsoft

获取凭据

为加拿大数据中心配置的 SurveyMonkey 帐户（试用或付费）需要注册应用程序。 可以 在此处开始试用。 之后，可以转到 开发人员页 ，并在其中注册应用程序。 可以从那里获取应用密钥和机密。

支持的作

获取调查

获取特定调查的详细信息。

计划现有邀请消息

发送或计划向所有邮件收件人发送现有邮件。

添加新收集器响应时

添加响应时触发新流（仅限付费帐户）。

添加新调查响应时

添加调查响应时触发新流（仅限付费帐户）。

创建新调查时

创建调查时触发新流。

创建新收集器时

创建收集器时触发新流。

已知问题和限制

• 此连接器专为 SurveyMonkey Canada 数据中心帐户设计（api.surveymonkey.ca）。
• 使用全局数据中心 （api.surveymonkey.net） 的常规 SurveyMonkey 帐户应改用标准 SurveyMonkey 连接器。
• 在使用此连接器之前，用户必须确保其 SurveyMonkey 帐户已正确配置加拿大数据中心。
• 所有数据处理和存储都将发生在 SurveyMonkey 的加拿大数据中心基础结构中。

数据驻留和符合性

此连接器可确保：

• 所有 API 调用均路由到 SurveyMonkey 的加拿大数据中心（api.surveymonkey.ca）
• 调查数据仍位于加拿大管辖范围内
• 遵守加拿大数据保护和隐私法规
• OAuth 身份验证流经基于加拿大的终结点

部署说明

请使用 这些说明 将此连接器部署为 Microsoft Power Automate 和 Power Apps 中的自定义连接器

限制

名称	调用	续订期
每个连接的 API 调用数	100	60 秒

操作

获取 CSV 格式的响应详细信息	导出 CSV 格式的详细响应和调查数据。 此高级功能目前在有限的时间内对某些 SurveyMonkey 计划开放。
获取 JSON 格式的响应详细信息	导出 JSON 格式的详细响应和调查数据。 此高级功能目前在有限的时间内对某些 SurveyMonkey 计划开放。
获取调查	获取特定调查的详细信息。
计划现有邀请消息	发送或计划向所有邮件收件人发送现有邮件。

获取 CSV 格式的响应详细信息

操作 ID:

GetResponseDetails

导出 CSV 格式的详细响应和调查数据。 此高级功能目前在有限的时间内对某些 SurveyMonkey 计划开放。

参数

名称	密钥	必需	类型	说明
调查 ID	surveyId	True	string	选择调查
响应 ID	responseId	True	string	选择响应
问题 ID	question_ids		string	将响应详细信息筛选为特定问题。 对多个问题 ID 使用逗号分隔符。

返回

名称	路径	类型	说明
响应 ID	id	string	响应标识符。
收件人 ID	recipient_id	string	收件人标识符。
收集模式	collection_mode	string	响应收集模式。
响应状态	response_status	string	响应的状态。
自定义值	custom_value	string	与响应关联的自定义值。
名字	first_name	string	收件人的名字。
姓氏	last_name	string	收件人的姓氏。
电子邮件地址	email_address	string	收件人的电子邮件地址。
IP 地址	ip_address	string	响应者的 IP 地址。
收集器 ID	collector_id	string	收集器标识符。
调查 ID	survey_id	string	调查标识符。
编辑 URL	edit_url	string	链接到调查页以编辑响应。
分析 URL	analyze_url	string	链接到分析页以查看响应。
花费的时间	total_time	integer	响应所用的总时间。
修改日期	date_modified	string	上次修改响应的日期。
创建日期	date_created	string	创建响应的日期。
Link	href	string	调查响应链接。
原始响应数据	RawResponseData	string	响应的 CSV 输出。

获取 JSON 格式的响应详细信息

操作 ID:

GetResponseDetailsNoPages

导出 JSON 格式的详细响应和调查数据。 此高级功能目前在有限的时间内对某些 SurveyMonkey 计划开放。

参数

名称	密钥	必需	类型	说明
调查 ID	surveyId	True	string	选择调查
响应 ID	responseId	True	string	选择响应
问题 ID	question_ids		string	将响应详细信息筛选为特定问题。 对多个问题 ID 使用逗号分隔符。

返回

名称	路径	类型	说明
响应 ID	id	string	响应标识符。
收件人 ID	recipient_id	string	收件人标识符。
收集模式	collection_mode	string	响应收集模式。
响应状态	response_status	string	响应的状态。
自定义值	custom_value	string	与响应关联的自定义值。
名字	first_name	string	收件人的名字。
姓氏	last_name	string	收件人的姓氏。
电子邮件地址	email_address	string	收件人的电子邮件地址。
IP 地址	ip_address	string	响应者的 IP 地址。
收集器 ID	collector_id	string	收集器标识符。
调查 ID	survey_id	string	调查标识符。
编辑 URL	edit_url	string	链接到调查页以编辑响应。
分析 URL	analyze_url	string	链接到分析页以查看响应。
花费的时间	total_time	integer	响应所用的总时间。
修改日期	date_modified	string	上次修改响应的日期。
创建日期	date_created	string	创建响应的日期。
Link	href	string	调查响应链接。
问题	questions	array of object	问题
问题 ID	questions.id	string	问题标识符。
答案	questions.answers	array of object	答案
应答标记数据	questions.answers.tag_data	array of	应答标记数据
答案文本	questions.answers.text	string	答案文本
回答简单文本	questions.answers.simple_text	string	回答简单文本
问题系列	questions.family	string	问题的类型。
问题子类型	questions.subtype	string	问题的子类型。
问题标题	questions.heading	string	问题的标题。

获取调查

操作 ID:

GetSurvey

获取特定调查的详细信息。

参数

名称	密钥	必需	类型	说明
调查 ID	surveyId	True	string	调查的 ID

返回

Body

Survey

计划现有邀请消息

操作 ID:

SendMessage

发送或计划向所有邮件收件人发送现有邮件。

参数

名称	密钥	必需	类型	说明
调查 ID	surveyId	True	string	选择调查
收集器 ID	collectorId	True	string	选择收集器
消息 ID	messageId	True	string	选择邮件
计划日期	scheduled_date		date-time	时间格式：yyyy-MM-ddTHH：mm：ss.fffZ （2016-07-20T08：00：00.000Z）

返回

Body

SurveyMessageResponse

触发器

创建新收集器时	创建收集器时触发新流。
创建新调查时	创建调查时触发新流。
添加对问题的新调查回复时	添加问题响应时触发新流（仅限付费帐户）。
添加新收集器响应时	添加响应时触发新流（仅限付费帐户）。
添加新调查响应时	添加调查响应时触发新流（仅限付费帐户）。

创建新收集器时

操作 ID:

OnSurveyCollectorCreated

创建收集器时触发新流。

参数

名称	密钥	必需	类型	说明
调查 ID	surveyId	True	string	选择调查

返回

名称	路径	类型	说明
Link	href	string	链接到调查收集器。
收集器 ID	id	string	收集器标识符。
Name	name	string	收集器的名称。

创建新调查时

操作 ID:

OnSurveyCreated

创建调查时触发新流。

返回

名称	路径	类型	说明
Link	href	string	链接到调查。
调查 ID	id	string	调查标识符。
Title	title	string	调查的标题。

添加对问题的新调查回复时

操作 ID:

OnNewResponseToQuestionAdded

添加问题响应时触发新流（仅限付费帐户）。

参数

名称	密钥	必需	类型	说明
调查 ID	surveyId	True	string	选择调查
页面 ID	page_ids		string	选择页面
问题 ID	question_ids		string	选择问题

返回

名称	路径	类型	说明
花费的时间	total_time	integer	响应所用的总时间。
Link	href	string	调查响应链接。
IP 地址	ip_address	string	响应者的 IP 地址。
响应 ID	id	string	响应标识符。
修改日期	date_modified	date-time	上次修改响应的日期。
响应状态	response_status	string	响应的状态。
自定义值	custom_value	string	与响应关联的自定义值。
分析 URL	analyze_url	string	链接到分析页以查看响应。
收件人 ID	recipient_id	string	收件人标识符。
收集器 ID	collector_id	string	收集器标识符。
创建日期	date_created	date-time	创建响应的日期。
调查 ID	survey_id	string	调查标识符。
收集模式	collection_mode	string	响应收集模式。
名字	first_name	string	recepient 的名字。
姓氏	last_name	string	recepient 的姓氏。
电子邮件地址	email_address	string	recepient 的电子邮件地址。
page_path	page_path	array of	页面响应的顺序。
页面	pages	array of object	调查中的页面及其相关响应。
页面 ID	pages.id	string	页面 ID
问题	pages.questions	array of object	问题
问题 ID	pages.questions.id	string	问题 ID
answers	pages.questions.answers	array of object	答案
选择 ID	pages.questions.answers.choice_id	string	选择 ID
编辑 URL	edit_url	string	链接到调查页以编辑响应。

添加新收集器响应时

操作 ID:

OnNewResponseAddedCollector

添加响应时触发新流（仅限付费帐户）。

参数

名称	密钥	必需	类型	说明
调查 ID	surveyId	True	string	选择调查
收集器 ID	collectorId	True	string	选择收集器

返回

名称	路径	类型	说明
花费的时间	total_time	integer	响应所用的总时间。
Link	href	string	调查响应链接。
IP 地址	ip_address	string	响应者的 IP 地址。
响应 ID	id	string	响应标识符。
修改日期	date_modified	date-time	上次修改响应的日期。
响应状态	response_status	string	响应的状态。
自定义值	custom_value	string	与响应关联的自定义值。
分析 URL	analyze_url	string	链接到分析页以查看响应。
收件人 ID	recipient_id	string	收件人标识符。
收集器 ID	collector_id	string	收集器标识符。
创建日期	date_created	date-time	创建响应的日期。
调查 ID	survey_id	string	调查标识符。
收集模式	collection_mode	string	响应收集模式。
名字	first_name	string	recepient 的名字。
姓氏	last_name	string	recepient 的姓氏。
电子邮件地址	email_address	string	recepient 的电子邮件地址。
page_path	page_path	array of	页面响应的顺序。
页面	pages	array of object	调查中的页面及其相关响应。
页面 ID	pages.id	string	页面 ID
问题	pages.questions	array of object	问题
问题 ID	pages.questions.id	string	问题 ID
answers	pages.questions.answers	array of object	答案
选择 ID	pages.questions.answers.choice_id	string	选择 ID
编辑 URL	edit_url	string	链接到调查页以编辑响应。

添加新调查响应时

操作 ID:

OnNewResponseAddedSurvey

添加调查响应时触发新流（仅限付费帐户）。

参数

名称	密钥	必需	类型	说明
调查 ID	surveyId	True	string	选择调查

返回

名称	路径	类型	说明
花费的时间	total_time	integer	响应所用的总时间。
Link	href	string	调查响应链接。
IP 地址	ip_address	string	响应者的 IP 地址。
响应 ID	id	string	响应标识符。
修改日期	date_modified	date-time	上次修改响应的日期。
响应状态	response_status	string	响应的状态。
自定义值	custom_value	string	与响应关联的自定义值。
分析 URL	analyze_url	string	链接到分析页以查看响应。
收件人 ID	recipient_id	string	收件人标识符。
收集器 ID	collector_id	string	收集器标识符。
创建日期	date_created	date-time	创建响应的日期。
调查 ID	survey_id	string	调查标识符。
收集模式	collection_mode	string	响应收集模式。
名字	first_name	string	recepient 的名字。
姓氏	last_name	string	recepient 的姓氏。
电子邮件地址	email_address	string	recepient 的电子邮件地址。
page_path	page_path	array of	页面响应的顺序。
页面	pages	array of object	调查中的页面及其相关响应。
页面 ID	pages.id	string	页面 ID
问题	pages.questions	array of object	问题
问题 ID	pages.questions.id	string	问题 ID
answers	pages.questions.answers	array of object	答案
选择 ID	pages.questions.answers.choice_id	string	选择 ID
编辑 URL	edit_url	string	链接到调查页以编辑响应。

定义

调查

名称	路径	类型	说明
响应计数	response_count	integer	已收到答复调查的次数。
页计数	page_count	integer	调查中的页数。
调查 ID	id	string	调查标识符。
问题计数	question_count	integer	调查中的问题数。
调查类别	category	string	创建调查时选择的调查类别。
预览 URL	preview	string	调查预览 URL。
语言	language	string	调查语言。
修改日期	date_modified	date-time	上次修改调查的日期。
Title	title	string	调查的标题。
分析 URL	analyze_url	string	调查结果的 URL。
摘要 URL	summary_url	string	调查摘要的 URL。
创建日期	date_created	date-time	创建调查的日期。
收集 URL	collect_url	string	调查收集 URL。
编辑 URL	edit_url	string	调查编辑 URL。

SurveyMessageResponse

名称	路径	类型	说明
Link	is_scheduled	string	指向消息结果的链接。
计划日期	scheduled_date	date-time	计划发送日期消息。
邮件正文	body	string	要发送给收件人的电子邮件的纯文本正文。
Subject	subject	string	要发送给收件人的电子邮件的主题。
收件人	recipients	array of string	收件人 ID 列表。
States	recipient_status	string	收件人状态。
类型	type	string