Search Analytics API が時間単位のデータに対応

2025 年 4 月 9 日(水曜日)

数か月前、Search Console で最近のパフォーマンス データを表示する方法を改善したことを発表しました。「24 時間」ビューには直近 24 時間分のデータが含まれており、ほんの数時間前のデータが表示されます。このビューを見ると、最近の時間帯で高パフォーマンスを発揮したページやクエリ、最近公開したコンテンツの注目度など、いくつかの情報を確認できます。

本日より、Search Analytics API は時間単位のデータにも対応します。エコシステムの皆様からは、このデータをもっと手軽に利用したいという強い要望をいただいていました。その要望を受けて、API に時間単位のデータを追加し、プロダクト インターフェースよりも広範囲の情報を提供することになりました。プロダクト インターフェースが表示する時間単位のデータは直近の 24 時間分だけですが、API は最大 10 日分の詳細なデータを返すことになります。これにより開発者は、最新 1 日分の時間単位のデータだけでなく、前週の同曜日との比較を表示するソリューションも作成できるようになります。これは、曜日ごとのパターンを分析する際に役立ちます。

Search Analytics API で時間単位のデータを取得する方法

Search Analytics API で時間単位のデータを利用可能にするために、API リクエスト本文に以下 2 つの変更を加えます。

  • レスポンスを時間単位でグループ化するため、新しい ApiDimensionHOUR を指定します。
  • 新しい dataState 値に HOURLY_ALL を指定し、時間単位でグループ化する際に使用します。これにより、時間単位のデータが部分的なものである可能性が示されます。

参考までに、次のセクションで API リクエストと API レスポンスのサンプルを示します。

API リクエストのサンプル

{
  "startDate": "2025-04-07",
  "endDate": "2025-04-07",
  "dataState": "HOURLY_ALL",
  "dimensions": [
    "HOUR"
  ]
}

API レスポンスのサンプル

{
  "rows": [
    {
      "keys": [
        "2025-04-07T00:00:00-07:00"
      ],
      "clicks": 17610,
      "impressions": 1571473,
      "ctr": 0.011206046810858348,
      "position": 10.073871456906991
    },
    {
      "keys": [
        "2025-04-07T01:00:00-07:00"
      ],
      "clicks": 18289,
      "impressions": 1662252,
      "ctr": 0.011002543537321658,
      "position": 9.5440029550272758
    },
    {
      "keys": [
        "2025-04-07T02:00:00-07:00"
      ],
      "clicks": 18548,
      "impressions": 1652038,
      "ctr": 0.011227344649457216,
      "position": 9.81503633693656
    },
    {
      "keys": [
        "2025-04-07T03:00:00-07:00"
      ],
      "clicks": 18931,
      "impressions": 1592716,
      "ctr": 0.01188598595104212,
      "position": 9.4956935197486558
    },
    {
      "keys": [
        "2025-04-07T04:00:00-07:00"
      ],
      "clicks": 20519,
      "impressions": 1595636,
      "ctr": 0.012859449147549943,
      "position": 9.4670100198290843
    },
    
  ],
  "responseAggregationType": "byProperty"
}

この新しいデータを活用することで、最近公開したコンテンツを効果的にモニターし、迅速な対応につなげていただければ幸いです。この新しいビューの効果についてのお客様のご意見や、よりよくするためのご提案をお待ちしております。フィードバック、質問、コメントをご提供いただける場合は、Google の LinkedIn アカウントまたは Google 検索セントラル コミュニティの投稿をご利用ください。