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