メインコンテンツへスキップ
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と生レスポンスを参照してください。
  • その他のリクエストエラーはエラーに記載しています。

関連