合作伙伴连接器要求

查看发布概览，了解发布连接器的优势和所需的承诺级别。如需发布合作伙伴连接器，您的 连接器必须满足下述所有要求。

Apps 脚本

在提交连接器以供审核之前，请在 Apps 脚本中完成以下操作：

1. 与以下地址共享 Apps 脚本项目的查看权限：
   • [e-mail]
   • [e-mail]
2. 创建部署，将其命名为 Production，并更新 Production 部署，使其包含您打算发布的代码版本。
3. 确认您已将 Production 部署更新为要审核的代码版本。
4. 确认清单文件在 Apps 脚本中可见。点击左侧的 项目设置 。选中在编辑器中显示“appsscript.json”清单文件 复选框。

清单

在连接器的清单中添加以下内容，并确认您的 Apps 脚本项目已配置为在编辑器中显示 appsscript.json 清单文件。

如需了解详情，请参阅社区连接器清单参考。

dataStudio

1. description 应提供信息 和说明，以便用户基本了解连接器及其使用方法 。如果连接器的说明模糊、不完整，则会被拒绝。
2. addOnUrl 应该是关于您的连接器的专用托管页面 ，最好托管在您自己的网域中。该页面必须包含以下内容：
   • 隐私权政策 和使用条款 ，或指向这些内容的链接，且与 addOnUrl 位于同一网域中。
   • 用户需要了解的有关使用连接器的详细信息。
   • 注册链接（如果使用连接器需要账号）。
   • 最好托管在您网域中的内容。不允许托管在 https://sites.google.com/ 上。
   • 查看现有合作伙伴（Funnel、Supermetrics、 CallRail）的示例页面。
3. supportUrl 应该是用于 获取连接器支持的托管页面。不得为电子邮件地址或 mailto 链接。
4. logoUrl 应指向您控制下托管的静态图片 。您不能 使用 Google 服务在 *.gstatic.com、*.ggpht.com、*.google.com、*.googleusercontent.com 等网域上提供的图片。使用 Google Cloud Storage 从 *.googleapis.com 网域提供图片是可以接受的，也是建议的托管选项。
   • 如果连接器的图标是动画，则会被拒绝。请使用静态图片。
   • 建议至少使用 48x48 像素的图片。
   • 避免使用纯文本图片，因为当缩放为 48x48 像素时，这些图片很难阅读。
5. 使用连接器连接的所有 来源填充 sources 属性。如需了解详情，请参阅清单参考中的来源。
   • 您可以在 数据注册表存储区中查看现有的来源列表。如果存储区中不存在您要连接的来源，请向数据注册表存储区发送拉取请求以添加来源。如果清单中的来源在存储区中不存在，您的连接器将无法通过审核流程。
   • 这是连接器的其他元数据，会在资源库中针对搜索功能编入索引。当用户在资源库中搜索特定来源时，您的连接器将显示在搜索结果中。
6. 为 shortDescription、 authType、feeType、privacyPolicyUrl 和 termsOfServiceUrl 提供值。
7. name 应直接代表 连接器的用途。清晰的名称有助于用户确定您的连接器是否满足其需求。请避免在名称中使用“连接器”一词，因为用户已经知道他们正在查看连接器。
   • 请勿添加特殊字符或不可见字符，以免引起用户对连接器的注意或可能更改连接器的位置。
8. 请勿在清单中的任何位置使用数据洞察的缩写名称（例如 GDS、DS 等）。
9. 任何清单字段（description、shortDescription、name 等）中都不允许使用表情符号。一般来说，请勿添加特殊字符或不可见字符，以免引起用户对连接器的注意。
10. 如果连接器具有固定架构， 请为连接器创建报告模板并将其添加到清单中。 为报告启用通过链接共享 。
    

urlFetchWhitelist

1. 将 UrlFetchApp 调用的端点数量限制为连接器功能绝对需要的端点。将 urlFetchWhitelist 属性添加到清单的根级别。如需了解详情，请参阅 urlFetchWhitelist 参考
   
   。
   • 添加与 UrlFetchApp 服务一起使用的所有端点。
   • 如果连接器未使用 UrlFetchApp 服务提取资源，请将 urlFetchWhitelist 设置为空列表 []。
   • 如果连接器未连接到一组固定端点或端点前缀不同，请忽略 urlFetchWhitelist 属性，并在提交审核请求时在 urlFetchWhitelist 的例外情况 表单字段中提供详细信息。

oauthScopes

1. 在清单中设置明确的 OAuth 范围。如果连接器没有明确的 OAuth 范围，则会被拒绝。

连接器

1. 如果用户需要账号才能使用连接器，请确保连接器 description 或 addOnUrl 链接提供了帮助用户创建账号的说明。
2. 您的连接器不能处于未完成状态或测试状态。您必须发布完整并可正常运行的连接器。您可以随时更新连接器，但应测试发布给用户的生产部署版本并确保其功能完备。
3. 当用户遇到连接器内部错误时，向用户提供具有实际意义且可作为操作依据的错误消息。这包括用户在配置时输入无效/空白内容的情况。
4. shortDescription、description、addOnUrl 链接、supportUrl 链接和 OAuth 页面（如果适用）中不应有拼写和语法错误。
5. shortDescription 不能包含网址。
6. 使用 getAuthType() 提供的身份验证方法。请勿通过 getConfig() 请求凭据。
   
7. 完成 OAuth 客户端验证 流程。无论在 getAuthType() 中使用哪种身份验证方法，所有连接器都必须进行验证。验证流程与连接器审核流程不同，由一个单独的团队（而非数据洞察）负责处理。如需了解详情，请参阅 OAuth API 验证常见问题解答。如果您未完成 OAuth 客户端验证流程，您的连接器 将被拒绝 。
   
   • 在 OAuth 验证流程中， 配置 OAuth 权限请求页面时，请添加连接器必需的 OAuth 范围。如果未能添加 所有必需的范围， 您可能会通过 OAuth 验证流程，但您的连接器仍将 显示 未验证的应用屏幕。这将导致合作伙伴连接器验证流程失败。
     通过OAuth 验证流程后，使用新账号授权并测试您的连接器，以确保它不会向用户显示未验证的应用屏幕。
8. 确保您遵守 数据洞察资源库服务条款（提交者）。

满足所有要求后，请点击以下按钮以请求审核您的连接器：

发布您的合作伙伴连接器