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 和标签,不返回电子邮件标头、正文或负载。