GOOGLE_NEWS は、検索に対して Google 検索の「ニュース」タブが表示する記事のリストを返します。約10件の記事が入ったページを最大10ページ読み、ページをまたいで Google の順序を保つため、あるトピック、ブランド、競合について Google がどの媒体を表示するか、その変化を追跡できます。
リクエスト
次のリクエストは、米国で電気自動車の関税を検索したときのニュースタブの最初の2ページを取得します。パラメータ
レスポンス
たとえば、上のリクエストの結果です。pages に届く前に Google のリストが終わると、newsResults には Google が表示したすべての記事が入り、pages は読んだページ数を数えます。position、title、link、page 以外はすべて任意フィールドとして扱ってください。
クレジット
読んだニュースページごとに1クレジットです。タスクの開始時に、指定したページ数のクレジットを確保します。既定値では1、pages: 10 では10です。完了時には実際に読んだページ数だけ課金するため、Google のリストが3ページで終われば3クレジットです。失敗したタスクは0です。クレジットと上限を参照してください。
制限とエラー
- 完了したタスクで
newsResultsが空なら、Google がその検索に記事を1件も表示しなかったことを意味します。返す前に別のブラウザで再確認しており、1クレジットが課金されます。 en、de、pt-BRのような言語コードでないhlは422 VALIDATION_ERRORを返します。- 1〜10の範囲外の
pages、desktop・mobile・android以外のdeviceは422 VALIDATION_ERRORを返します。 stateとuuleは422 LOCATION_UNSUPPORTEDを返します。市場はcountryで指定してください。include.rawResponseは効果がなく、include.htmlとinclude.analysisは422を返します。Markdownと生レスポンスを参照してください。- その他のリクエストエラーはエラーに記載しています。
関連
- Google 検索: オーガニック検索結果を含む結果ページを1ページ分
- Google リダイレクトの解決
- クレジットと上限