如何在邮件中附加ICS日历邀请并实现自动接受添加至日历？

核心机制：结构化数据解析而非ICS附件 #

航班、Airbnb这类平台的确认邮件，并非通过ICS附件触发日历自动添加，而是靠邮件HTML中嵌入的Schema.org结构化数据标记（JSON-LD或Microdata）。Google会识别这些标记对应的预订类型（如FlightReservation、LodgingReservation），直接判定为已确认的预订事件，自动同步到用户日历且无需手动批准。

你当前实现的问题点及调整方案 #

1. ICS事件参数配置错误 #

你当前的ICS参数设置存在几个关键问题，导致无法触发自动批准：

• method: 'PUBLISH'：PUBLISH用于发布公开事件，不涉及参会人确认逻辑，应改为ADD（直接添加已确认事件）或REQUEST（配合参会人已确认状态）。
• busyStatus: 'FREE'：预订类事件属于占用用户时间的场景，需改为BUSY，符合日历自动添加的预期逻辑。
• rsvp: true：预批准事件无需用户回复RSVP，应设为false。

调整后的ICS事件代码示例：

const event = {
    start: startDate,
    end: endDate,
    status: 'CONFIRMED',
    busyStatus: 'BUSY',
    organizer: {
      name: myName,
      email: myEmail,
    },
    attendees: [
      {
        name,
        email,
        rsvp: false,
        partstat: 'ACCEPTED',
      },
    ],
    url: calUrl,
    title: calTitle,
    summary: calSummary,
    description: calDescription,
    location: address,
    productId: productId,
    method: 'ADD',
  };

2. 缺少邮件结构化数据标记 #

仅靠ICS内容无法触发Google的自动预批准逻辑，必须在邮件HTML中添加对应类型的Schema.org JSON-LD标记。以下是住宿预订场景的示例：

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "LodgingReservation",
  "reservationNumber": "RES12345",
  "reservationStatus": "https://schema.org/Confirmed",
  "underName": {
    "@type": "Person",
    "name": "张三"
  },
  "reservationFor": {
    "@type": "LodgingBusiness",
    "name": "XX酒店",
    "address": {
      "@type": "PostalAddress",
      "streetAddress": "XX路100号",
      "addressLocality": "上海",
      "postalCode": "200000"
    }
  },
  "checkinTime": "2024-06-01T14:00:00+08:00",
  "checkoutTime": "2024-06-03T12:00:00+08:00"
}
</script>

3. 邮件发件人信任度验证 #

确保你的发件域名已配置DKIM、SPF、DMARC认证，Google会优先信任经过认证的发件人，更易触发自动添加日历事件的逻辑。

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