Method: users.messages.import

将邮件导入到相应用户的邮箱中，并进行标准电子邮件递送扫描和分类，类似于通过 SMTP 接收邮件。此方法不会执行 SPF 检查，因此可能不适用于某些垃圾邮件，例如试图进行网域欺骗的垃圾邮件。此方法不会发送消息。请注意，消息的大小上限为 150MB。

HTTP 请求

  • 上传 URI，用于媒体上传请求：
    POST https://gmail.googleapis.com/upload/gmail/v1/users/{userId}/messages/import
  • 元数据 URI，用于仅涉及元数据的请求：
    POST https://gmail.googleapis.com/gmail/v1/users/{userId}/messages/import

网址采用 gRPC 转码语法。

路径参数

参数
userId

string

用户的电子邮件地址。特殊值 me 可用于表示经过身份验证的用户。

查询参数

参数
internalDateSource

enum (InternalDateSource)

Gmail 内部邮件日期的来源。
neverMarkSpam

boolean

忽略 Gmail 垃圾邮件分类器的决定，并且绝不在邮箱中将此电子邮件标记为垃圾邮件。
processForCalendar

boolean

处理电子邮件中的日历邀请，并将提取出的所有会议添加到相应用户的 Google 日历中。
deleted

boolean

将相应电子邮件标记为已永久删除（而非移至“已删除邮件”文件夹），并且仅对保险柜管理员在 Google 保险柜中显示。仅适用于 Google Workspace 账号。

请求正文

请求正文包含一个 Message 实例。

响应正文

如果成功，则响应正文包含一个 Message 实例。

授权范围

需要以下 OAuth 范围之一：

  • https://mail.google.com/
  • https://www.googleapis.com/auth/gmail.modify
  • https://www.googleapis.com/auth/gmail.insert

如需了解详情，请参阅 OAuth 2.0 Overview。