Google Ads

Rotas dedicadas para gerenciamento de conexões do Google Ads, seleção de conta ativa e carregamento de MCC sob demanda.

Base URL

Text

https://dev-api-tools.helbioads.com/api/integrations/google-ads

Endpoints

GET/api/integrations/google-ads/:clientIdclients:read

Status da conexão Google Ads

GET/api/integrations/google-ads/:clientId/accountsclients:read

Listar contas Google Ads

POST/api/integrations/google-ads/:clientId/accounts/selectclients:write

Selecionar conta Google Ads

POST/api/integrations/google-ads/:clientId/mcc/loadclients:write

Carregar contas filhas de MCC

GET/api/integrations/google-ads/:clientId/mcc/:mccIdclients:read

Informações do MCC

GET/api/integrations/google-ads/:clientId/mcc/:mccId/accountsclients:read

Listar contas filhas do MCC

POST/api/integrations/google-ads/:clientId/syncclients:write

Sincronizar contas Google Ads

DELETE/api/integrations/google-ads/:clientIdclients:delete

Desconectar Google Ads

Parâmetros

Campo	Tipo	Descricao
`clientId`obrigatório	string	ID do cliente (CUID).
`mccId`	string	ID do MCC (usado nas rotas /mcc/:mccId).
`limit`	number	Limite de contas filhas (1-100).

Exemplos

Listar contas

Bash

curl -X GET "https://dev-api-tools.helbioads.com/api/integrations/google-ads/<clientId>/accounts" \
  -H "Authorization: Bearer YOUR_JWT"

Selecionar conta

Bash

curl -X POST "https://dev-api-tools.helbioads.com/api/integrations/google-ads/<clientId>/accounts/select" \
  -H "Authorization: Bearer YOUR_JWT" \
  -H "Content-Type: application/json" \
  -d '{
    "accountId": "1234567890",
    "exclusive": true
  }'

Carregar MCC

Bash

curl -X POST "https://dev-api-tools.helbioads.com/api/integrations/google-ads/<clientId>/mcc/load" \
  -H "Authorization: Bearer YOUR_JWT" \
  -H "Content-Type: application/json" \
  -d '{
    "mccCustomerId": "9998887777",
    "limit": 50
  }'

Informações do MCC

Bash

curl -X GET "https://dev-api-tools.helbioads.com/api/integrations/google-ads/<clientId>/mcc/<mccId>" \
  -H "Authorization: Bearer YOUR_JWT"

Listar contas do MCC

Bash

curl -X GET "https://dev-api-tools.helbioads.com/api/integrations/google-ads/<clientId>/mcc/<mccId>/accounts?limit=50" \
  -H "Authorization: Bearer YOUR_JWT"