按标签查询产品与产品组

部分只读查询及 Excel 导出函数支持用 tag="标签名称" 或 tag_id="标签ID" 指定对象范围。范围为当前登录用户和工作空间下，标签直接绑定的产品、产品组；产品组不会在标签解析时自动展开为成员产品。

这里的业务标签与产品对象的 label 属性（如 live、paper）不同。调用前仍须登录并选定正确的工作空间，且标签关联对象必须允许当前用户读取。

各函数的标签参数和返回形式也标在 API 文档的对应条目中；本页汇总通用规则与调用示例。

调用示例

import rqamsc

# 先按项目现有方式登录，并选择标签所在的工作空间。
rqamsc.init(username="用户名", password="密码", uri="RQAMS 地址")
rqamsc.choose_workspace("工作空间名称")

# 单对象原函数会逐个查询标签中的产品，返回以产品 ID 为键的字典。
products_by_id = rqamsc.get_product(tag="策略A")
for product_id, product in products_by_id.items():
    print(product_id, product.name)

# 产品与产品组通用的指标接口保留原日期参数。
indicators_by_id = rqamsc.get_indicators(
    tag_id="标签ID", start_date="2026-10-01", end_date="2026-10-15"
)

# 原本支持多对象范围的全景函数仍只调用一次原接口，返回原结果结构。
overview = rqamsc.get_investment_overview_summary_indicator(
    tag="策略A", start_date="2026-10-01", end_date="2026-10-15"
)

# 两条导出接口分别生成一份 Excel，返回本地文件路径。
snapshot_file = rqamsc.download_asset_snapshot_overview_file(
    report_save_path="/path/to/reports", tag="策略A",
    params={"previous_trading_day": True}
)
overview_file = rqamsc.download_product_group_overview_file(
    report_save_path="/path/to/reports", tag_id="标签ID",
    params={"start_date": "2026-10-01", "end_date": "2026-10-15"}
)

tag 与 tag_id 二选一，不能与原产品/产品组 ID 或范围参数同时传入。无标签调用仍使用原参数和返回值。装饰器支持上述标签关键字，但部分函数的 inspect.signature 仍显示原本必填的 ID 参数；按这里的示例调用即可。

导出前请确保 report_save_path 指向已存在的文件夹。两条接口分别保存为 asset_snapshot_overview.xlsx 和 product_group_overview.xlsx；同名文件会被覆盖。params 只用于原接口的其他业务参数，不能再放产品范围、标签或任务号。组合全景导出未指定结束日期时使用当天，未指定开始日期时使用结束日期前 90 天。

支持的只读函数

原接口形态	函数	标签调用的结果
单产品	get_product	{产品ID: Product}，只取标签直接绑定的产品
单产品组	get_product_group	{产品组ID: ProductGroup}，只取标签直接绑定的产品组
单产品或产品组	get_indicators、get_indicators_series、get_balance、get_balance_series、get_asset_snapshot	{ID: 对应原函数返回值}
多对象投资驾驶舱	get_investment_overview_summary_indicator、get_investment_overview_returns_series、get_investment_overview_asset_capital_size、get_investment_overview_asset_allocation、get_investment_overview_excess_correlation、get_investment_overview_returns_correlation	将适用 ID 传入原多对象范围，原接口只请求一次，返回结构不变
Excel 导出	download_asset_snapshot_overview_file、download_product_group_overview_file	分别按适用 ID 生成持仓概览或组合全景 Excel，返回本地文件路径；原接口各请求一次
对象列表	list_products、list_product_groups	调用原列表接口后按标签绑定 ID 过滤，返回原对象列表

单对象标签调用会对每个适用 ID 调用一次原函数。多对象投资驾驶舱和 Excel 导出接口最多接受 80 个适用 ID；产品列表标签过滤最多接受 500 个产品 ID。产品组列表和单对象标签查询没有默认对象数上限，调用耗时仍会随对象数增加。

空标签和错误处理

• 标签不存在、标签名称不唯一、ID 类型冲突，或标签与显式对象范围同传时抛出异常。
• 标签没有当前函数适用的对象时，单对象函数返回 {}，列表函数返回 []；多对象投资驾驶舱和 Excel 导出函数抛出空范围错误。
• 任一单对象原请求失败时，整个标签调用抛出该错误，不返回已完成的部分字典。
• 标签绑定只说明关联关系，不代表对象一定存在或当前用户有权读取。列表接口发现绑定对象不在原列表时会报错；多对象查询或 Excel 导出若成功但静默遗漏对象，客户端无法独立证明结果完整。

写入、重算及未列在上表中的函数不支持标签参数。直接调用 OpenAPI HTTP 接口时，也不支持以 tag 或 tag_id 查询。