Part

Part 表示一段通信内容的容器。内容可以是纯文本、某种类型的文件(图片、视频等)或结构化数据 blob(即 JSON)。

JSON 表示法
{
  "metadata": {
    object
  },
  "filename": string,
  "mediaType": string,

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "text": string,
  "raw": string,
  "url": string,
  "data": value
  // End of mutually exclusive fields.
}
字段
metadata

object (Struct format)

可选。与相应部分相关联的元数据。

filename

string

文件的可选 filename(例如“document.pdf”)。

mediaType

string

相应部分内容的 mediaType(MIME 类型),例如“text/plain”“application/json”“image/png”。此字段适用于所有部件类型。

以下是互斥字段的列表。在响应中,最多只能设置以下字段之一:
text

string

text 部分的字符串内容。

raw

string (bytes format)

文件的 raw 字节内容。在 JSON 序列化中,此值编码为 base64 字符串。

使用 base64 编码的字符串。

url

string

指向文件内容的 url。

data

value (Value format)

任意结构化 data,以 JSON 值(对象、数组、字符串、数字、布尔值或 null)的形式表示。

互斥字段的结束。