跳转到主要内容
POST
提交搜索任务反馈
在使用了 search 结果后,或结果未能提供帮助时,可使用搜索反馈。反馈可提升结果质量,并且针对某个搜索任务首次提交反馈时可退还 1 个额度,具体取决于团队限制。 使用 valuableResults,根据结果在响应中出现的位置标记有用的结果。每个条目需指明 source 分组 (web、images 或 news) ,以及该结果在分组内的 position (从 1 开始计数) ,因为各分组均独立从 1 开始编号。请列出所有有用的结果:未列出的结果将被视为无用,超出分组实际返回数量的位置会被忽略。该方式同样适用于没有 url 的新闻和图片结果。使用 valuableSources 标记有用的 URL,包括未出现在返回结果中的 URL。

请求示例

授权

Authorization
string
header
必填

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

路径参数

jobId
string<uuid>
必填

由 /search 返回的搜索任务 ID。

请求体

application/json

若为“good”,请包含 valuableSources 或 valuableResults。若为“partial”,请包含 valuableSources、valuableResults 或 missingContent。若为“bad”,请包含 missingContent 或 querySuggestions。

rating
enum<string>
必填
可用选项:
good,
partial,
bad
integration
string | null
missingContent
object[]
Maximum array length: 20
origin
string
默认值:api
querySuggestions
string
Maximum string length: 2000
valuableResults
object[]

有用的结果,每项结果由其所在的 data 分组及其在组内的位置(从 1 开始编号)指定。结果按组返回(data.web、data.images、data.news),各组均独立从 1 开始编号,因此 source 为必填项。请列出所有有用的结果;未列出的结果将被视为无用。超出该组实际返回结果数量的位置将被忽略。

Maximum array length: 50
valuableSources
object[]
Maximum array length: 50

响应

反馈已记录

creditsRefunded
number
必填
feedbackId
string<uuid>
必填
success
boolean
必填
示例:

true

alreadySubmitted
boolean
creditsRefundedToday
number
dailyCapReached
boolean
dailyRefundCap
number
warning
string