Interfejs Search Analytics API obsługuje teraz dane godzinowe

Środa, 9 kwietnia 2025 roku

Kilka miesięcy temu informowaliśmy o ulepszonym sposobie wyświetlania ostatnich danych o skuteczności w Search Console. Widok „24 godziny” zawiera dane z ostatnich 24 godzin i wyświetla się z opóźnieniem zaledwie kilku godzin. W tym widoku możesz sprawdzić, które strony i zapytania radziły sobie w ostatnim czasie oraz jak radziły sobie ostatnio opublikowane przez Ciebie treści.

Dzisiaj dodajemy do interfejsu Search Analytics API obsługę danych godzinowych, ponieważ usłyszeliśmy wyraźne prośby o ułatwienie dostępu do tych danych. Dlatego dodajemy do interfejsu API dane godzinowe w szerszym zakresie niż w interfejsie usługi: podczas gdy usługa wyświetla dane godzinowe tylko z ostatnich 24 godzin, interfejs API zwraca dane z okresu do 10 dni z podziałem na godziny. Dzięki temu deweloperzy będą mogli tworzyć rozwiązania, które będą pokazywać nie tylko dane godzinowe za ostatni dzień, ale też umożliwiać porównanie tego dnia z tym samym dniem w poprzednim tygodniu. Może to być przydatne przy analizowaniu wzorów dotyczących dni tygodnia.

Jak pobierać dane godzinowe z Search Analytics API

Aby udostępnić dane godzinowe w Search Analytics API, wprowadzamy 2 zmiany w treści żądania do interfejsu API:

• Nową wartość ApiDimension o nazwie HOUR, aby grupować odpowiedzi według godziny.
• Nową wartość dataState o nazwie HOURLY_ALL, której należy używać podczas grupowania według godziny. Wskazuje ona, że dane godzinowe mogą być częściowe.

W następnej sekcji znajdziesz przykładowe żądanie do interfejsu API i przykładową odpowiedź.

Przykładowe żądanie do interfejsu API

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

Przykładowa odpowiedź interfejsu 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"
}

Mamy nadzieję, że te nowe dane pomogą Ci skuteczniej monitorować ostatnio opublikowane treści oraz podejmować skuteczne działania w odpowiednim czasie. Chętnie poznamy Twoją opinię na temat tego, jak nowe widoki się sprawdzają, a także Twoje sugestie dotyczące tego, jak je jeszcze ulepszyć. Jeśli chcesz podzielić się opinią, zadać pytanie lub zgłosić uwagi, odwiedź naszą stronę na LinkedIn lub opublikuj posta na Forum pomocy Centrum wyszukiwarki Google.

Autorzy: Tali Pruss, Software Engineer, i Daniel Waisberg, Search Advocate