Referenz der Interaktionsattribute

Interaktionsobjekte werden von Interaktionen für einen Standort auflisten, Zusammengefasste Interaktionen abrufen und Interaktionen anhand von IDs abrufen zurückgegeben. Die beiden paginierten Endpunkte betten sie in eine Verbindung im Relay-Stil ein: data.interactions (pro Standort) und data.rollupInteractions (kontoweite Zusammenfassung) enthalten jeweils edges[].node, pageInfo und totalCount. Beim Abrufen anhand von IDs erfolgt keine Paginierung; data.interactionDetails ist ein einfaches { "interactions": [ ... ] }-Objekt ohne edges, pageInfo oder totalCount.

Interaktionsfelder

Feld	Typ	Beschreibung
id	String	Die UUID der Interaktion. Übergeben Sie sie beim Antworten als `interactionId`
interactionId	String	Dieselbe UUID wie `id`
source	String	Hostname der Bewertungswebsite oder des sozialen Netzwerks (e.g, `maps.google.com`, `yelp.com`)
title	String	Titel der Interaktion, sofern die Quelle einen bereitstellt
content	String	Text der Bewertung oder des Beitrags
authorName	String	Anzeigename des Verfassers
rating	Integer	Sternebewertung, 1–5 (nur bei Bewertungen)
date	String	Zeitstempel der Interaktion im Format ISO 8601
permalink	String	Direkter Link zur Interaktion auf der Quellwebsite
category	String	Übergeordnete Kategorie, e.g, `Review` oder `Social`
type	String	Spezifischer Interaktionstyp, `Review`, `Question`, `Comment`, `Recommendation`, `Post`, `Photo`, `Message`, `Response`
responded	Boolean	Gibt an, ob eine Antwort des Inhabers vorhanden ist
notes	String	Private Notizen des Kontoinhabers
responses	Array	Dieser Interaktion zugeordnete Antworten des Inhabers (siehe unten)
responseCount	Integer	Anzahl der zugeordneten Antworten
canRespond	Boolean	Gibt an, ob für diese Quelle eine Antwort über Listings API veröffentlicht werden kann
locationId	Integer	Numerische Datenbank-ID des Standorts, zu dem die Interaktion gehört
flaggedReason	String	Grund für die Markierung der Interaktion, falls vorhanden

Felder des Antwortobjekts

Jedes Element im responses-Array einer Interaktion (und das von Auf eine Interaktion antworten zurückgegebene Objekt):

Feld	Typ	Beschreibung
id	String	Eindeutige Antwort-ID (beim Bearbeiten oder Archivieren als `responseId` übergeben)
interactionId	String	ID der Interaktion, zu der diese Antwort gehört
content	String	Text der Antwort
authorName	String	Name, der als Verfasser der Antwort angezeigt wird
date	String	Zeitstempel der Erstellung der Antwort
respondedWith	String	ID der verwendeten Antwortvorlage, falls vorhanden
respondedBy	Integer	Listings API-Benutzer-ID des Benutzers, der die Antwort übermittelt hat
interactionStatus	String	Lebenszyklusstatus, `CREATED`, `FAILED`, `COMPLETED` oder `CONFIRMED`
editedResponse	Boolean	Gibt an, ob diese Antwort seit ihrer ersten Veröffentlichung bearbeitet wurde
remarks	String	Systemanmerkungen (e.g, Fehlerdetails)

Statusablauf einer Antwort

Das Feld interactionStatus verfolgt den Status einer Antwort bei ihrer Veröffentlichung auf der Quellwebsite:

CREATED → COMPLETED: auf der Plattform veröffentlicht; auf dieser Plattform ist keine zusätzliche Bestätigung verfügbar
CREATED → COMPLETED → CONFIRMED: veröffentlicht und anschließend von der Plattform bestätigt
CREATED → FAILED: Übermittlung an die Plattform war nicht erfolgreich; siehe remarks

Enum-Werte für Filter

Die paginierten Endpunkte akzeptieren diese Enum-Werte als Filter:

responseStatus: RESPONDED, PENDING
sortOrder: NEWEST_FIRST, OLDEST_FIRST, LAST_RESPONDED
category: REVIEW (und weitere übergeordnete Kategorien, die pro Konto bereitgestellt werden)