跳到内容
请注意::本文仅为方便您阅读而提供。本文由翻译软件自动翻译,可能未经校对。本文的英文版应被视为官方版本,您可在此找到最新信息。您可以在此处访问。

创建和编辑自定义对象

上次更新时间: 2026年8月31日

可与以下任何订阅一起使用,除非另有说明:

摘要

如果您的业务需要超出 标准 CRM 对象的关系或流程,可在数据模型 中或通过 API 创建和定义自定义对象。自定义对象允许您跟踪 HubSpot 完全定义对象之外的特定业务数据。

本文将介绍使用自定义对象的不同方法。然后,创建和管理自定义对象,并设置自定义对象关联。 

一旦定义好,就可以创建属性、管理管道,并自定义自定义对象与其他对象之间的关联。在 营销电子邮件工作流报告等其他 HubSpot 工具中使用自定义对象。

需要权限 创建、编辑和管理自定义对象需要 账户访问 权限。

请注意: 根据您的订购情况,自定义对象和属性的数量是有限制的。在我们的HubSpot 产品 & 服务目录中了解有关您的限制的更多信息。

开始之前

在定义自定义对象之前,重要的是要评估它是否适合你的业务和 HubSpot 中的数据质量。

在创建自己的对象之前,需要考虑的问题包括

  • 能否使用现有的 CRM 对象及其属性来组织数据,而不是自定义对象?
  • 自定义对象和现有对象之间是否存在数据重叠或不一致的情况?
  • 您想使用现有对象的哪些独特功能?例如,批量 营销电子邮件 只能发送给联系人,而不能发送给其他对象。
  • 是否有与现有对象相连的预建报告需要使用?例如, 交易归因报告销售预测 直接与交易而非其他对象相连。

要了解现有对象关系和数据,可以查看账户 数据模型概览。有关何时创建自定义对象的进一步指导,请参阅 HubSpot 学院的这一课程 或联系您的 客户成功经理。

自定义对象术语表

在创建自定义对象之前,您应该熟悉一些术语和概念。

  • 对象名称:自定义对象的标题。您将被要求定义一个复数名称和一个单数名称。例如," 公司 "是一个复数对象名称,而 " 公司 "是该对象的单数名称。
  • 主要显示属性:用于命名对象记录的属性。这是对象的主要标识属性,可用于在索引页面上 搜索记录 。默认情况下,它显示在对象索引页面的第一列和每条记录的左上方。例如, 公司名称 是公司的主要显示属性。

公司记录示例,显示记录的公司名称作为主要显示属性。

  • 标签:在 HubSpot CRM(如记录或索引页面)中显示的属性名称。例如,公司属性 " 公司名称 "就是标签。属性标签可能会更改,因此 不应 由集成或 API 使用。
  • 内部名称:属性的内部值,由集成或 API 使用。例如, 公司 名称 属性的内部值是 name.内部名称 不能 更改,因此集成和 API 应使用内部名称来引用属性。

公司名称属性设置,突出显示属性的内部名称值。

  • 次要属性:对象的附加识别属性。这些属性显示在记录的资料卡上,位于主要显示属性之下。它们还可用于 搜索 索引页面上的 记录 。对于自定义对象,它们也会作为附加快速筛选器出现在索引页面上。例如,"公司 "的二级属性是 公司域名电话号码, 而 "宠物 "自定义二级属性可以是 宠物类型。

公司记录示例,显示记录的公司域名和电话号码作为二级显示属性。

对象设置-二级属性-宠物类型-示例

使用自定义对象有哪些不同方法

下面的示例基于常见的使用情况,可以帮助你理解自定义对象如何影响账户数据,但并不代表对每种情况都提供建议。如需讨论自定义对象是否适合您的特定用例,请联系您的 客户成功经理。

以下是自定义对象的 良好 示例:

  • 宠物屋希望记录寄养宠物的信息,将每只宠物与主人联系起来,并记录每只宠物的相关活动。他们创建了一个宠物对象, 宠物名称 是主要显示属性, 宠物类型 是次要属性。他们可以在索引页面上查看和搜索与他们合作的宠物,根据宠物类型 保存查看 结果,将联系人与宠物联系起来,并管理宠物记录中的活动和约会。
  • 汽车经销商希望维护一个数据库,记录当前库存或已售出的汽车,并跟踪与每辆汽车相关的销售咨询。他们创建了一个以 模型 作为主要显示属性的汽车对象。他们创建了一个 自定义对象流水线 ,以跟踪汽车从新到库存、购买过程到售出等各个阶段的变化。他们可以查看记录在每辆车记录上的咨询电话或电子邮件,并在汽车出售时将联系人和交易联系起来。

以下是 建议创建自定义对象的示例:

  • 学校有一个学生、家长和教师数据库。他们希望为家长和教师创建自定义对象,以帮助区分联系人类型。这 不是 一个好的使用案例,因为自定义对象不应该复制现有的 CRM 对象。一个人可以既是家长又是教师,这将导致数据重叠。此外,学校无法向家长和教师群发电子邮件,因为他们不是联系人。相反,他们可以在 "联系人 "对象中包含所有联系人类型,并创建一个自定义 联系人类型 属性,其中包含 " 学生"、" 家长"和 " 教师 "选项。
  • 一家家装公司利用 HubSpot 记录上的备注向其承包商提出内部要求。他们希望创建一个 Notes 对象来跟踪所有请求。这 不是 一个好的使用案例,因为自定义对象不应该取代活动。与标记用户相比,这增加了额外的步骤,其他记录的 活动无法自动关联 到自定义备注记录,也无法使用预置的活动报告。此外,如果用户同时更新自定义备注记录和另一个相关记录,一个项目的信息可能会存储在多个地方,从而可能导致数据重复或冲突。相反,他们可以在记录上创建备注,将其与其他记录关联起来,在备注上标记 HubSpot 用户,并使用预建报告来跟踪备注活动。

如何创建自定义对象

构建定制化解决方案

了解如何使用 自定义对象 API 构建自定义解决方案。

在 HubSpot 中创建自定义对象:

  1. 在你的 HubSpot 帐户中,单击更多,然后导航到数据管理 > 数据模型。如果你的帐户中未显示 更多,请直接导航到数据管理 > 数据模型
  2. 单击 “编辑数据模型”。
  3. 在左侧面板中 ,“所有对象”旁边的 “+”图标上单击。
  4. 在右侧窗格中,单击 “自定义对象”。
  5. 在右侧面板中,设置自定义对象:
    • 设置自定义对象的名称:
      • 对象名称(单数):输入自定义对象的单数标题(如宠物)。
      • 对象名称(复数):输入自定义对象的复数标题(如宠物)。
    • 输入一个可选的 对象描述 ,向账户用户解释该对象是什么以及如何使用。
    • 创建对象的 主要显示属性: 
      • 主要显示属性:输入用于命名对象记录的属性标签(如宠物的宠物 )。创建自定义对象记录时 需要使用 此属性。
      • 属性类型:选择主要显示属性的 类型 ,如单行文本 数字日期选择器单复选框下拉选择。 
      • 点击 edit 编辑图标 来编辑属性的 内部名称,然后点击 保存 确认。内部名称由集成或应用程序接口使用,创建对象后就 无法 编辑。
      • 选择 复选框 以要求主要显示属性的值是唯一的。启用此功能后,用户将无法在多个记录中输入相同的值(例如,对于 “订单”对象,其主属性 “订单号 ”应要求值唯一)。

        创建一个“从头开始创建对象”面板,其中包含对象名称、描述和主要显示属性字段。
    • 为自定义对象创建 二级属性
      • 次要显示属性:输入显示在记录主要属性下方的属性标签(例如,宠物的宠物 类型主人电话号码 )。创建自定义对象记录时 需要次要属性,以后可以通过 编辑自定义对象添加或删除次要属性。
      • 属性类型:选择主要显示属性的 类型 ,如 单行文本数字日期选择器单复选框下拉选择
      • 点击 edit 编辑属性的 内部名称,然后点击 保存 确认。内部名称由集成或应用程序接口使用,创建对象后就 无法 编辑。
    • 单击 + 添加属性 ,添加额外的辅助显示属性。只有在为第一个二级属性设置了标签和属性类型后,才会出现该选项。
    • 点击 delete 删除 图标,删除现有的二级属性。

从头开始创建一个对象,右侧面板中显示辅助显示的属性字段。

  1. 完成后,点击面板底部的 创建

您也可以使用 数据模型或 Breeze Copilot 创建自定义对象。

请注意: 自定义对象的名称不能与 HubSpot 定义的现有 对象相匹配。如果在创建自定义对象时遇到错误,请使用不同的单数和复数名称。

为自定义对象配置其他设置

定义自定义对象后,可以在 自定义对象设置中进行以下操作:

如何编辑或删除自定义对象

创建自定义对象后,可以编辑其名称和属性,或从 HubSpot 账户中删除该对象。您还可以在 自定义对象设置 中或 通过 API 编辑和删除自定义对象。

要在数据模型中编辑或删除 

  1. 在你的 HubSpot 帐户中,单击更多,然后导航到数据管理 > 数据模型。如果你的帐户中未显示 更多,请直接导航到数据管理 > 数据模型
  2. 点击 图表视图图标
  3. 导航至自定义对象。
  4. 在自定义对象卡上,单击 ellipses 三个横点图标 并选择
    数据模型创建器中的自定义对象卡,选中三个横点图标,显示 "编辑对象 "和 "删除对象 "等选项
    • 查看对象使用情况:点击展开你要查看的 部分 ,查看对象当前在 HubSpot 中的使用情况。单击资产 名称 导航到工具。
    • 编辑对象:您可以编辑对象的单名、复名和描述,以及添加或删除 辅助显示属性。如果需要编辑主显示属性,可以使用 自定义对象 API 进行编辑。不能 编辑对象或属性的 内部名称
      • 要编辑现有主显示或辅助显示属性的名称,请单击 " 编辑属性标签 "导航到 属性设置。
      • 要添加其他二级属性,请单击 + 添加属性,然后输入属性 名称 并选择属性 类型
      • 要删除二级属性,请将鼠标悬停在该属性上,然后点击 delete 删除图标。如果删除二级属性,自定义对象记录中仍可访问该属性,但将不再显示在 配置文件卡片或索引页筛选器中。如果要删除属性,请学习如何在属性设置中 存档和删除 属性。
      • 单击 " 保存 " 确认更改。
    • 删除对象:在对话框中,选择 复选框 确认不能恢复已删除的自定义对象,然后单击 删除对象 确认。如果其他工具正在使用自定义对象,则 无法 删除该对象,因此在删除之前需要从这些工具中移除对该对象的引用。

如何定义自定义对象的关联

在将关联记录添加到自定义对象记录(如联系人到宠物)之前,需要在设置中创建关联关系。您可以设置联系人、公司、交易和票据等对象的关联。进一步了解 关联对象的可能性

添加新的关联定义:

  1. 在你的 HubSpot 帐户中,单击更多,然后导航到数据管理 > 数据模型。如果你的帐户中未显示 更多,请直接导航到数据管理 > 数据模型
  2. 在右上方,单击 编辑数据模型
  3. 点击 图表视图图标
  4. “搜索对象 ”文本框中,输入您要管理其关联关系的自定义对象的 名称
  5. 点击对象卡片上的 三个水平点图标 ,然后选择 “查看所有相关对象”。
  6. 在数据模型中,单击 add 添加关联图标
    咖啡混合物对象,加号图标突出显示,用于添加新关联。
  7. 在对话框中 选择对象,然后单击创建

现在,您可以 所选对象的 记录关联到 ,并 创建标签来描述关联

要删除关联定义,请执行以下操作

  1. 在你的 HubSpot 帐户中,单击更多,然后导航到数据管理 > 数据模型。如果你的帐户中未显示 更多,请直接导航到数据管理 > 数据模型
  2. 在右上方,单击 编辑数据模型
  3. 点击 图表视图图标
  4. “搜索对象 ”文本框中,输入自定义对象的 名称
  5. 点击对象卡片上的 三个横向点图标 ,然后选择 “查看所有关联对象”。
  6. 在数据模型中,在要删除定义的对象上单击 ellipses 三个横点图标
    公司对象打开菜单,突出显示删除关联选项。
  7. 单击删除关联
  8. 如果资产阻碍了清除工作:
    • 检查阻止删除关联定义的资产(如工作流、计算属性)。
    • 单击资产 名称 ,查看并删除该资产(如删除工作流程)。
    • 单击下一步
    • 删除记录关联(如适用)。
    • 单击删除关联
  9. 如果记录关联阻止了删除:
    • 审查阻止删除关联定义的记录。
      删除关联定义的面板,显示使用全部删除按钮删除所有记录关联的步骤。
    • 单击全部删除
    • 在对话框中输入 编号,然后单击删除
    • 单击下一步
    • 单击删除所有关联标签(如果适用)。
    • 单击删除关联
  10. 如果没有资产或记录阻止删除,请选择 确认 复选框,然后单击 删除
这篇文章有帮助吗?
此表单仅供记载反馈。了解如何获取 HubSpot 帮助