Method: media.upload

上传附件。如需查看示例，请参阅将媒体作为文件附件上传。

需要用户身份验证，并拥有以下某个授权范围：

  • https://www.googleapis.com/auth/chat.messages.create
  • https://www.googleapis.com/auth/chat.messages
  • https://www.googleapis.com/auth/chat.import（仅限导入模式聊天室）

您可以上传的附件大小上限为 200 MB。不支持某些文件类型。有关详情，请参阅 Google Chat 中屏蔽的文件类型。

HTTP 请求

  • 上传 URI，用于媒体上传请求：
    POST https://chat.googleapis.com/upload/v1/{parent=spaces/*}/attachments:upload

网址采用 gRPC 转码语法。

路径参数

参数
parent

string

必需。上传附件的 Chat 聊天室的资源名称。格式为“spaces/{space}”。

请求正文

请求正文中包含结构如下的数据：

JSON 表示法 
{
  "filename": string
}
字段
filename

string

必需。附件的文件名，包括文件扩展名。

响应正文

上传附件的响应。

如果成功，响应正文将包含结构如下的数据：

JSON 表示法 
{
  "attachmentDataRef": {
    object (AttachmentDataRef)
  }
}
字段
attachmentDataRef

object (AttachmentDataRef)

对上传的附件的引用。

授权范围

需要以下 OAuth 范围之一：

  • https://www.googleapis.com/auth/chat.import
  • https://www.googleapis.com/auth/chat.messages.create
  • https://www.googleapis.com/auth/chat.messages

如需了解详情，请参阅授权指南。