上传虚拟后台文件

使用此API [上传虚拟背景文件](https://support.zoom.us/hc/en-us/articles/210707503-虚拟背景 # h_01EJF3YFEWGT8YA0ZJ079JEDQE) 供组中的所有用户使用。

** 先决条件: **

必须在帐户上启用 [虚拟背景功能](https://support.zoom.us/hc/en-us/articles/210707503-虚拟背景 # h_2ef28080-fce9-4ac2-b567-dc958afab1b7)。

** 范围: ** 'group:master'

** [速率限制标签](https://marketplace.zoom.us/docs/api-reference/Rate-limits # 速率限制):** 'MEDIUM'

请求参数

Path 参数

groupId

string

必需

组ID。要获取组的ID，请使用 [** List groups **](/api-reference/zoom-api/methops # operation/groups) api。

accountId

string

帐户的唯一标识符。

必需

Body 参数multipart/form-data

file

string

可选

虚拟背景文件的路径。

示例值:

binary

返回响应

🟢201** HTTP状态代码: ** '201' 已创建

application/json

Body

有关虚拟背景文件的信息。

size

integer

可选

文件的大小 (以字节为单位)。

示例值:

7221

name

string

文件的名称。

可选

示例值:

San Francisco

string

文件的ID。

可选

示例值:

6SEYvTU4SuG257lOHuJKOQ

is_default

boolean

可选

文件是否为默认虚拟背景文件。

示例值:

true

type

string

文件类型。

可选

示例值:

image

示例

{
    "size": 7221,
    "name": "San Francisco",
    "id": "6SEYvTU4SuG257lOHuJKOQ",
    "is_default": true,
    "type": "image"
}

🟠400** HTTP状态代码: ** '400' 错误的请求 ** 错误代码: ** '120' 未上载文件，请验证是否已上载文件。 文件大小不能超过15m。 一个用户最多允许10个文件。 只能上传jpg/jpeg或png图像文件。

🟠404** HTTP状态代码: ** '404' 未找到 ** 错误代码: ** '1001' 用户不存在。 用户 {email} 不存在或不属于此帐户。

请求参数

示例代码

返回响应