Method: users.threads.get

获取指定的帖子串。

HTTP 请求

GET https://gmail.googleapis.com/gmail/v1/users/{userId}/threads/{id}

网址采用 gRPC 转码语法。

路径参数

参数
userId

string

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

string

要检索的线程的 ID。

查询参数

参数
format

enum (Format)

返回消息的格式。
metadataHeaders[]

string

如果指定了此参数且格式为 METADATA，则仅包含指定的标头。

请求正文

请求正文必须为空。

响应正文

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

授权范围

需要以下 OAuth 范围之一：

  • https://mail.google.com/
  • https://www.googleapis.com/auth/gmail.modify
  • https://www.googleapis.com/auth/gmail.readonly
  • https://www.googleapis.com/auth/gmail.metadata
  • https://www.googleapis.com/auth/gmail.addons.current.message.metadata
  • https://www.googleapis.com/auth/gmail.addons.current.message.readonly
  • https://www.googleapis.com/auth/gmail.addons.current.message.action

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

格式

枚举
full 返回完整的电子邮件数据，其中正文内容已在 payload 字段中解析；不使用 raw 字段。使用 gmail.metadata 范围访问 API 时，无法使用此格式。
metadata 仅返回电子邮件 ID、标签和电子邮件标头。
minimal 仅返回电子邮件 ID 和标签，不返回电子邮件标头、正文或载荷。