Google Ads

Critérios dos grupos de anúncios

GET
/v1/google/ads/ad-group-criterion

Retorna dados de critérios de grupos de anúncios do Google Ads, incluindo critérios de segmentação e de exclusão em nível de grupo de anúncios.

Este endpoint fornece detalhes da configuração de segmentação em nível de grupo de anúncios, incluindo palavras-chave, posicionamentos e outros critérios de segmentação.

Dimensões disponíveis:

  • Nome do recurso/ID/nome do grupo de anúncios
  • Nome do recurso do critério do grupo de anúncios, status do critério, 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/ad-group-criterion?organizationId=organization_123"
{  "data": [    {      "ad_group_resource_name": "string",      "ad_group_id": "string",      "ad_group_name": "string",      "ad_group_criterion_resource_name": "string",      "ad_group_criterion_status": "string",      "ad_group_criterion_type": "string",      "ad_group_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  }}