コンテンツにスキップ

キャッシュとフレッシュネス

同一のクエリはキャッシュされるため、たった今取得されたばかりの結果に対して全額を支払う(または待つ)必要はありません。 リクエストがキャッシュから提供されたかどうかは常に stats.cached で報告され、それがコストを決定します。

キャッシュヒット対フレッシュ取得

Section titled “キャッシュヒット対フレッシュ取得”
ソースstats.cachedクレジットレイテンシ
キャッシュヒットtrue3100ms未満
フレッシュ取得false6レジデンシャルプロキシ経由のライブ取得

結果は クエリ + 国 (gl) + 言語 (hl) + 時間フィルタ (tbs) + ページ の正確な組み合わせによって キャッシュ可能です — そのいずれかを変更すると別のキャッシュエントリになります。クレジットモデルについては 料金とクレジット を参照してください。

リクエストごとのフレッシュネス制御

Section titled “リクエストごとのフレッシュネス制御”

オプションの freshness パラメータを使うと、単一のリクエストがキャッシュをどう扱うかを選択できます:

freshness動作
default最近のキャッシュ結果が存在すればそれを提供し、なければフレッシュ取得します。(デフォルト)
realtime常にフレッシュ取得 — キャッシュをバイパスします。フレッシュ料金(6クレジット)が課金されます。
cachedキャッシュ結果を優先します。
{ "q": "nvidia stock price", "freshness": "realtime" }