Aggregierte Interaktionen abrufen

Parameter

Query

Name	Typ	Erforderlich	Beschreibung	Standard
tag	string	optional	Location tag to scope the rollup to. Defaults to `all`, every location the key can see. Omit it unless you tag locations.	all
siteUrls	string	optional	JSON-encoded array of publisher hostnames to include.	—
startDate	string	optional	Start of the date-range filter (YYYY-MM-DD).	—
endDate	string	optional	End of the date-range filter (YYYY-MM-DD).	—
searchString	string	optional	Full-text search across interaction content.	—
category	string	optional	Single interaction category, e.g. `REVIEW`.	—
categories	string	optional	JSON-encoded array of interaction categories.	—
ratingFilters	string	optional	JSON-encoded array of star ratings to include, e.g. `[3,4]`.	—
ratingFilter	integer	optional	Single star rating to filter by.	—
responseStatus	string	optional	JSON-encoded response-status filter. Values: `RESPONDED`, `PENDING`.	—
sortOrder	string	optional	JSON-encoded sort order. Values: `NEWEST_FIRST`, `OLDEST_FIRST`, `LAST_RESPONDED`.	—
first	integer	optional	Number of records to return from the beginning. Defaults to 20 when omitted, the endpoint always returns a single page, never the whole history.	—
after	string	optional	Cursor to page forward from. Pass `pageInfo.endCursor`, or equivalently the `cursor` of the last edge in the previous page.	—
last	integer	optional	Number of records to return from the end.	—
before	string	optional	Cursor to page backward from, used with `last`. Pass the `cursor` of the first edge of the page you are moving back from. `pageInfo` carries no `startCursor` field, so the edge cursor is the value to use.	—

Antworten

200Paginated rollup of interactions across the account. `data.rollupInteractions` holds the connection.

Response

{  "data": {    "rollupInteractions": {      "pageInfo": {        "hasNextPage": true,        "hasPreviousPage": false      },      "edges": [        {          "node": {            "id": "9e26d2a8-a6ed-42ea-8454-47d1c92ea841",            "source": "maps.google.com",            "content": "Excellent service, highly recommend.",            "authorName": "Priya S.",            "rating": 5,            "date": "2026-06-30T12:04:11+00:00",            "category": "Review",            "type": "Review",            "responded": false,            "responseCount": 0,            "canRespond": true,            "locationId": 1800289          },          "cursor": "SW50ZXJhY3Rpb246OWUyNmQyYTg="        }      ],      "totalCount": 1284    }  }}

401Unauthenticated, missing or invalid API key.

429Rate limit exceeded. Retry after the `Retry-After` header value.

Gibt eine standortübergreifende Ansicht der Interaktionen für das Konto zurück. Unterstützt dieselbe cursorbasierte Paginierung (first, last, after, before) und dieselben Filter wie der standortbezogene Endpunkt Interaktionen auflisten. Die Verbindung befindet sich unter data.rollupInteractions, und jedes node enthält ein locationId, sodass Sie eine Interaktion ihrem Standort zuordnen können.

totalCount ist die Anzahl der Interaktionen, die über alle berücksichtigten Standorte hinweg Ihren Filtern entsprechen, nicht die Anzahl der auf dieser Seite zurückgegebenen Interaktionen. Wenn Sie first weglassen, werden 20 Datensätze zurückgegeben, sodass ein einzelner Aufruf niemals den vollständigen Verlauf des Kontos liefert; blättern Sie mit after durch die Seiten, bis Sie totalCount Datensätze erhalten haben.

Achtung: Die Aggregation umfasst immer das gesamte Konto

Dieser Endpunkt hat keinen Parameter für einzelne Standorte: Mit dem Standardwert tag=all aggregiert er alle Standorte, auf die der API-Schlüssel zugreifen kann, und die einzige Möglichkeit zur Eingrenzung ist eine Standort-tag. Es gibt kein Argument locationFilters oder locationIds, und ein solches Argument wird beim Senden ignoriert statt abgelehnt. Grenzen Sie die Ergebnismenge mit den vorhandenen Filtern ein (siteUrls, responseStatus, sortOrder, startDate/endDate, searchString), oder gruppieren Sie die Ergebnisse selbst nach dem locationId jedes Knotens.

Anwendungsfall: eine kontoweite Warteschlange für ausstehende Antworten

Um alle Bewertungen aufzulisten, bei denen über alle Standorte hinweg noch eine Antwort des Inhabers aussteht, rufen Sie GET /rollup_interactions?responseStatus=["PENDING"]&sortOrder=["NEWEST_FIRST"]&first=50 auf und blättern Sie anschließend mit after = pageInfo.endCursor (gleichbedeutend mit dem cursor der letzten Kante) durch die Seiten, bis hasNextPage den Wert false hat oder eine Seite ein leeres edges-Array zurückgibt. Dadurch müssen Sie die Standorte nicht einzeln durchlaufen. Da der Endpunkt paginiert ist und einer Ratenbegrenzung unterliegt, beachten Sie bei einem 429 den Header Retry-After und bevorzugen Sie für geplante Synchronisierungen zeitlich eingegrenzte Durchläufe (startDate/endDate).