Synupv1
Schlüssel erstellen
v1Ressourcen/Connections/getGoogle-Verbindungs-URL abrufen

Google-Verbindungs-URL abrufen

Gibt eine Google-OAuth-Autorisierungs-URL zurück, die in einem Browser geöffnet wird, um das Google-Unternehmensprofil dieses Standorts zu verbinden. Dieser Endpunkt kann die Verbindung nicht selbst abschließen — der Google-Zustimmungsbildschirm erfordert einen interaktiven Menschen.

get/api/v1/connections/google/connect-url
connections:write
Query-Parameter
locationIdstringerforderlich
Der zu verbindende Standort.
clientIdstringoptional
Der Kunde des Standorts. Nur zur Eindeutigkeit nötig, wenn Ihr Schlüssel auf bestimmte Kunden beschränkt ist.
returnUrlstringoptional
App-interner Pfad, auf dem nach Abschluss des Zustimmungsbildschirms gelandet wird. Standard: "/".
Antwort
dataobjectoptional
providerstring (google | facebook)optional
Welcher Publisher mit dieser URL verbunden wird.
locationIdstringoptional
Der Standort, dem diese Verbindung nach Genehmigung zugeordnet wird.
urlstringoptional
Die Autorisierungs-URL — in einem Browser unter Kontrolle des Kontoinhabers öffnen.
notestringoptional
Erklärt, dass es keinen Rückruf an Ihre Integration gibt; danach GET /api/v1/connections abfragen.
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.
429Zu viele Anfragen. Versuchen Sie es nach der im Retry-After-Header angegebenen Anzahl Sekunden erneut.
get/api/v1/connections/google/connect-url
Ihr API-Schlüssel
locationId *
clientId
returnUrl
{
  "data": {
    "provider": "google",
    "locationId": "loc_456",
    "url": "https://accounts.google.com/o/oauth2/v2/auth?client_id=...&redirect_uri=...&response_type=code&scope=...&state=...",
    "note": "Open this URL in a browser under the account owner's control. There is no callback to your integration — once approved, poll GET /api/v1/connections to see the new connection."
  }
}