类似于 IMAP APPEND
,直接将邮件插入仅此用户的邮箱,绕过大多数扫描和分类。不会发送消息。
HTTP 请求
- 上传 URI,用于媒体上传请求:
POST https://gmail.googleapis.com/upload/gmail/v1/users/{userId}/messages
- 元数据 URI,用于仅涉及元数据的请求:
POST https://gmail.googleapis.com/gmail/v1/users/{userId}/messages
网址采用 gRPC 转码语法。
路径参数
参数 | |
---|---|
userId |
用户的电子邮件地址。特殊值 |
查询参数
参数 | |
---|---|
internalDateSource |
Gmail 邮件内部日期的来源。 |
deleted |
将电子邮件标记为已永久删除(而非“回收站”),并且仅在 Google 保险柜中向保险柜管理员显示。仅适用于 Google Workspace 账号。 |
请求正文
请求正文包含一个 Message
实例。
响应正文
如果成功,则响应正文包含一个 Message
实例。
授权范围
需要以下 OAuth 范围之一:
https://mail.google.com/
https://www.googleapis.com/auth/gmail.modify
https://www.googleapis.com/auth/gmail.insert
如需了解详情,请参阅授权指南。