Synup
Crear clave
v1Recursos/Connections/getObtener una URL de conexión de Google

Obtener una URL de conexión de Google

Devuelve una URL de autorización de OAuth de Google para abrir en un navegador y conectar el Perfil de Negocio de Google de esta ubicación. Este endpoint no puede completar la conexión por sí mismo — la pantalla de consentimiento de Google requiere un humano interactivo.

get/api/v1/connections/google/connect-url
connections:write
Parámetros de consulta
locationIdstringobligatorio
La ubicación a conectar.
clientIdstringopcional
El cliente de la ubicación. Solo necesario para desambiguar cuando su clave está limitada a clientes específicos.
returnUrlstringopcional
Ruta interna de la app donde aterrizar después de que el humano complete la pantalla de consentimiento. Por defecto, "/".
successUrlstringopcional
A dónde se envía el navegador del cliente tras una conexión exitosa. Debe estar registrada en la clave de API y proporcionarse junto con errorUrl.
errorUrlstringopcional
A dónde se envía el navegador si la conexión falla o se cancela. Misma regla de registro, y se proporciona junto con successUrl.
Respuesta
dataobjectopcional
providerstring (google | facebook | apple)opcional
Qué publisher conecta esta URL: google, facebook o apple.
locationIdstringopcional
La ubicación a la que se empareja esta conexión, o null cuando la conexión se inició con un clientId.
clientIdstringopcional
El cliente al que se limita esta conexión, o null.
urlstringopcional
La URL de autorización — ábrala en un navegador bajo el control del propietario de la cuenta.
successUrlstringopcional
La successUrl usada en esta llamada, o null en modo heredado.
errorUrlstringopcional
La errorUrl usada en esta llamada, o null en modo heredado.
notestringopcional
Indicaciones para abrir la URL. Explica el traspaso de partner cuando successUrl y errorUrl están definidas, o el flujo de sondeo de GET /api/v1/connections en caso contrario.
Errores
400A la solicitud le falta un parámetro obligatorio o es inválida de otra forma.
401La clave de API falta, es inválida, expiró o fue revocada.
403A la clave le falta el permiso requerido, o no está autorizada para este cliente/ubicación.
429Demasiadas solicitudes. Reintente tras el número de segundos indicado en el encabezado Retry-After.
get/api/v1/connections/google/connect-url
Su clave de API
locationId *
clientId
returnUrl
successUrl
errorUrl
{
  "data": {
    "provider": "google",
    "locationId": "loc_456",
    "clientId": null,
    "url": "https://accounts.google.com/o/oauth2/v2/auth?client_id=...&redirect_uri=...&response_type=code&scope=...&state=...",
    "successUrl": "https://app.example.com/oauth/done",
    "errorUrl": "https://app.example.com/oauth/failed",
    "note": "Open this URL in a browser under the account owner's control. When the connect settles, the browser is sent to your successUrl (with ?code=...&status=...&connected_account_id=...) or errorUrl (with ?error=...). Exchange the code server-side at POST /api/v1/connections/handoff/exchange within 10 minutes for the connection id and the email that authorised."
  }
}

Guías que usan este endpoint