Schema.org结构化数据标记中何时需使用完整URL？

1. @type字段：两种写法均有效，推荐用短名称 #

• "@type": "Brand" 和 "@type": "https://schema.org/Brand" 都符合Schema.org规范，JSON-LD处理器会通过上下文（"@context": "https://schema.org"）自动识别短名称对应的完整URL。
• 针对Google Search，优先用短名称——Google官方的商品结构化数据示例全采用短名称写法，更简洁且不会出现解析问题。

2. itemCondition字段：必须用完整Schema.org URL #

• 这里只能写 "itemCondition": "https://schema.org/NewCondition"，不能仅用"NewCondition"。
• 原因是itemCondition的值属于枚举类型的IRI，Schema.org对这类枚举属性要求用完整URL明确标识，Google商家列表结构化数据文档也明确规定必须用完整URL指定商品状态。

官方规则的核心逻辑 #

结合Schema.org核心规范和Google结构化数据要求：

• 类（@type对应的Brand、Product这类Schema.org类）：短名称和完整URL等效，处理器会自动映射。
• 枚举值（itemCondition对应的NewCondition、UsedCondition等）：必须用完整URL，因为这些是具体的枚举实例，短名称无法被解析为唯一标识。

体育用品网店适配示例 #

给你一个符合Google要求的商品结构化数据片段：

{
  "@context": "https://schema.org",
  "@type": "Product",
  "name": "专业碳纤维网球拍",
  "brand": {
    "@type": "Brand",
    "name": "XX体育"
  },
  "itemCondition": "https://schema.org/NewCondition",
  "offers": {
    "@type": "Offer",
    "price": "899",
    "priceCurrency": "CNY"
  }
}

内容的提问来源于stack exchange，提问作者Danny Wave