Google Ads

Contas

GET
/v1/google/accounts

Retorna informações da conta do Google Ads e detalhes de orçamento.

Este endpoint retorna dados em nível de conta, incluindo informações do cliente, status da conta, moeda, fuso horário e configurações de orçamento.

Dimensões disponíveis:

  • Nome do recurso do cliente, ID do cliente, nome descritivo
  • Código da moeda, fuso horário, status
  • Detalhes do orçamento da conta: nome do recurso, status, configuração de faturamento, limites de gastos

Limitações:

  • Máximo de 5000 registros por página
  • Tamanho de página padrão: 500
  • Suporta paginação

Filtros:

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

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

Corpo da resposta

Resposta de sucesso

application/json
  1. response
data?array<>
meta?
curl -X GET "https://example.com/v1/google/accounts?organizationId=organization_123"
{  "data": [    {      "customer_resource_name": "string",      "customer_id": "string",      "customer_descriptive_name": "string",      "customer_currency_code": "string",      "customer_time_zone": "string",      "customer_status": "string",      "account_budget_resource_name": "string",      "account_budget_status": "string",      "account_budget_proposed_end_time_type": "string",      "account_budget_approved_end_time_type": "string",      "account_budget_id": "string",      "account_budget_billing_setup": "string",      "account_budget_name": "string",      "account_budget_proposed_start_date_time": "2019-08-24T14:15:22Z",      "account_budget_approved_start_date_time": "2019-08-24T14:15:22Z",      "account_budget_proposed_spending_limit": 0,      "account_budget_approved_spending_limit": 0,      "account_budget_adjusted_spending_limit": 0,      "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  }}