Skip to main content
将一个已完成的 AI 回答与其引用的来源进行比对。结果是一张紧凑的对应图:结果中包含的每个来源页面的段落、 它们对应的回答部分、每条关联的说明,以及由这些关联生成的简短总结。 这是对已有回答的事后对应分析,不能证明某个来源促使模型生成了某句话,也不是对页面质量的评分。 请把它当作需要检查的证据,而不是结论。
轮询 GET /v1/async/task/:id,或在提交时提供 webhook.url;任务报告为 taskType: "SOURCE_INFLUENCE"。 不要通过 POST /v1/async/task 提交此分析,请使用专用端点。POST /v1/research 和 CITATION_ATTRIBUTION 任务类型是 2026 年 9 月之前的名称,作为已弃用别名仍然可用。

分析你已运行过的任务

如果回答来自本 API,请直接发送它的任务 id,而不是从结果中复制回答和引用:
该任务必须属于你、状态为 COMPLETED,并且仍可通过 GET /v1/async/task/:id 读取。它的回答 Markdown(引擎未返回 Markdown 时为文本)成为 answer,其引用 URL 按引擎顺序成为 citations:取前 100 个,其中讨论帖最多 10 个。 商品和视频卡片占位符(googleusercontent.com 链接)以及 Google 搜索链接会被跳过,因为它们没有可读取的页面。 除非你另行发送,否则使用该任务的 prompt、country 和引擎。将 taskId 与 answer 或 citations 一起发送会以 400 拒绝;未完成、没有回答文本或引用 URL 的任务同样如此。未知或已过期的任务 id 返回 404。

Payload

analysis 选项已停用。 早期版本接受 analysis: {version: 1, …}。现在每个结果都包含洞察,因此该字段不会被忽略,而是以 400 拒绝。 请从现有集成中移除它。已有任务内容仍可读取;已存储的记录不会迁移。

结果

answer

原样返回你提交的回答。answerRanges 是这个字符串的偏移量:JavaScript UTF-16 码元,start 包含,end 不包含。 请直接截取,即 answer.slice(start, end),不要重新切分文本。每个范围都对应回答中一个完整的语义单元:句子、 列表项或表格单元格,边界以原文为准。

sources[]:你发送的每条引用对应一项

  • id:不透明标识符,在结果内唯一。
  • url:你提供的引用 URL。
  • paragraphs[]:结果中包含的该页面段落。每个段落有一个 id(在整个结果中全局唯一)和段落 text。 段落也可能在没有任何关联的情况下被包含。
  • error:仅在页面无法读取时出现。此时 paragraphs 为空,字符串是该来源的简短原因。

links[]:每个段落一条关系

  • paragraphId:这条关联所指的段落,始终指向 sources[] 中存在的段落。
  • answerRanges[]:该段落对应的回答部分,以与上文相同的 UTF-16 偏移量给出 start/end 对。一条关联可以有多个 范围,同一段回答文本不会在范围之间重复。每个范围都是完整的回答单元(句子、列表项或表格单元格)。
  • explanation:描述对应关系的一句简短说明:该段落对回答的这一部分说了什么。

insights[]

对本结果中各条关联整体含义的简短总结。linkIds 指明每条总结所依据的关联,且只能指向 links[] 中出现的关联, 洞察绝不会声称响应中不存在的关系。没有关联时,也就没有可供总结的内容。

正确解读结果

  • 没有关联不是结论。 没有关联的段落只是没有匹配到回答范围;没有范围的回答部分只是没有段落与之关联。 两者都不说明页面无关、未被使用或不可信。
  • 未读取的页面仍属未知。 设置了 sources[].error 时,该引用已被排除在分析之外,不要把它缺少关联当作否定结论。 如果它重要,请重试或提供其 body。
  • 是对应而非因果。 结果描述的是已有回答与已有页面文本在事后如何对应。它不衡量对生成的影响,不对页面排序或 评分,也不报告回答是如何生成的。
  • id 仅供内部使用。 不要把 p…/l… 标识符当作跨运行的稳定键保存;它们只在单个结果内有效。

执行与限制

  • 规模不会导致失败。 请求协议接受的一切,即最多 200,000 个字符的 answer 与最多 100 条引用,都会被分析。 长回答、大量来源和超长页面会通过拆分工作来处理,而不是拒绝任务。
  • 深度取决于回答,而非页面。 长页面不会产生比回答所能支撑的更多关联:分析集中在最可能与回答对应的段落, 并且每个显示出对应关系的来源都会出现在结果中。对于大页面,或在导航、列表和评论中重复同一陈述的页面, 预期得到的是最有力的段落,而不是每一次出现。
  • 标记不是证据。 站点地图、链接索引和图片库不产生关联;仅由这些构成的页面会以无段落的形式报告,而不是编造对应关系。
  • 如果还有其他可读来源,无法读取的来源会在 sources[].error 中报告,任务不会失败。当没有任何来源可读、 分析失败、超时或服务配置错误时,任务失败。
  • 请求与 API 其余部分一样按用量计量。提交响应显示临时额度冻结;最终费用在任务进入终止状态时结算。