Google Ads

Critérios das campanhas

GET
/v1/google/ads/campaigns-criterion

Retorna dados de critérios de campanhas do Google Ads, incluindo critérios de segmentação e de exclusão em nível de campanha.

Este endpoint fornece detalhes da configuração de segmentação em nível de campanha.

Dimensões disponíveis:

  • Nome do recurso/ID/nome/status da campanha
  • Nome do recurso do critério da campanha, tipo de critério, ID do critério

Limitações:

  • Máximo de 5000 registros por página
  • Suporta ordenação via orderBy e orderDirection (ASC/DESC)

Filtros:

  • organizationId (obrigatório)
  • userId (opcional)
  • integrationName (opcional)

Nota: Este endpoint não suporta filtro por data, pois retorna dados de configuração em vez de métricas de séries temporais.

Autorização

ClientIdAuthClientSecretAuth
headerx-client-id<token>

Client ID

headerx-client-secret<token>

Client secret

Parâmetros de query

organizationId*string

Identificador da organização (obrigatório)

userId?string

Identificador do usuário (opcional)

integrationName?string

Identificador do nome da integração (opcional)

page?integer

Número da página para paginação (opcional)

Padrão1
limit?integer

Número de itens por página (opcional, máx. 5000)

Intervalovalue <= 5000
Padrão500
orderBy?string

Campo de ordenação (opcional)

orderDirection?string

Direção da ordenação (opcional)

Valor em"ASC""DESC"

Corpo da resposta

Resposta de sucesso

application/json
  1. response
data?array<>
meta?
curl -X GET "https://example.com/v1/google/ads/campaigns-criterion?organizationId=organization_123"
{  "data": [    {      "campaign_resource_name": "string",      "campaign_status": "string",      "campaign_name": "string",      "campaign_id": "string",      "campaign_criterion_resource_name": "string",      "campaign_criterion_type": "string",      "campaign_criterion_criterion_id": "string",      "organization_id": "string",      "user_id": "string",      "document_id": "string",      "integration_name": "string",      "inserted_at": "2019-08-24T14:15:22Z"    }  ],  "meta": {    "page": 0,    "limit": 0,    "hasNextPage": true,    "hasPreviousPage": true  }}