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

有关详情，请参阅授权指南。

形式

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