在调用 Power BI REST API 导出分页报表时，若需为同一参数传递多个值（如按多个城市分别生成页面），不可使用数组字符串或逗号分隔格式，而应重复添加同名参数对象——即在 parameterValues 数组中多次包含相同 name、不同 value 的键值对。
在调用 power bi rest api 导出分页报表时，若需为同一参数传递多个值（如按多个城市分别生成页面），**不可使用数组字符串或逗号分隔格式，而应重复添加同名参数对象**——即在 `parametervalues` 数组中多次包含相同 `name`、不同 `value` 的键值对。
Power BI 分页报表（Paginated Report）支持多值参数（Multi-value Parameters），但在通过 REST API（如 ExportReport 或 ExportPaginatedReport）触发导出时，其参数结构有明确约束：API 不接受 JSON 数组作为单个参数的 value 字段值，也不支持将多个值拼接为字符串（如 "WA,OR,CA" 或 ["WA","OR","CA"]）。正确的做法是——将同一个参数名（如 "City"）多次声明为独立的对象项，每个对象携带一个独立的 value。
例如，若需为参数 MultiValParam3 传入 "Value1"、"Value2" 和 "Value3"，应在 parameterValues 数组中写为：
{
"format": "PDF",
"paginatedReportConfiguration": {
"parameterValues": [
{"name": "Param1", "value": "Value1"},
{"name": "Param2", "value": "Value2"},
{"name": "Date", "value": "05/20/2013"},
{"name": "MultiValParam3", "value": "Value1"},
{"name": "MultiValParam3", "value": "Value2"},
{"name": "MultiValParam3", "value": "Value3"}
]
}
}
✅ 此结构会触发 Power BI 服务为 MultiValParam3 的每个值单独渲染一页（或一组页面），最终 PDF 将按顺序包含所有匹配结果页。
⚠️ 注意事项：
- 参数名（
name）必须与报表中定义的参数完全一致（大小写敏感）； - 不可嵌套数组、不支持
value: ["A","B"]或value: "A,B"—— 这类写法会导致400 Bad Request并提示 “The parameter value is not valid”； - 若参数类型为日期、数字等，请确保
value字符串格式符合报表预期（如日期建议使用 ISO 格式"2023-05-20"，避免区域格式歧义）； - 多值参数行为依赖报表设计：请确认报表中该参数已启用“允许多个值”（Allow multiple values），且报表主体逻辑（如 Tablix 过滤器）已适配多值处理。
总结：Power BI REST API 的多值参数本质是“逻辑复用”，而非“数据聚合”。只需在 parameterValues 列表中平铺多个同名参数对象，即可实现分页级参数遍历——简洁、明确，且与 Power BI 服务端解析机制严格对齐。
大量免费API接口：立即使用
涵盖生活服务API、金融科技API、企业工商API、等相关的API接口服务。免费API接口可安全、合规地连接上下游，为数据API应用能力赋能！
