v1Ressourcen/Connections/postEinen vorgeschlagenen Treffer bestätigen

Einen vorgeschlagenen Treffer bestätigen

Bestätigt einen Vorschlag der NAP-Bewertung und erstellt eine Verbindung auf Standortebene aus einem abgerufenen Listing, das bereits einem Synup-Standort zugeordnet wurde. Schlägt fehl, wenn das Listing keinem Standort zugeordnet ist (400), bereits verbunden ist (409) oder der Standort bereits eine Verbindung auf dieser Plattform hat (409).

post/api/v1/connections/locations/confirm-match

connections:write

Anfragetext

fetchedListingIdstringerforderlich

Das zu bestätigende abgerufene Listing. Erforderlich.

Antwort

dataobjectoptional

idstringoptional

Eindeutige Kennung der resultierenden Verbindung.

platformstring (google | facebook)optional

Die Plattform, auf der das Listing verknüpft wurde.

synupLocationIdstringoptional

Die Legacy-Synup-ID des Standorts, oder null bei einem nativen Standort.

clientLocationIdstringoptional

Die ID des Standorts.

platformResourceNamestringoptional

Der Ressourcenname/die ID des Listings auf der Plattform.

platformPageNamestringoptional

Der Anzeigename des Listings auf der Plattform.

Fehler

400Der Anfrage fehlt ein erforderlicher Parameter, oder sie ist anderweitig fehlerhaft.

401API-Schlüssel fehlt, ist ungültig, abgelaufen oder widerrufen.

403Dem Schlüssel fehlt die erforderliche Berechtigung, oder er ist für diesen Kunden/Standort nicht autorisiert.

404Die Ressource wurde nicht gefunden oder gehört nicht zu Ihrer Agentur.

409Die Anfrage steht im Widerspruch zum aktuellen Zustand der Ressource — zum Beispiel beim Ändern der E-Mail-Adresse oder Telefonnummer eines Empfängers, dem bereits eine Nachricht gesendet wurde, oder bei einer Team-Einladung, die bereits akzeptiert wurde (oder noch nicht akzeptiert wurde).

429Zu viele Anfragen. Versuchen Sie es nach der im Retry-After-Header angegebenen Anzahl Sekunden erneut.

post/api/v1/connections/locations/confirm-match

Ihr API-Schlüssel

Anfragetext*

{
  "data": {
    "id": "listing_1",
    "platform": "google",
    "synupLocationId": null,
    "clientLocationId": "loc_456",
    "platformResourceName": "accounts/123/locations/456",
    "platformPageName": "Acme Dental — Downtown"
  }
}