Gmail中EventReservation JSON-LD无法渲染图片及CTA按钮问题

我为交易类预订邮件实现了基于JSON-LD的Gmail结构化数据，标记通过Gmail Markup Tester验证，Gmail可正确渲染EventReservation卡片，但活动图片和标注为“Buy More”的CTA按钮无法显示。以下是最简示例代码：

{  
  "@context": "http://schema.org",  
  "@type": "EventReservation",  
  "underName": {    
    "@type": "Person",    
    "name": "Evan Audet"  
  },  
  "reservationFor": {    
    "@type": "MusicEvent",    
    "name": "AURA: An immersive experience larger than life",    
    "url": "https://example.com/event",    
    "image": "https://example.com/event-image.png",    
    "startDate": "2026-03-28T19:15:00-04:00",    
    "location": {      
      "@type": "Place",      
      "name": "Église Saint-Roch",      
      "address": {        
        "@type": "PostalAddress",        
        "streetAddress": "555 Rue Saint-François E #1",        
        "addressLocality": "Québec",        
        "addressCountry": "CA"      
      }    
    }  
  },  
  "modifyReservationUrl": "https://example.com/reschedule",  
  "venueSection": "2x Adult (16+)",  
  "potentialAction": {    
    "@type": "ViewAction",    
    "name": "Buy More",    
    "target": "https://example.com/buy-more"  
  }
}

问题修复方案 #

1. 活动图片不显示的修复 #

Gmail对EventReservation卡片的图片有明确要求：

• 必须使用公开可访问的HTTPS链接，HTTP链接或带防盗链的链接无法被加载
• 图片格式优先PNG/JPG，尺寸建议至少400x400像素，比例接近1:1（适配Gmail卡片显示区域）
• 确认reservationFor.image字段是直接的图片资源URL，而非包含图片的页面URL
• 若链接无问题，可尝试更换测试邮箱或清除Gmail缓存后重新测试

2. "Buy More" CTA按钮不显示的修复 #

Gmail对EventReservation的potentialAction类型有严格限制，仅支持少数标准Action类型，ViewAction不会被渲染为卡片上的自定义按钮。可通过以下方式处理：

• 改用标准Action类型：如果业务场景允许，将potentialAction的类型改为Gmail支持的ModifyAction或CancelAction，但这仅适用于修改/取消预订场景，不符合“Buy More”需求
• 邮件正文补充CTA：在邮件正文显眼位置添加“Buy More”按钮链接，配合结构化数据使用。Gmail的EventReservation卡片本身不支持自定义非标准Action按钮，因此正文补充是最可靠的方式

额外验证注意事项 #

• 确保发送邮件的域名已完成Gmail结构化数据的域名验证，未验证域名即使通过测试器，也可能导致部分元素不显示
• 检查图片服务器是否允许Gmail爬虫UA访问，避免防盗链拦截

内容的提问来源于stack exchange，提问作者Maria Alba