A API do Google Ads do V4 Marketing permite que você acesse e gerencie dados de contas, campanhas, grupos de anúncios, anúncios, palavras‑chave, conversões, critérios e segmentações.Endpoints Disponíveis#
GET /v1/google-ads/accounts: Contas do Google Ads
GET /v1/google-ads/campaigns: Campanhas com métricas de performance
GET /v1/google-ads/ad-groups: Grupos de anúncios
GET /v1/google-ads/ad-group-ads: Anúncios dos grupos
GET /v1/google-ads/keywords: Palavras‑chave
GET /v1/google-ads/conversions: Conversões
GET /v1/google-ads/age-range: Segmentação por faixa etária
GET /v1/google-ads/gender: Segmentação por gênero
GET /v1/google-ads/geographic: Segmentação geográfica
GET /v1/google-ads/conversion-segmented-campaigns: Campanhas segmentadas por conversão
GET /v1/google-ads/conversion-segmented-ad-groups: Grupos segmentados por conversão
GET /v1/google-ads/conversion-segmented-ad-group-ads: Anúncios segmentados por conversão
GET /v1/google-ads/campaigns-criterion: Critérios de campanha
GET /v1/google-ads/ad-group-criterion: Critérios de grupo de anúncios
Autenticação#
Todos os endpoints requerem autenticação via Bearer token no header Authorization.Parâmetros Comuns#
workspaceId - ID do workspace
organizationId - ID da organização
page - Número da página (padrão: 1)
limit - Limite por página (padrão: 500, máximo: 5000)
orderBy - Campo para ordenação
orderDirection - Direção da ordenação (ASC/DESC)
createdStart - Data/hora inicial (ISO 8601)
createdEnd - Data/hora final (ISO 8601)
Respostas#
Todas as respostas seguem o padrão:{
"data": [...],
"meta": {
"page": 1,
"limit": 500,
"total": 1000,
"totalPages": 2,
"hasNextPage": true,
"hasPreviousPage": false
}
}
Modificado em 2025-10-30 13:11:22
