Mediahub Rest API
  1. Google Ads
Mediahub Rest API
  • Introdução
  • API Reference
    • Facebook Ads
      • Accounts
      • Ads [Ad Level]
      • Ads Config [Ad Level]
      • Ads [Adset Level]
      • Ads Config [Adset Level]
      • Ads [Campaign Level]
      • Ads Config [Campaign Level]
      • Ads Actions
      • Ads Gender/Age
      • Ads Region
      • Ads Platform
      • Creatives [Deprecated]
      • Creatives with Ad
    • Google Ads
      • Accounts
        GET
      • Ads Conversions
        GET
      • Ads [Ad Group]
        GET
      • Ads [Conversion Segmented Ad Group]
        GET
      • Ads [Ad Group Ads]
        GET
      • Ads Criterion [Ad Group Ads]
        GET
      • Ads [Conversion Segmented Ad Group Ads]
        GET
      • Ads [Campaigns]
        GET
      • Ads Criterion [Campaigns]
        GET
      • Ads [Conversion Segmented Campaigns]
        GET
      • Ads Age Dimension
        GET
      • Ads Gender Dimension
        GET
      • Ads Geographic Dimension
        GET
      • Ads Keywords Dimension
        GET
    • Google Analytics
      • Google Analytics Customers
      • Google Analytics Custom Events
      • Google Analytics Events
      • Google Analytics Products
      • Google Analytics Sessions
      • Google Analytics Transactions
    • Instagram Insights
      • Instagram Age Insights
      • Instagram City Insights
      • Instagram Gender Insights
      • instagram Media Details
      • Instagram Media Insights
      • Instagram Profile
      • Instagram Profile Insights
    • TikTok
      • TikTok Budget
      • TikTok Demographic
      • TikTok Group Budget
      • TikTok Info
      • TikTok Region
    • Linkedin
      • Linkedin Statistics
      • Linkedin Accounts Campaigns
      • Linkedin Conversions Tracking
    • Bitrix
      • Bitrix Contacts
      • Bitrix Deals
      • Bitrix Won Deals
      • Bitrix Leads History
    • Kommo
      • Kommo Contacts
      • Kommo Leads
      • Kommo Pipelines
      • Kommo Users
    • Loja Integrada
      • Loja Integrada Customers
      • Loja Integrada Orders
      • Loja Integrada Products
    • Nuvem Shop
      • Nuvem Shop Customers
      • Nuvem Shop Orders
      • Nuvem Shop Products
    • Pipedrive
      • Pipedrive Deals
      • Pipedrive Leads
      • Pipedrive Lead Sources
      • Pipedrive People
      • Pipedrive Pipelines
      • Pipedrive Pipeline Stages
      • Pipedrive Products
      • Pipedrive Users
    • Rd Station
      • Rd Station Deal Stages
      • Rd Station Deals
      • Rd Station Products
    • Shopify
      • Shopify Customers
      • Shopify Orders
      • Shopify Orders Items
      • Shopify Products
    • Tray
      • Tray Customers
      • Tray Orders
      • Tray Products
    • Unbounce
      • Unbounce Leads
    • Vtex
      • Vtex Customers
      • Vtex Orders
      • Vtex Products
    • Investimentos de Mídia
      • Investimentos de Mídia
    • Integrações
      • Integrações
  1. Google Ads

Accounts

GET
https://rest.api.mktlab.app/v1/google/accounts
Consulta os dados da conta de anúncio, trazendo suas métricas relacionadas.

Resposta#

A resposta retorna uma lista com os dados da conta de anúncio do Google Ads com os seguintes campos:
CampoTipoDescrição
customer_resource_namestringNome do recurso da conta no formato customers/{customer_id}.
customer_idstringID numérico da conta de cliente no Google Ads.
customer_descriptive_namestringNome descritivo da conta no Google Ads.
customer_currency_codestringCódigo da moeda utilizada pela conta (ex: BRL).
customer_time_zonestringFuso horário da conta (ex: America/Sao_Paulo).
customer_statusstringStatus atual da conta (ex: ENABLED, CANCELED).
account_budget_resource_namestringNome do recurso de orçamento da conta.
account_budget_statusstringStatus do orçamento da conta (ex: APPROVED).
account_budget_proposed_end_time_typestringTipo de fim proposto para o orçamento (ex: FOREVER, SPECIFIED_DATE).
account_budget_approved_end_time_typestringTipo de fim aprovado para o orçamento.
account_budget_idstringID do orçamento da conta.
account_budget_billing_setupstringConfiguração de faturamento associada à conta.
account_budget_namestringNome atribuído ao orçamento da conta.
account_budget_proposed_start_date_timestringData e hora de início proposta para o orçamento (formato ISO 8601).
account_budget_approved_start_date_timestringData e hora de início aprovada para o orçamento (formato ISO 8601).
account_budget_proposed_spending_limitstringLimite de gasto proposto para o orçamento.
account_budget_approved_spending_limitstringLimite de gasto aprovado para o orçamento.
account_budget_adjusted_spending_limitstringLimite de gasto ajustado com base em alterações no orçamento.
account_balancefloatSaldo da conta.
account_budget_ammount_servedfloatTotal gasto.
integration_idstringID da integração da plataforma com a conta do Google Ads.
project_idstringID do projeto associado à conta.
unit_idstringID da unidade de negócios associada à conta.
document_idstringID interno de referência do documento no sistema.
inserted_atstringData e hora em que o registro foi inserido no sistema (formato ISO 8601).

Requisição

Authorization
Forneça seu token bearer no cabeçalho
Authorization
ao fazer requisições para recursos protegidos.
Exemplo:
Authorization: Bearer ********************
Parâmetros de Consulta

Respostas

🟢200Accouns
application/json
Body

Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request GET 'https://rest.api.mktlab.app/v1/google/accounts' \
--header 'Authorization: Bearer <token>'
Response Response Example
{
  "data": [
    {
      "customer_resource_name": "customers/0000000000",
      "customer_id": "0000000000",
      "customer_descriptive_name": "Conta Google Ads Exemplo",
      "customer_currency_code": "BRL",
      "customer_time_zone": "America/Sao_Paulo",
      "customer_status": "ENABLED",
      "account_budget_resource_name": "customers/0000000000/accountBudgets/111111111",
      "account_budget_status": "APPROVED",
      "account_budget_proposed_end_time_type": "FOREVER",
      "account_budget_approved_end_time_type": "FOREVER",
      "account_budget_id": "111111111",
      "account_budget_billing_setup": "customers/0000000000/billingSetups/222222222",
      "account_budget_name": "budget",
      "account_budget_proposed_start_date_time": "2016-11-01T00:00:00.000Z",
      "account_budget_approved_start_date_time": "2016-11-01T00:00:00.000Z",
      "account_budget_proposed_spending_limit": "10000.00",
      "account_budget_approved_spending_limit": "10000.00",
      "account_budget_adjusted_spending_limit": "10500.00",
      "account_balance": "10500",
      "account_budget_amount_served": "10500",
      "integration_id": "000-000-0000",
      "project_id": "proj_abcdef123456",
      "unit_id": "unit_abcdef123456",
      "document_id": "doc_abcdef123456",
      "inserted_at": "2025-07-23T00:00:00.000Z"
    }
  ],
  "meta": {
    "page": 1,
    "limit": 1,
    "total": 1,
    "totalPages": 1,
    "hasNextPage": false,
    "hasPreviousPage": false
  }
}
Modificado em 2025-10-08 17:25:55
Página anterior
Creatives with Ad
Próxima página
Ads Conversions
Built with