**版本：202601**

# 更新主题全局配置

**PATCH** `/openapi/2026-01/themes/edit-sessions/:oseid/files/:doc_id/global`

局部更新编辑会话内主题的全局配置：只传要改的设置项（一条或多条）。默认更新主题设置；传 `section_id` 可更新页头、页尾、公告栏、购物车抽屉等全局卡片。

## 请求

**Path参数**

- `oseid` string (required)

  编辑会话 ID
- `doc_id` string (required)

  文档（模板文件）ID

**application/json**

**请求体 | 示例**

**请求体 (required)**

- `settings` object (required)

  要修改的设置项——局部更新，一条或多条键值对；未传的设置保持不变
- `section_id` string

  更新目标：不传或 `skin` = 全局变量；否则传全局 section 的 type 或存储 id —— 既可以是全局单例（`header`、`footer`、`announcement`、`cart_drawer`），也可以是页头 / 页尾区域内的任一成员；传入会话中不存在的值返回 400
- `template_name` string

  渲染上下文模板名，默认 `index`
- `locale` string

  渲染语言，默认 `en_US`

```json
{
  "settings": {},
  "section_id": "string",
  "template_name": "string",
  "locale": "string"
}
```

## 响应

**200**

OK

**application/json**

**数据结构 | 示例**

**数据结构**

- `code` string

  错误码
- `message` string

  错误信息
- `data` object

  - `section` object

    更新后的存储对象（skin 时为回显的已改设置项）
  - `html` string

    全局卡片返回渲染 HTML；skin 无渲染，为空

```json
{
  "code": "string",
  "message": "string",
  "data": {
    "section": {},
    "html": "string"
  }
}
```