Campaigns

GET

https://api.data.v4.marketing/v1/google-ads/campaigns

Retrieve Google Ads campaign data with performance metrics

Requisição

Parâmetros de Consulta

Parâmetros Header

Respostas

🟢200Correto

application/json

Successful response

Body

🟠400Solicitação incorreta

🔴500Erro interno do servidor

Request Example

Shell

JavaScript

Java

Swift

curl --location --request GET 'https://api.data.v4.marketing/v1/google-ads/campaigns?workspaceId=workspace_123&organizationId&userId&createdStart=2024-01-01T00:00:00Z&createdEnd=2024-12-31T23:59:59Z&page&limit&orderBy&orderDirection' \
--header 'Authorization: Bearer {token}'

Response Example

200 - Exemplo 1

{
    "data": [
        {
            "campaign_resource_name": "string",
            "campaign_status": "string",
            "campaign_advertising_channel_type": "string",
            "campaign_name": "string",
            "campaign_id": "string",
            "campaign_start_date": "2019-08-24",
            "campaign_end_date": "2019-08-24",
            "campaign_optimization_score": 0,
            "metrics_clicks": 0,
            "metrics_search_budget_lost_impression_share": 0,
            "metrics_search_impression_share": 0,
            "metrics_search_rank_lost_impression_share": 0,
            "metrics_conversions_from_interactions_rate": 0,
            "metrics_conversions_value": 0,
            "metrics_conversions": 0,
            "metrics_cost_micros": 0,
            "metrics_cost_per_conversion": 0,
            "metrics_ctr": 0,
            "metrics_average_cpc": 0,
            "metrics_impressions": 0,
            "campaign_budget_amount_micros": 0,
            "campaign_budget_resource_name": "string",
            "metrics_cost": 0,
            "metrics_roas": 0,
            "campaign_budget_amount": 0,
            "campaign_advertising_channel_sub_type": "string",
            "campaign_budget_delivery_method": "string",
            "segments_date": "2019-08-24",
            "workspace_id": "string",
            "organization_id": "string",
            "user_id": "string",
            "document_id": "string",
            "inserted_at": "2019-08-24T14:15:22Z"
        }
    ],
    "meta": {
        "page": 0,
        "limit": 0,
        "total": 0,
        "totalPages": 0,
        "hasNextPage": true,
        "hasPreviousPage": true
    }
}

Modificado em 2025-10-30 14:22:04