使用Python调用Google Gmail API发邮件遇AttributeError问题求助

嘿，我之前调试Gmail API的时候也踩过这个坑，这个错误其实大多和服务实例构建错误或者API调用路径写错有关，咱们一步步来排查：

最可能的两个原因&解决方法 #

1. 你可能漏掉了users()层级调用 #

Gmail API的消息操作都是挂在users资源下的，正确的调用路径是service.users().messages().send()，而不是直接service.messages().send()。很多人会忽略这一层，直接调用messages，自然会触发属性不存在的错误。

修正你的SendMessage函数里的调用代码：

# 错误写法
message = service.messages().send(userId=user_id, body=message).execute()

# 正确写法
message = service.users().messages().send(userId=user_id, body=message).execute()

2. 没有正确构建Gmail V1服务实例 #

如果你的service对象不是用gmail API和v1版本构建的，返回的Resource对象就不会包含messages相关属性。检查你的service创建代码，确保是这样的：

首先确保依赖库是最新的：

pip install --upgrade google-api-python-client google-auth-httplib2 google-auth-oauthlib

然后正确构建service：

from googleapiclient.discovery import build
from google.oauth2.credentials import Credentials

# 从授权文件加载凭证（假设你已经完成授权，生成了token.json）
creds = Credentials.from_authorized_user_file('token.json', ['https://mail.google.com/'])
# 必须指定API名称为'gmail'，版本为'v1'
service = build('gmail', 'v1', credentials=creds)

完整示例代码 #

把这些整合起来，一个能正常发送邮件的完整流程大概是这样：

from googleapiclient.discovery import build
from google.oauth2.credentials import Credentials
import base64
from email.mime.text import MIMEText

def create_message(sender, to, subject, message_text):
    """创建要发送的邮件消息"""
    message = MIMEText(message_text)
    message['to'] = to
    message['from'] = sender
    message['subject'] = subject
    return {'raw': base64.urlsafe_b64encode(message.as_bytes()).decode()}

def SendMessage(service, user_id, message):
    """发送邮件消息"""
    try:
        message = service.users().messages().send(userId=user_id, body=message).execute()
        print(f"邮件发送成功！消息ID: {message['id']}")
        return message
    except Exception as e:
        print(f"发送失败，错误信息: {e}")
        raise

# 主流程
if __name__ == '__main__':
    creds = Credentials.from_authorized_user_file('token.json', ['https://mail.google.com/'])
    service = build('gmail', 'v1', credentials=creds)
    msg = create_message('your-email@gmail.com', 'recipient@example.com', '测试邮件', '这是通过Gmail API发送的测试内容')
    SendMessage(service, 'me', msg)

你可以对照自己的代码，检查是哪一步出了问题——大概率是上述两个原因中的一个，调整后应该就能解决这个错误了。

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