メインコンテンツへスキップ
POST
検索ジョブにフィードバックを送信
search の結果を使用した後、または役に立たなかった場合は、検索フィードバックを送信してください。フィードバックを送信すると結果の品質向上に役立ち、チームの上限内であれば、検索ジョブに対する最初のフィードバック送信に対して 1 クレジットが返金される場合があります。 valuableResults を使用すると、有用な結果をレスポンス内の表示位置で指定できます。各グループはそれぞれ独立して 1 から番号が振られるため、各エントリには source グループ (web、images、news のいずれか) と、そのグループ内での結果の位置 (1 始まり) を表す position を指定します。有用な結果はすべて列挙してください。列挙されなかった結果は有用でないものとして扱われ、グループが返した件数を超える位置は無視されます。この方法は、url を持たないニュースや画像の結果にも使えます。有用な URL を指定するには valuableSources を使用します。返された結果に含まれていなかった 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