合作伙伴工作空间(Partner)
合作伙伴工作空间使你能够直接在 Postman 中与外部合作伙伴协作。你可以使用合作伙伴工作空间来帮助你的合作伙伴使用你团队的 API 并共同处理 API 项目。借助 Partner Workspaces,你可以构建单一事实来源并将你的合作伙伴项目集成到你的 Postman 团队中,从而为高效和富有成效的合作伙伴关系奠定基础。
创建合作伙伴工作空间
从标题中选择工作空间,然后选择**创建工作空间**。
定义工作空间名称和摘要。
在可见性下,选择合作伙伴。
选择创建工作空间。
任何有权创建工作空间的人都可以请求创建合作伙伴工作空间,但必须得到 合作伙伴经理 的批准。如果你不是 超级管理员 或合作伙伴经理,则必须提交你的请求以供批准。你还可以在请求中添加可选注释。在你的请求获得批准之前,工作空间的可见性将设置为 私有。 当合作伙伴经理审查你的请求并批准或拒绝它时,Postman 会通知你。
要将现有工作空间转换为合作伙伴工作空间,请执行以下操作:
- 打开工作空间。在概述选项卡中,选择右上角的工作空间设置。
- 在可见性下,选择合作伙伴。
- 选择更新。
任何有权更改工作空间可见性的人都可以请求将工作空间转换为合作伙伴工作空间,但必须得到 合作伙伴经理 的批准。如果你不是 超级管理员 或合作伙伴经理,Postman 会提及这一点,你可以在请求中添加可选注释。当合作伙伴经理审查你的请求并批准或拒绝它时,Postman 会通知你。
当工作空间转换为合作伙伴工作空间时,Postman 会向所有工作空间成员发送应用内和电子邮件通知。
设置合作伙伴工作空间
在与外部协作者共享合作伙伴工作空间之前,你可以通过将相关元素移动或 Forking 到其中来为成功建立合作伙伴关系。
你还可以使用工作空间模板来帮助设置新的合作伙伴工作空间。有关详细信息,请参阅 使用模板创建工作空间 。
将元素移动到合作伙伴工作空间
你必须是 API、集合或环境的编辑者、工作空间管理员、合作伙伴经理或超级管理员才能将元素移动到合作伙伴工作空间。
要将元素移动到合作伙伴工作空间,请执行以下操作:
在边栏中,选择要移动的元素。然后选择更多操作图标 >移动。
使用搜索栏查找要将元素移动到的工作空间,或通过选择筛选器图标按工作空间可见性进行筛选 。
你可以将元素移动到你有权访问的合作伙伴工作空间。
选择工作空间,然后选择移动(Collection、API或Environment)。
请注意,与你要移动的内容相关的项目(例如监视器和模拟服务器)不会自动随元素一起移动。有关详细信息,请参阅 将元素移动到团队工作空间 。
如果你想将某些元素保留在其他工作空间中,你可以 将它们 Forking 到合作伙伴工作空间中 ,以帮助使它们与父元素的任何更改 保持同步。
邀请合作者加入合作伙伴工作空间
工作空间管理员、合作伙伴经理和合作伙伴主管可以邀请合作伙伴加入合作伙伴工作空间。你的团队可以免费邀请三个分配有工作空间编辑角色的合作伙伴。要购买更多合作伙伴许可证,请联系你的 Postman 客户经理或 联系 Postman 的销售团队 。当一位合作伙伴在至少一个合作伙伴工作空间中被分配工作空间编辑角色时,就会消耗一个付费席位。为合作伙伴分配 Workspace Viewer 角色不会消耗付费席位。
有关合作伙伴角色的更多信息,请参阅 合作伙伴角色 。
要邀请合作伙伴加入合作伙伴工作空间,请执行以下操作:
打开工作空间, 在工作空间的概览选项卡中选择 工作空间设置,然后选择邀请。
你还可以在 Postman 标题中选择邀请。
(仅限 Workspace 管理员和合作伙伴经理)选择合作伙伴,然后选择继续。
输入合作伙伴的姓名、电子邮件或群组名称。
设置他们的 工作空间角色 。
你的团队必须有 可用席位 或 启用 Auto-Flex 才能邀请合作伙伴作为工作空间编辑。否则,合作伙伴将被分配工作空间查看者角色。为合作伙伴分配 Workspace Viewer 角色不会消耗付费席位。
(仅限工作空间管理员和合作伙伴经理)如果你希望他们也能够在工作空间内管理和邀请合作伙伴,请选择让他们成为合作伙伴主管。
选择邀请合作伙伴。
合作伙伴邀请必须由你在邀请个人时提供的电子邮件地址接受。如果合作伙伴想使用不同的电子邮件地址,或者错误发送了邀请,你可以 撤消邀请 并发送新的邀请。
合作伙伴将使用 Postman 用户名和密码登录你的团队,即使你的团队仅限于使用 SSO 登录。
工作空间管理员和合作伙伴经理可以邀请团队成员加入合作伙伴工作空间。
要邀请团队成员加入合作伙伴工作空间,请执行以下操作:
打开工作空间, 在工作空间的概览选项卡中选择 工作空间设置,然后选择邀请。
你还可以在 Postman 标题中选择邀请。
选择团队成员,然后继续。
输入团队成员的姓名、电子邮件或群组名称。
设置他们的 工作空间角色 。
选择发送邀请。
查看合作伙伴可以访问的工作空间
合作 伙伴经理 可以查看合作伙伴可以访问的合作伙伴工作空间,以及他们在每个工作空间中分配的工作空间角色。转到你的 团队仪表板 ,然后选择合作伙伴旁边的查看工作空间。选择合作伙伴工作空间名称以在新选项卡中打开工作空间。
在合作伙伴工作空间中协作
Partner Workspaces 提供的协作体验取决于你作为团队成员或外部合作伙伴的角色和地位。
作为团队成员进行协作
合作伙伴工作空间仅对受邀团队成员可见,类似于 私人工作空间 。受邀后,你可以像访问任何其他工作空间一样访问合作伙伴工作空间。要打开一个,请在 Postman 标题中选择工作空间,然后选择合作伙伴工作空间。
在合作伙伴工作空间内,团队成员可以拥有不同的工作空间角色:管理员、编辑者和查看者。要了解更多信息,请参阅 工作空间角色 。
还可以为用户分配团队级别的合作伙伴经理角色。合作伙伴经理可以查看组织内的所有合作伙伴工作空间,并可以控制其设置、可见性和合作伙伴邀请。要了解更多信息,请参阅 管理用户和角色 。
作为合作伙伴进行协作
当外部合作伙伴被与其合作的团队邀请到合作伙伴工作空间时,他们只能访问该合作伙伴工作空间,而不能访问团队中的任何其他工作空间或资源。合作伙伴在与之合作的团队中没有个人或团队工作空间。
在合作伙伴工作空间内,具有工作空间编辑者角色的合作伙伴可以 导入和导出 元素。他们还可以在同一合作伙伴工作空间内 Forking 元素 ,或 Forking 到同一团队内的另一个合作伙伴工作空间。他们不能在团队之外 Forking 元素。
在合作伙伴工作空间内,具有工作空间查看者角色的合作伙伴可以将 元素 Forking 到他们被分配工作空间编辑者角色的同一团队中的另一个合作伙伴工作空间。他们不能在团队之外 Forking 元素。此外,他们无法导出工作空间资源。
在团队级别,所有外部合作伙伴都会自动分配合作伙伴角色。在工作空间级别,所有合作伙伴在受邀加入合作伙伴工作空间时都会被分配 工作空间编辑者或查看者 角色。合作伙伴也可以被分配合作伙伴领导角色,这使他们能够邀请其组织中的其他人加入合作伙伴工作空间。
要了解有关合作伙伴角色和权限的更多信息,请参阅 合作伙伴角色 。
管理合作伙伴工作空间
工作空间管理员和合作伙伴经理管理合作伙伴工作空间内的工作空间设置、用户和角色。合作伙伴主管还管理合作伙伴在合作伙伴工作空间中的用户和角色。
管理用户和角色
你可以根据用户和合作伙伴需要的功能分配合作伙伴角色。你可以在团队级别 分配合作伙伴角色:
- 合作伙伴经理(内部)- 管理组织内的所有合作伙伴工作空间。控制合作伙伴工作空间设置和可见性,并可以向合作伙伴发送邀请。
- 合作伙伴(外部)- 所有合作伙伴都被自动授予团队级别的合作伙伴角色。合作伙伴只能访问他们受邀加入的合作伙伴工作空间。
你还可以在工作空间级别 分配合作伙伴角色:
- 合作伙伴主管(外部)- 可以邀请其组织中的其他合作伙伴加入合作伙伴工作空间。
当受邀加入合作伙伴工作空间时,所有合作伙伴都会被分配工作空间编辑者或查看者角色。
要了解有关合作伙伴角色的更多信息,请参阅 合作伙伴角色 。
管理工作空间元素
要将元素移动到合作伙伴工作空间,请参阅 将元素移动到合作伙伴工作空间 。
要从合作伙伴工作空间中删除元素,请参阅 从合作伙伴工作空间中删除元素 。
编辑工作空间详细信息
工作空间管理员和合作伙伴经理可以编辑合作伙伴工作空间的详细信息。在工作空间的概述选项卡上,选择工作空间名称、摘要或描述以对其进行编辑。你可以将 Markdown 添加到描述中——完成后选择保存。
从合作伙伴工作空间中删除元素
你必须是 API、集合或环境的编辑者、工作空间管理员、合作伙伴经理或超级管理员才能从合作伙伴工作空间中删除元素。
要通过将元素移动到另一个工作空间来移除元素,请执行以下操作:
在边栏中,选择要移动的元素,然后选择更多操作图标 >移动。
使用搜索栏查找要将元素移动到的工作空间,或通过选择筛选器图标按工作空间可见性进行筛选 。
你只能将元素移动到你有权访问的工作空间。
选择工作空间,然后选择移动(Collection、API或Environment)。
不推荐这样做,但你可以选择完全删除一个元素。为此,请选择边栏中的元素,然后选择更多操作图标 >删除。
已删除的 API 和环境不可恢复。在 Enterprise 计划中,你可以恢复小于 30 MB 的集合长达 90 天。为此,请 从 Postman 页脚中选择 垃圾箱。
从合作伙伴工作空间中删除合作伙伴
你可以从各个合作伙伴工作空间中删除合作伙伴。要从合作伙伴工作空间中删除合作伙伴,请参阅 管理工作空间角色 。
你可以从团队中删除合作伙伴。从团队中删除合作伙伴会将他们从所有合作伙伴工作空间中删除。此外,如果你从团队中删除最后一位管理员,则分配有合作伙伴经理角色的用户将被分配管理员角色。要从团队中删除合作伙伴,请参阅 删除团队成员 。
删除合作伙伴工作空间
工作空间管理员和合作伙伴经理可以删除合作伙伴工作空间。
- 在工作空间的概览选项卡上,选择工作空间设置。
- 将工作空间的可见性更改 为Private。
- 选择删除所有合作伙伴,然后选择更新。
- 选择删除工作空间。
当你删除合作伙伴工作空间时,Postman 会在应用程序内和通过电子邮件通知所有工作空间成员。