解决“请求集成权限”错误

当您尝试将应用连接到 HubSpot 时，可能会遇到“请求集成权限”错误。当应用在连接到 HubSpot 之前需要特定的用户角色或全局账户权限时，就会出现此错误。

本文将介绍连接应用时可能遇到的最常见的权限错误，以及如何解决每种错误，以便您成功完成连接。

无法完成连接：由于提供的权限范围不足，授权失败。请联系应用开发者。

错误含义

当应用的配置中包含某个必需的权限范围，但该范围未出现在应用安装 URL 的scope 查询参数中时，会发生此错误。在optional_scope 参数中包含该必需的权限范围也会触发此错误。

如何解决此错误

要解决此问题，应用开发者必须确保每个安装 URL 都包含其在应用配置中选定的所有必需范围。

无法完成连接：由于安装 URL 中的权限范围与应用配置的权限范围不匹配，授权失败。请联系应用开发者。

错误含义

如果发生以下任何一种情况，用户可能会遇到此错误：

• 应用的安装 URL 包含一个条件必需或可选的权限范围，但该范围未在应用设置中配置。
• 应用安装链接的optional_scope 查询参数中包含了一个条件必需的权限范围。
• 应用安装 URL 的 scope 参数中错误地包含了可选范围。例如，如果应用设置中将crm.objects.custom.read 范围配置为可选范围，但提供的安装 URL 为/authorize?client_id=123&redirect_uri=xyz&scope=crm.objects.custom.read ，则会发生此错误。

如何解决此错误

要解决此错误，应用开发者应确保已在应用设置中将权限范围正确配置为“条件必需”或“可选”。然后，确认每个权限范围都列在应用安装链接中相应的scope 和optional_scope 查询参数下。

无法完成连接。您无权连接此集成。

错误含义

尝试连接该集成的 HubSpot 用户不具备必要的用户角色或权限，无法授权该集成所请求的必需权限范围。

如何解决此错误

要解决此错误，连接集成的用户必须拥有应用市场（App Marketplace）的“ ”权限。这些权限可确保用户能够代表您的 HubSpot 账户连接并安装来自 HubSpot 应用市场的应用。如果授予这些权限后错误仍未解决，则需要向该用户授予“ ”超级管理员权限。

连接集成的用户还必须确保其拥有 应用市场中应用 列表页面“要求>HubSpot 账户权限”下所列的所有权限。

通常，缺失的权限是“编辑属性设置”权限。大多数应用都需要此访问权限，才能在 HubSpot 对象上创建或更新属性。

该账户无权访问此集成所需的部分 HubSpot 功能。请联系集成商。

错误含义

集成所连接的 HubSpot 账户不具备集成所请求权限范围所需的工具。例如，订阅了Marketing HubStarter套餐的 HubSpot 账户无法连接需要访问工作流的集成。

如何解决此错误

要解决此错误，HubSpot 账户必须升级至包含所需工具的订阅套餐。如果您想升级账户，请联系应用开发者，以确定连接其集成所需的订阅套餐。