Nieuwe metadata in Google Search Console API geeft inzicht in volledigheid van data

De Google Search Console API heeft een nieuwe metadata-veld toegevoegd aan de Search Analytics API. Deze toevoeging biedt extra context over de volledigheid van de gegevens die worden opgehaald met je zoekopdrachten. Dankzij deze metadata kun je nu beter herkennen wanneer de gegevens nog niet volledig zijn, omdat ze nog verwerkt of verzameld worden.

Wat doet de nieuwe metadata?

Het metadata-object wordt in sommige gevallen meegeleverd bij de zoekresultaten en laat zien hoe volledig de gegevens zijn. Dit is vooral handig als je recente data opvraagt met de instelling dataState=all of dataState=hourly_all.

De metadata maakt duidelijk vanaf welk moment de gegevens mogelijk onvolledig zijn, zodat je weet welke delen van je dataset nog kunnen veranderen. Alle tijdstempels in de metadata worden weergegeven in de tijdzone America/Los_Angeles.

Welke metadata velden zijn er?

Afhankelijk van hoe je je data groepeert, kunnen de volgende velden worden teruggegeven:

first_incomplete_date

  • Wordt getoond wanneer data gegroepeerd is op datum en dataState=all is ingesteld.
  • Formaat: JJJJ-MM-DD (ISO 8601).
  • Geeft aan vanaf welke datum de data in de opgevraagde periode mogelijk onvolledig is.
  • Gegevens ná deze datum kunnen nog sterk wijzigen.

first_incomplete_hour

  • Wordt getoond wanneer data gegroepeerd is per uur en dataState=hourly_all is ingesteld.
  • Formaat: JJJJ-MM-DDThh:mm:ss[+|-]hh:mm (ISO 8601 met tijdzone-offset).
  • Geeft aan vanaf welk uur de gegevens mogelijk nog niet volledig zijn.
  • Data na dit tijdstip kunnen nog wijzigen.

Wat heb je hieraan?

Met deze verbetering kun je beter inschatten hoe “vers” en betrouwbaar de gegevens uit de Search Analytics API zijn — vooral voor recente periodes waarin Google nog bezig is met het verzamelen van data. Dit helpt bij het nemen van betere beslissingen op basis van de meest actuele informatie.