Google Calendar事件更新触发取消邮件异常问题求助

问题描述 #

我开发了一个Rails API，客户预约时会发送Google Calendar邀请。但改期时存在异常：有时正常收到「Updated Invitation」邮件，有时却同时收到「Updated Invitation」和「Cancelled Event」邮件，无法理解为何会触发取消邮件。以下是调用Google Calendar API的代码：

def update_event_on_calendar(calendar_uid, location_id: , event_id: , title: nil, start_datetime: nil, end_datetime: nil, guest_name: nil, guest_email: nil, isConsultation: false)

    # get address
    location = Location.find(location_id)
    event_address = location.address

    # format attendees
    attendee_array = []

    if guest_email.present? || guest_name.present?
        guest_attendee = Google::Apis::CalendarV3::EventAttendee.new(email: guest_email, display_name: guest_name)
        attendee_array << guest_attendee
    end

    # Adds an event on the office's calendar 
    organizer_attendee = Google::Apis::CalendarV3::EventAttendee.new(email: location.email, organizer: true)
    attendee_array << organizer_attendee

    start_datetime_rfc3339 = start_datetime.present? ? start_datetime.rfc3339 : nil
    end_datetime_rfc3339 = end_datetime.present? ? end_datetime.rfc3339 : nil
    thestart = { date_time: start_datetime_rfc3339 }
    theend = { date_time: end_datetime_rfc3339 }

    description = "Congratulations on scheduling your discovery consultation"

    event_update = Google::Apis::CalendarV3::Event.new(start:thestart, end:theend, summary:title, attendees: attendee_array, location: event_address, description: description)

    begin
        event = @service.patch_event(calendar_uid, event_id, event_update, send_updates: 'all')
        sleep(6)

    rescue Google::Apis::ServerError, Google::Apis::ClientError, Google::Apis::AuthorizationError => e
        Sentry.capture_exception(e)
        return reason_for_error(e.body)
    end     

    return event
end

已尝试使用update_event方法，结果一致。

可能原因 #

• 参会者列表意外变更：每次更新时重新构建attendee_array，若原事件存在其他参会者（如隐藏的会议室资源、其他联系人），更新时会被移除，Google Calendar会给被移除的参会者发送取消邮件；或重复添加组织者，导致原组织者被标记为非组织者，触发取消逻辑。
• 时间字段不完整：当start_datetime或end_datetime为空时，date_time传入nil，可能导致事件时间被重置，触发异常通知。
• 全量更新触发非预期校验：即使使用patch_event，若传递了所有事件字段（包括未变更的），可能被Google Calendar识别为事件重建，而非增量更新。

解决方案 #

1. 基于原事件参会者列表做增量修改 #

不要每次更新都重新构建参会者列表，先获取原事件的参会者，仅调整需要变更的部分，避免意外移除原有参会者：

# 先获取原事件信息
original_event = @service.get_event(calendar_uid, event_id)

# 基于原参会者列表修改，而非重新创建
attendee_array = original_event.attendees.dup || []

# 仅当客户信息有变更时更新参会者
if guest_email.present?
  existing_guest = attendee_array.find { |a| a.email == guest_email }
  if existing_guest
    # 更新客户名称（如果有变更）
    existing_guest.display_name = guest_name if guest_name.present?
  else
    # 新增客户参会者
    attendee_array << Google::Apis::CalendarV3::EventAttendee.new(email: guest_email, display_name: guest_name)
  end
end

# 确保组织者仅存在一个，避免重复添加
unless attendee_array.any? { |a| a.organizer }
  attendee_array << Google::Apis::CalendarV3::EventAttendee.new(email: location.email, organizer: true)
end

2. 确保时间字段完整性 #

更新时优先保留原事件的时间信息，仅在有新值时覆盖：

# 保留原事件的时间，仅当传入新时间时更新
thestart = if start_datetime.present?
             { date_time: start_datetime.rfc3339 }
           else
             original_event.start.to_h
           end

theend = if end_datetime.present?
           { date_time: end_datetime.rfc3339 }
         else
           original_event.end.to_h
         end

3. 仅传递变更的字段给patch_event #

避免全量传递所有字段，只设置需要更新的属性，减少非预期的校验触发：

event_update = Google::Apis::CalendarV3::Event.new
event_update.start = thestart if start_datetime.present?
event_update.end = theend if end_datetime.present?
event_update.summary = title if title.present?
event_update.attendees = attendee_array if attendee_array != original_event.attendees
event_update.location = event_address if event_address != original_event.location
event_update.description = description if description != original_event.description

4. 验证操作账号的组织者权限 #

确保执行更新的Google账号是原事件的组织者，或拥有完全修改权限，避免因权限不足导致Google Calendar将更新识别为事件转移或重建。

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