v1Recursos/Connections/getObter uma URL de conexão do Google

Obter uma URL de conexão do Google

Retorna uma URL de autorização OAuth do Google para abrir em um navegador e conectar o Perfil da Empresa no Google deste local. Este endpoint não pode concluir a conexão sozinho — a tela de consentimento do Google requer um humano interativo.

get/api/v1/connections/google/connect-url

connections:write

Parâmetros de consulta

locationIdstringobrigatório

O local a conectar.

clientIdstringopcional

O cliente do local. Necessário apenas para desambiguar quando sua chave é limitada a clientes específicos.

returnUrlstringopcional

Caminho interno do app para onde ir após o humano concluir a tela de consentimento. Padrão: "/".

Resposta

dataobjectopcional

providerstring (google | facebook)opcional

Qual publisher esta URL conecta.

locationIdstringopcional

O local ao qual esta conexão será pareada assim que aprovada.

urlstringopcional

A URL de autorização — abra-a em um navegador sob o controle do proprietário da conta.

notestringopcional

Explica que não há callback para sua integração; consulte GET /api/v1/connections depois.

Erros

400Falta um parâmetro obrigatório na solicitação, ou ela é inválida de outra forma.

401Chave de API ausente, inválida, expirada ou revogada.

403A chave não tem a permissão exigida, ou não está autorizada para este cliente/local.

429Muitas solicitações. Tente novamente após o número de segundos indicado no cabeçalho Retry-After.

get/api/v1/connections/google/connect-url

Sua chave 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."
  }
}