Method: files.create

上传文件以用于媒体消息或富卡片消息。

代理会提供文件的网址或二进制数据，以及（可选）相应缩略图文件的网址。

重要提示：为了保护用户隐私和安全，RCS 商务平台会先从提供的网址下载媒体文件和 PDF 文件并进行处理，然后再将其发送给用户。这样可以防止代理通过唯一网址进行跟踪。因此，请勿提交大量唯一网址。RCS 商务平台不支持此操作，无论网址指向的是相同的文件还是不同的文件。对于相同的文件，请使用相同的网址。

RCS 商务平台会将文件缓存 60 天，并返回一个唯一名称，您可以在发送客服消息时使用该名称来标识文件。

如需上传文件二进制数据，请向上传 URI 发出 HTTP POST 请求，从 JSON 请求正文中省略 fileUrl 字段，并将二进制数据指定为 POST 请求正文。例如，使用 --upload-file c网址 标志以及二进制文件的完全限定文件路径。

HTTP 请求

  • 上传 URI，用于媒体上传请求：
    POST https://rcsbusinessmessaging.googleapis.com/upload/v1/files
  • 元数据 URI，用于仅涉及元数据的请求：
    POST https://rcsbusinessmessaging.googleapis.com/v1/files

网址采用 gRPC 转码语法。

请求正文

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

JSON 表示法 
{
  "fileUrl": string,
  "thumbnailUrl": string,
  "agentId": string
}
字段
fileUrl

string

可选。文件的可公开访问网址。RCS 商务平台在提取文件时，会根据 HTTP 标头中的 content-type 字段确定文件的 MIME 类型。RCS 商务版支持图片、音频、视频和 PDF。

支持的图片内容类型：image/jpeg、image/jpg、image/gif、image/png。

支持的音频内容类型：audio/aac、audio/mp3、audio/mpeg、audio/mpg、audio/mp4、audio/mp4-latm、audio/3gpp、application/ogg、audio/ogg。

支持的视频内容类型：video/h263、video/m4v、video/mp4、video/mpeg、video/mpeg4、video/webm。

支持的 PDF 内容类型：application/pdf。

注意：文件网址可以包含一个重定向。重定向的文件网址必须可以公开访问。CreateAgentMessageRequest 中的文件网址不支持重定向。
thumbnailUrl

string

可选。与文件对应的缩略图的公开可用网址。如果未设置此字段，RCS 商务平台会自动从文件中生成缩略图。RCS 商务平台在提取文件时会根据 HTTP 标头中的 content-type 字段确定文件的 MIME 类型。

支持的图片内容类型：image/jpeg、image/jpg、image/gif、image/png。
agentId

string

必需。代理的唯一标识符。

响应正文

具有唯一名称的文件资源，代理可以在发送消息时使用该名称来标识文件。

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

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

string

服务器为文件资源分配的唯一名称，代理可以在发送消息时使用该名称来标识文件。格式为“files/{uid}”，其中 {uid} 是唯一 ID。

授权范围

需要以下 OAuth 范围：

  • https://www.googleapis.com/auth/rcsbusinessmessaging

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