如何避免Schema.org邮件标记覆盖Google Calendar已有事件

我通过Gmail发送带Schema.org JSON-LD EventReservation标记的邮件，原本期望每封邮件都能在Google Calendar中创建独立事件，但连续发送两封不同时间的预订邮件时，新邮件的标记会覆盖已有事件，而非生成新的独立事件。

举个例子：

• 第一封邮件：reservationId使用唯一UUID，事件时间设为08:00-08:30
• 第二封邮件：reservationId用另一个完全不同的UUID，事件时间设为09:00-09:30

尽管UUID和时间槽都不重复，Google Calendar仍把第二封邮件的内容判定为对第一封事件的更新。

第一封邮件标记（Schema 1）： #

<!DOCTYPE html>
<html>
   <head>
      <script type="application/ld+json">
         {
           "@context": "http://schema.org",
           "@type": "EventReservation",
           "reservationNumber": "E12345", // 实际使用UUID
           "reservationStatus": "http://schema.org/Confirmed",
           "reservationId": "qwerty1234567",
           "underName": {
             "@type": "Person",
             "name": "Udhaya"
           },
           "reservationFor": {
             "@type": "Event",
             "name": "30 Min Meeting",
             "performer": {
               "@type": "Organization",
               "name": "Tech Park"
             },
             "startDate": "2023-11-10T08:00:00-08:00",
             "endDate": "2023-11-10T08:30:00-08:00",
             "location": {
               "@type": "Place",
               "name": "Tech Park",
               "address": {
                 "@type": "PostalAddress",
                 "streetAddress": "NA",
                 "addressLocality": "NA",
                 "addressRegion": "NA",
                 "postalCode": "NA",
                 "addressCountry": "United States"
               }
             }
           },
           "modifyReservationUrl": "https://example.com/reschedule/E12345",
           "ticketToken": "E12345",
           "ticketNumber": "E12345"
         }
      </script>
   </head>
   <body>
      ...邮件正文
   </body>
</html>

第二封邮件标记（Schema 2）： #

<!DOCTYPE html>
<html>
   <head>
      <script type="application/ld+json">
         {
           "@context": "http://schema.org",
           "@type": "EventReservation",
           "reservationNumber": "R98764",
           "reservationStatus": "http://schema.org/Confirmed",
           "reservationId": "asdfg3983", // 实际使用UUID
           "underName": {
             "@type": "Person",
             "name": "Udhaya"
           },
           "reservationFor": {
             "@type": "Event",
             "name": "30 Min Meeting",
             "performer": {
               "@type": "Organization",
               "name": "Tech Park"
             },
             "startDate": "2023-11-10T09:00:00-08:00",
             "endDate": "2023-11-10T09:30:00-08:00",
             "location": {
               "@type": "Place",
               "name": "Tech Park",
               "address": {
                 "@type": "PostalAddress",
                 "streetAddress": "NA",
                 "addressLocality": "NA",
                 "addressRegion": "NA",
                 "postalCode": "NA",
                 "addressCountry": "United States"
               }
             }
           },
           "modifyReservationUrl": "https://example.com/reschedule/R98764",
           "ticketToken": "R98764",
           "ticketNumber": "R98764"
         }
      </script>
   </head>
   <body>
      ...邮件正文
   </body>
</html>

我已经确认所有UUID都是唯一的，时间槽也不重叠，目标是让每封邮件都生成独立事件，互不干扰。想知道Gmail处理这类事件邮件是否有已知问题，以及有哪些办法能确保每个标记都生成预期的唯一事件？

解决方案 #

核心原因

Google Calendar识别EventReservation时，不仅会看reservationId，还会结合reservationFor下的事件核心属性（名称、主办方、地点）进行匹配。如果多封邮件的这些属性高度相似，Calendar可能会忽略reservationId的唯一性，误判为同一事件的更新。

具体解决步骤

• 给每个事件添加唯一@id：在reservationFor的Event对象里加入唯一的@id字段，用UUID作为值，明确告知Calendar这是不同的事件。示例修改：

  "reservationFor": {
    "@type": "Event",
    "@id": "urn:uuid:xxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx", // 每个事件用不同UUID
    "name": "30 Min Meeting",
    // 其他属性保持不变
  }
  

• 差异化事件名称：给同类型会议的名称添加唯一标识，比如“30 Min Meeting - 08:00”和“30 Min Meeting - 09:00”，减少系统的匹配混淆。
• 确保所有关联字段全唯一：reservationNumber、ticketToken、ticketNumber这些字段也要保证每封邮件完全不同，不要有任何重复或关联值。
• 拉长邮件发送间隔：避免短时间内连续发送带标记的邮件，给Google的处理系统留足够时间识别，防止被误判为同一事件的重复更新。
• 验证标记合规性：用Google的结构化数据测试工具检查每封邮件的JSON-LD标记，确保没有语法错误，所有必填属性都正确设置。

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