Interaktionen anhand von IDs abrufen

Name	Typ	Erforderlich	Beschreibung	Standard
interactionIds	string	erforderlich	JSON-encoded array of interaction IDs to fetch, e.g. `["b2fa765e-c62b-4e0b-b1d6-1c67c855f5e0"]`. Passed as a URL-encoded JSON string.	—

Name

Typ

Erforderlich

Beschreibung

Standard

interactionIds

string

erforderlich

JSON-encoded array of interaction IDs to fetch, e.g. `["b2fa765e-c62b-4e0b-b1d6-1c67c855f5e0"]`. Passed as a URL-encoded JSON string.

—

Antworten

200Interaction details for the requested IDs. `data.interactionDetails.interactions` holds the array.

Response

{  "data": {    "interactionDetails": {      "interactions": [        {          "id": "b2fa765e-c62b-4e0b-b1d6-1c67c855f5e0",          "source": "maps.google.com",          "content": "Great place for dessert!",          "authorName": "Jordan M.",          "category": "Review",          "type": "Review",          "rating": 5,          "date": "2026-05-12T09:22:41+00:00",          "responded": true,          "responseCount": 1,          "canRespond": true,          "responses": [            {              "id": "2090753a-ece6-4837-8336-8494ad308523",              "content": "Thank you so much for the kind words!",              "authorName": "Jenny Home",              "date": "2026-05-13T14:02:00+00:00",              "interactionStatus": "CONFIRMED",              "editedResponse": false            }          ]        }      ]    }  }}

401Unauthenticated, missing or invalid API key.

Ruft vollständige Interaktionsdetails für eine oder mehrere bestimmte Interaktions-IDs ab. Nützlich, wenn Sie Interaktions-IDs gespeichert haben und aktuelle Daten dazu benötigen, ohne die gesamte Interaktionsliste seitenweise durchlaufen zu müssen. Der Antworttext ist data.interactionDetails.interactions, ein Array von Interaktionsobjekten (siehe die Referenz der Interaktionsattribute).

Übergeben Sie interactionIds als URL-kodiertes JSON-Array. Wenn eine ID nicht zu Ihrem Konto gehört, gibt der Endpunkt 200 zurück, wobei data.interactionDetails auf null gesetzt ist und ein errors-Array enthalten ist (e.g. SY90001: Not Authorized to access this resource); wenn Sie den Parameter vollständig weglassen, wird SY90006 zurückgegeben.

Anwendungsfall: Eine gespeicherte Beobachtungsliste mit vollständigen Daten aktualisieren

Wenn Sie ein Benachrichtigungssystem entwickeln, das Interaktions-IDs speichert (zum Beispiel für Bewertungen, die ein Benutzer mit einem Stern markiert hat), rufen Sie diesen Endpunkt regelmäßig auf, um die zugehörigen vollständigen Daten erneut abzurufen und neu vom Inhaber veröffentlichte responses oder eine Änderung des Flags responded zu erkennen, ohne die gesamte Bewertungsliste erneut durchsuchen zu müssen. Der hier zurückgegebene Wert responses[].id ist der Wert responseId, den Sie an Eine Antwort bearbeiten oder Eine Antwort archivieren übergeben.

Parameter

Query

Antworten

Anwendungsfall: Eine gespeicherte Beobachtungsliste mit vollständigen Daten aktualisieren