如何使用Python调用Gmail API发送线程回复邮件

你的代码无法正确回复线程的核心问题是混淆了Gmail的threadId与邮件的Message-ID，并且没有在API请求中明确指定线程ID。以下是修正方案：

关键概念区分 #

• Message-ID：邮件头中的唯一标识，格式类似你提供的CAJvJKUbP=+NwgeyCn40X-qG1i3yq7PzmXiChjJnROSAbHye1Bg@mail.gmail.com，用于邮件头的In-Reply-To和References字段。
• Gmail threadId：Gmail内部为邮件线程分配的唯一标识，格式为无特殊字符的字符串（如17abc123def456），必须在API发送请求中指定才能让邮件归入对应线程。

修正后的代码 #

1. 创建带线程信息的回复邮件 #

def create_reply_message(sender, to, original_subject, message_text, original_message_id, thread_id):
    from email.message import EmailMessage
    import base64

    message = EmailMessage()
    message.set_content(message_text)

    message['To'] = to
    message['From'] = sender
    # 自动添加Re:前缀，确保线程主题一致性
    reply_subject = f"Re: {original_subject}" if not original_subject.startswith("Re: ") else original_subject
    message['Subject'] = reply_subject
    # 邮件头关联原邮件
    message['In-Reply-To'] = original_message_id
    message['References'] = original_message_id

    # 编码邮件内容
    encoded_message = base64.urlsafe_b64encode(message.as_bytes()).decode()

    # 返回包含threadId的请求体（关键）
    return {
        'raw': encoded_message,
        'threadId': thread_id
    }

2. 通过Message-ID获取Gmail threadId #

如果你只有原邮件的Message-ID，需要先调用API获取对应的线程ID：

def get_thread_id_from_message_id(service, user_id, message_id):
    try:
        message = service.users().messages().get(userId=user_id, id=message_id).execute()
        return message['threadId']
    except HttpError as e:
        print(f"获取线程ID失败: {e}")
        return None

3. 发送回复（原发送函数无需修改） #

def send_message(service, user_id, message):
    try:
        message = service.users().messages().send(
            userId=user_id, body=message).execute()
        print(f"消息ID: {message['id']}")
        return message
    except HttpError as e:
        print(f"发送出错: {e}")
        return None

完整调用示例 #

# 假设已完成Gmail API授权，得到service对象
user_id = 'me'  # 代表当前授权用户
original_message_id = "CAJvJKUbP=+NwgeyCn40X-qG1i3yq7PzmXiChjJnROSAbHye1Bg@mail.gmail.com"
original_subject = "原邮件主题"
recipient_email = "收件人邮箱@example.com"
your_email = "你的邮箱@gmail.com"
reply_content = "这是你要回复的内容"

# 获取线程ID
thread_id = get_thread_id_from_message_id(service, user_id, original_message_id)

if thread_id:
    # 创建回复邮件
    reply_msg = create_reply_message(
        sender=your_email,
        to=recipient_email,
        original_subject=original_subject,
        message_text=reply_content,
        original_message_id=original_message_id,
        thread_id=thread_id
    )
    # 发送回复
    send_message(service, user_id, reply_msg)

注意事项 #

• 必须同时设置threadId请求参数和邮件头的In-Reply-To/References，才能保证邮件被正确归类到目标线程。
• 主题添加Re:前缀是Gmail识别线程的辅助条件，建议保持该规范。

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