Google-Analysedaten für einen Standort abrufen

Parameter

Pfad

Name	Typ	Erforderlich	Beschreibung
locationId	string	erforderlich	Location ID, either the Base64 Relay id (e.g. TG9jYXRpb246MTgwMDI4OQ==) or the raw numeric database id (e.g. 1800289). Both forms resolve to the same location.

Query

Name	Typ	Erforderlich	Beschreibung	Standard
fromDate	string	optional	Start of the range (YYYY-MM-DD). Defaults to a recent window when omitted.	—
toDate	string	optional	End of the range (YYYY-MM-DD).	—

Antworten

200Daily Google interaction metrics. Each metric is a time-series array; a metric is `null` when no data exists for the range or the profile is not connected.

Response

{  "data": {    "googleInsights": {      "total": [        { "startTime": "2025-06-01T00:00:00+00:00", "value": 412 },        { "startTime": "2025-06-02T00:00:00+00:00", "value": 388 }      ],      "search": [        { "startTime": "2025-06-01T00:00:00+00:00", "value": 300 }      ],      "maps": [        { "startTime": "2025-06-01T00:00:00+00:00", "value": 112 }      ],      "directionsAction": [        { "startTime": "2025-06-01T00:00:00+00:00", "value": 24 }      ],      "phoneAction": [        { "startTime": "2025-06-01T00:00:00+00:00", "value": 8 }      ],      "websiteAction": [        { "startTime": "2025-06-01T00:00:00+00:00", "value": 41 }      ],      "businessBookings": [        { "startTime": "2025-06-01T00:00:00+00:00", "value": 0 }      ],      "businessFoodOrders": [        { "startTime": "2025-06-01T00:00:00+00:00", "value": 0 }      ],      "businessFoodMenuClicks": [        { "startTime": "2025-06-01T00:00:00+00:00", "value": 0 }      ]    }  }}

401Unauthenticated, missing or invalid API key.

Gibt tägliche Interaktionsdaten aus Google Business Profile für einen Standort zurück. Jede Metrik ist ein Array von Zeitreihenpunkten, wobei jeder Punkt einen startTime (den Tag, dem die Anzahl zugeordnet wird) und einen value enthält.

Verfügbare Metriken:

total: Profilimpressionen insgesamt, search plus maps. Die unten aufgeführten Aktionsmetriken sind darin nicht enthalten, daher gilt im obigen Beispiel: 412 = 300 aus der Suche + 112 aus Maps.
search: Impressionen in den Ergebnissen von Google Search (Desktop und Mobilgeräte zusammen)
maps: Impressionen in den Google Maps-Ergebnissen (Desktop und Mobilgeräte zusammen)
directionsAction: Routenanfragen zum Standort
phoneAction: Klicks auf die Anrufschaltfläche
websiteAction: Klicks zur Website
businessBookings: über das Profil gestartete Buchungen
businessFoodOrders: über das Profil aufgegebene Essensbestellungen
businessFoodMenuClicks: Klicks auf den Speisekartenlink

Beide ID-Formate funktionieren im Pfad

Sowohl 1800289 als auch TG9jYXRpb246MTgwMDI4OQ== werden demselben Standort zugeordnet. Verwenden Sie vorzugsweise die Base64-Relay-ID: Sie wird von jedem Leseendpunkt zurückgegeben und ist das Format, das die übrige API akzeptiert. Bei einem Wert, der weder eine Zahl noch eine dekodierbare Relay-ID ist, wird 200 mit dem Antworttext {"data":{"googleInsights":null},"errors":[...]} zurückgegeben, was leicht mit einem Serverfehler verwechselt werden kann.

Shell

curl -s 'https://listingsapi.com/api/v4/locations/TG9jYXRpb246MTgwMDI4OQ==/google-analytics?fromDate=2025-06-01&toDate=2025-06-30' \  -H "Authorization: API $LISTINGSAPI_KEY"

Auswirkungen einer Datenaktualisierung dokumentieren

Ein häufiger Anwendungsfall ist ein Vorher-nachher-Bericht zur Sichtbarkeit: Nachdem Sie Änderungen an den Öffnungszeiten oder Kategorien für einen Standort übertragen haben, fragen Sie google-analytics wiederholt für die Wochen vor und nach der Änderung ab und stellen Sie search + maps grafisch dar, um den Zuwachs zu zeigen. Einzelne Metriken werden als null (anstelle eines leeren Arrays) zurückgegeben, wenn für den Standort im angefragten Zeitraum keine Google-Daten vorliegen oder sein Google-Profil nicht verbunden ist; behandeln Sie null und [] bei Ihrer Aggregation gleich. Kombinieren Sie diese Daten mit den Analysedaten von Facebook und Bing, um eine plattformübergreifende Ansicht zu erhalten.