Synupv1
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, "/".
Respuesta
dataobjectopcional
providerstring (google | facebook)opcional
Qué publisher conecta esta URL.
locationIdstringopcional
La ubicación a la que se emparejará esta conexión una vez aprobada.
urlstringopcional
La URL de autorización — ábrala en un navegador bajo el control del propietario de la cuenta.
notestringopcional
Explica que no hay retorno de llamada a su integración; consulte GET /api/v1/connections después.
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
{
  "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."
  }
}