lark-slides xml_presentation.slide get

用途

按 slide_id 拉取指定演示文稿单页的 XML 内容（可指定历史版本）。常用于"读-改-写"编辑闭环的第一步。

命令

lark-cli slides xml_presentation.slide get --as user --params '<json_params>'

参数说明

参数	类型	必需	说明
`--params`	JSON string	是	路径参数与查询参数

params JSON 结构

{
  "xml_presentation_id": "slides_example_presentation_id",
  "slide_id": "slide_example_id",
  "revision_id": -1
}

字段	类型	必需	说明
`xml_presentation_id`	string	是	目标演示文稿唯一标识
`slide_id`	string	是	目标页面唯一标识
`revision_id`	integer	否	版本号，`-1` 表示最新版（默认）

使用示例

读最新版本

lark-cli slides xml_presentation.slide get --as user --params '{
  "xml_presentation_id": "slides_example_presentation_id",
  "slide_id": "slide_example_id"
}'

只提取 XML 内容

lark-cli slides xml_presentation.slide get --as user \
  --params '{"xml_presentation_id":"slides_example_presentation_id","slide_id":"slide_example_id"}' \
  | jq -r '.data.slide.content'

读指定历史版本

lark-cli slides xml_presentation.slide get --as user --params '{
  "xml_presentation_id": "slides_example_presentation_id",
  "slide_id": "slide_example_id",
  "revision_id": 42
}'

返回值

{
  "code": 0,
  "data": {
    "slide": {
      "slide_id": "slide_example_id",
      "content": "<slide id=\"slide_example_id\"><style/><data>...</data></slide>"
    },
    "revision_id": 100
  },
  "msg": "success"
}

字段	类型	说明
`data.slide.slide_id`	string	页面唯一标识
`data.slide.content`	string	页面完整 XML（`<slide>` 根节点，不含 xmlns）
`data.revision_id`	integer	此次读到的版本号，可用于后续 replace 的乐观锁

常见错误

错误码	含义	解决方案
404	演示文稿或页面不存在	检查 `xml_presentation_id` / `slide_id`
403	权限不足	需要 `slides:presentation:read` scope，并对该 PPT 有访问权限
400	`revision_id` 不存在	传了无效版本号，用 `-1` 或真实存在的版本号

注意事项

执行前必做：lark-cli schema slides.xml_presentation.slide.get 查看最新参数结构

block_id 提取：返回 XML 里每个顶层块（shape、img、table 等）的 id 属性即为 block_id，通常是 3 字符短码，例如 <shape id="bUn" ...>。用以下命令列出当前页所有 block_id：

lark-cli slides xml_presentation.slide get --as user \
  --params "{\"xml_presentation_id\":\"$PID\",\"slide_id\":\"$SID\"}" \
  | jq -r '.data.slide.content' | grep -oE 'id="[^"]+"' | sed 's/id="//;s/"//'

3.3 KiB Raw Blame History Unescape Escape

lark-slides xml_presentation.slide get

用途

命令

参数说明

params JSON 结构

使用示例

读最新版本

只提取 XML 内容

读指定历史版本

返回值

常见错误

注意事项

相关命令

3.3 KiB

Raw Blame History