v1Ressourcen/Media/getGespeicherte Google-Fotos auflisten
Gespeicherte Google-Fotos auflisten
Gibt gespeicherte Google-Fotos über alle Standorte zurück, auf die der Schlüssel zugreifen darf. Filtern Sie nach locationId, clientId oder kind und blättern Sie mit nextCursor. Es wird nur Gespeichertes gelesen: kein Aufruf von Google, keine Synchronisierung. Das oberste location ist hier nur null, wenn locationId nicht gesendet wird; mit locationId enthält es die Abdeckung dieses Standorts, auch wenn items leer ist. jeder Eintrag trägt seinen eigenen Standort und Aktualitätsstand. Die eigene Mediathek von Synup nach Kategorie ist ein anderer Abruf: GET /api/v1/media?locationId.
get
media:read/api/v1/media/googleQuery-Parameter
locationIdstringoptional
Nur Fotos dieses Standorts. Akzeptiert die öffentliche loc_-ID, die native ID oder eine ältere ID. Der Standort muss zu clientId gehören, wenn Sie beides senden.
clientIdstringoptional
Nur Fotos von Standorten dieses Kunden. Der Schlüssel muss auf diesen Kunden zugreifen dürfen.
kindstring (owner | ugc)optional
owner für vom Unternehmen hochgeladene Fotos, ugc für von Kunden beigesteuerte Fotos. Ohne Angabe werden beide geliefert.
limitintegeroptional
Seitengröße, eine ganze Zahl von 1 bis 100. Standard 50. Jeder andere Wert wird abgelehnt, nicht angepasst.
cursorstringoptional
Der nextCursor der vorherigen Seite. Er funktioniert nur mit denselben Filtern; ein Cursor aus einer anderen Anfrage wird abgelehnt.
Antwort
dataobjectoptional
itemsarray of objectoptional
Ein Eintrag pro Zuordnung von Foto und Standort, neueste zuerst. Ein Foto, das mehrere Standorte teilen, erscheint einmal für jeden Standort, auf den Sie zugreifen dürfen.
idstringoptional
Die ID des gespeicherten Fotodatensatzes. Sie gilt für alle Standorte, mit denen das Foto verknüpft ist; identifizieren Sie eine Zeile daher über associationKey.
associationKeystringoptional
Eindeutig pro Foto und Standort: die ID und die Standort-ID, durch einen Doppelpunkt verbunden.
externalIdstringoptional
Der vollständige Google-Ressourcenname. Er ist die Identität des Fotos: dieselbe URL mit anderer externalId ist ein anderes Foto.
urlstringoptional
Die bei Google gehostete URL. Ein Verweis auf das Foto bei Google, keine von Synup gespeicherte Kopie. Ein von Synup gesendetes Foto kann seine Quell-URL bis zum nächsten geplanten Abruf behalten.
categorystringoptional
Googles eigene Kategorie für das Foto oder null, wenn Google keine angegeben hat. Nicht dasselbe wie kind.
formatstringoptional
Das Medienformat wie gespeichert, zum Beispiel PHOTO, oder null.
kindstring (owner | ugc)optional
owner für ein vom Unternehmen hochgeladenes Foto, ugc für ein von Kunden beigesteuertes.
lastSeenAtstringoptional
Wann eine Antwort von Google dieses Foto zuletzt an diesem Standort enthielt, oder null, wenn unbekannt. Ein nach dem Start eines Scans gesendetes Foto zählt ebenfalls als gesehen.
presencestring (seen_in_last_complete_scan | not_seen_in_last_complete_scan | unknown)optional
Ob der letzte vollständige Scan dieses Foto gesehen hat: seen_in_last_complete_scan, not_seen_in_last_complete_scan oder unknown, solange es noch keinen vollständigen Scan gibt. Das hält Beobachtetes fest und bedeutet nie, dass Google das Foto gelöscht hat.
moderationobjectoptional
Prüfstatus des Fotos.
statusstring (ok | needs_review | spam | skipped)optional
ok, needs_review, spam oder skipped; null, wenn nicht klassifiziert. Als spam oder needs_review markierte Fotos werden weiterhin zurückgegeben, nie herausgefiltert.
locationobjectoptional
Der Standort, mit dem dieses Foto verknüpft ist.
idstringoptional
Die öffentliche ID des Standorts.
namestringoptional
Der Name des Standorts oder null.
clientIdstringoptional
Der Kunde, dem der Standort gehört, oder null bei einem Standort ohne Kunde.
freshnessobjectoptional
Wie aktuell und wie vollständig die gespeicherten Daten für diese Fotoart an diesem Standort sind. Felder mit null bedeuten unbekannt oder nie versucht, nie vollständig.
coveragestring (complete | partial | unavailable)optional
complete, partial oder unavailable; null, wenn noch keine Aktualisierung versucht wurde.
outcomestring (complete | incomplete | unavailable | failed | not_connected)optional
Ergebnis des letzten Aktualisierungsversuchs: complete, incomplete, unavailable, failed oder not_connected.
lastAttemptAtstringoptional
Wann die letzte Aktualisierung versucht wurde.
lastSuccessAtstringoptional
Wann die letzte vollständig abgeschlossene Aktualisierung lief.
completedScanAtstringoptional
Wann der letzte vollständige Scan begann. presence vergleicht lastSeenAt mit diesem Zeitpunkt.
locationobjectoptional
Bei einem Abruf für einen einzelnen Standort vorhanden, auch wenn items leer ist: der Standort mit dem Aktualitätsstand von owner und ugc. null auf der Sammelroute ohne locationId.
idstringoptional
Die öffentliche ID des Standorts.
namestringoptional
Der Name des Standorts oder null.
clientIdstringoptional
Der Kunde, dem der Standort gehört, oder null bei einem Standort ohne Kunde.
ownerobjectoptional
Wie aktuell und wie vollständig die gespeicherten Daten für diese Fotoart an diesem Standort sind. Felder mit null bedeuten unbekannt oder nie versucht, nie vollständig.
coveragestring (complete | partial | unavailable)optional
complete, partial oder unavailable; null, wenn noch keine Aktualisierung versucht wurde.
outcomestring (complete | incomplete | unavailable | failed | not_connected)optional
Ergebnis des letzten Aktualisierungsversuchs: complete, incomplete, unavailable, failed oder not_connected.
lastAttemptAtstringoptional
Wann die letzte Aktualisierung versucht wurde.
lastSuccessAtstringoptional
Wann die letzte vollständig abgeschlossene Aktualisierung lief.
completedScanAtstringoptional
Wann der letzte vollständige Scan begann. presence vergleicht lastSeenAt mit diesem Zeitpunkt.
ugcobjectoptional
Wie aktuell und wie vollständig die gespeicherten Daten für diese Fotoart an diesem Standort sind. Felder mit null bedeuten unbekannt oder nie versucht, nie vollständig.
coveragestring (complete | partial | unavailable)optional
complete, partial oder unavailable; null, wenn noch keine Aktualisierung versucht wurde.
outcomestring (complete | incomplete | unavailable | failed | not_connected)optional
Ergebnis des letzten Aktualisierungsversuchs: complete, incomplete, unavailable, failed oder not_connected.
lastAttemptAtstringoptional
Wann die letzte Aktualisierung versucht wurde.
lastSuccessAtstringoptional
Wann die letzte vollständig abgeschlossene Aktualisierung lief.
completedScanAtstringoptional
Wann der letzte vollständige Scan begann. presence vergleicht lastSeenAt mit diesem Zeitpunkt.
limitintegeroptional
Die angewendete Seitengröße.
nextCursorstringoptional
Als cursor übergeben, um die nächste Seite zu erhalten. null, wenn es keine weiteren gibt.
Fehler
400limit, kind, ein Filter oder der Cursor ist ungültig, ein Parameter wurde wiederholt oder der Standort gehört nicht zur gesendeten clientId. Das Feld code nennt die Ursache.
401API-Schlüssel fehlt, ist ungültig, abgelaufen oder widerrufen.
403Der Schlüssel ist für diesen Kunden oder Standort nicht autorisiert. Ein Standort ohne Kunde ist nur für agenturweite Schlüssel sichtbar.
404Der Standort wurde in dieser Agentur nicht gefunden.
429Zu viele Anfragen. Versuchen Sie es nach der im Retry-After-Header angegebenen Anzahl Sekunden erneut.
get/api/v1/media/google
Ihr API-Schlüssel
locationId
clientId
kind
limit
cursor
{
"data": {
"items": [
{
"id": "4c7a1e90-2b6d-4d8f-9e35-71f0a8c2d413",
"associationKey": "4c7a1e90-2b6d-4d8f-9e35-71f0a8c2d413:loc_789",
"externalId": "accounts/102938475610293847561/locations/7788990011223344556/media/AF1QipOwnerSign03",
"url": "https://lh3.googleusercontent.com/p/AF1QipOwnerSign03",
"category": "EXTERIOR",
"format": "PHOTO",
"kind": "owner",
"lastSeenAt": "2026-10-12T04:01:58.000Z",
"presence": "seen_in_last_complete_scan",
"moderation": {
"status": null
},
"location": {
"id": "loc_789",
"name": "Acme Dental — Uptown",
"clientId": "cli_123"
},
"freshness": {
"coverage": "complete",
"outcome": "complete",
"lastAttemptAt": "2026-10-12T04:02:11.000Z",
"lastSuccessAt": "2026-10-12T04:02:11.000Z",
"completedScanAt": "2026-10-12T04:01:58.000Z"
}
}
],
"location": null,
"limit": 50,
"nextCursor": null
}
}