Datapoints spielen eine wichtige Rolle beim Verständnis des Kundenfeedbacks für bestimmte Standorte, Dienstleistungen und Produkte. Datapoints können Fotos, Bewertungen, Antworten auf Bewertungen und Check-ins sein. Diese Informationen können mit dem API-Endpunkt /api/data-points abgerufen und dann bestimmten Standorten zugeordnet oder gefiltert werden. Die vollständige API-Dokumentation zu Datapoints finden Sie hier im Abschnitt Datapoints.
Das Zuordnen von Datapoints zu Standorten erfolgt in zwei Schritten.
Abrufen einer Liste von Standorten
Das Abrufen einer Liste von Standorten vor den Datapoints ermöglicht es, diese Datapoints speziell für die gewünschten Standorte abzurufen, anstatt alle Datapoints abrufen und dann nach Standort sortieren und filtern zu müssen. Für die Zuordnung zwischen Datapoint und Standort muss die Standort-ID von der API abgerufen werden.
Das folgende Beispiel, in Übereinstimmung mit diesem , gibt eine vollständige Liste der Standorte für das Girokonto. Diese Orte werden mit den folgenden Daten zurückgegeben, die mit den fieldMask-Parametern definiert wurden: ID, Kennung, Name, Straße und Hausnummer, Postleitzahl, Ort.
GET https://uberall.com/api/locations?fieldMask=identifier&fieldMask&name&fieldMask=streetAndNumber&fieldMask=zip&fieldMask=city Überschriften = { "privateKey": "YOUR_PRIVATE_KEY_HERE" }
Abrufen einer Liste von Datapoints
Datapoints können alle auf einmal oder pro Standort abgerufen werden. Parameter und Filter finden Sie hier .
Abrufen von Datapoints für alle Standorte
Holen Sie sich https://uberall.com/api/data-points Überschriften = { "privateKey": "YOUR_PRIVATE_KEY_HERE" }
Abrufen von Datapoints für einen bestimmten Standort
Holen Sie sich https://uberall.com/api/data-points /LOCATION_ID_HERE Überschriften = { "privateKey": "YOUR_PRIVATE_KEY_HERE" }
Data Points API-Antworten enthalten ein locationId- Attribut, das direkt mit der ID eines Standortobjekts verknüpft werden kann.
Um Standorte und Datapoints miteinander zu verknüpfen, ist die Verwendung einer Schleife erforderlich. Je nachdem, wie die Datapoints abgerufen werden, wird ein anderer Ansatz für die Schleife gewählt.
Zuerst abgerufene Standorte und gesammelte Datapoints nach Standort
Nachdem die vollständige Liste der Standorte abgerufen wurde, durchläuft eine Schleife die Liste und führt einen API-Aufruf aus, um alle Datapoints für einen bestimmten Standort abzurufen. Wiederholen Sie diesen Vorgang, bis Datapoints für alle Standorte abgerufen wurden.
Datapoints auf einmal abgerufen
Wenn sowohl die vollständige Liste der Standorte als auch die abgerufenen Datapoints abgerufen wurden, durchlaufen Sie die Standorte und suchen Sie die mit der Standort-ID verknüpften Datapoints. Wiederholen Sie diesen Vorgang, bis alle Standorte ihre Datapoints haben.
Die Info
Für bestimmte Parameter können Zeitstempel verwendet werden. Diese Zeitstempel müssen im UNIX-Millisekundenformat vorliegen, damit sie erkannt werden. Beispiel: