Ad Group Ads

GET

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

Retrieve Google Ads ad group ads data with comprehensive performance metrics.

This endpoint provides ad-level insights including ad status, type, strength, creative elements, and performance indicators.

Dimensions Available:

Ad group resource name/ID

Ad resource name/ID, ad status, type, strength

Final URLs: desktop/mobile

Responsive search ad: headlines/descriptions

Metrics: clicks, impressions, cost, conversions, CTR, CPC, cost per conversion, all conversions, conversions value

Date segments

Limitations:

Maximum 5000 records per page

Supports date filtering via createdStart and createdEnd (ISO 8601 format)

Supports sorting via orderBy and orderDirection (ASC/DESC)

Filters:

workspaceId (required)

organizationId (optional)

userId (optional)

integrationName (optional)

createdStart (optional)

createdEnd (optional)

Requisição

Authorization

API Key

Adicionar parâmetro em header

x-client-id

Exemplo:

x-client-id: ********************

API Key

Adicionar parâmetro em header

x-client-secret

Exemplo:

x-client-secret: ********************

Parâmetros de Consulta

Respostas

🟢200Sucesso

application/json

Successful response

Body

🟠400400

🔴500500

Request Example

Shell

JavaScript

Java

Swift

curl --location --request GET 'https://api.data.v4.marketing/v1/google/ads/ad-group-ads?workspaceId=workspace_123&organizationId&userId&integrationName&createdStart=2024-01-01T00:00:00Z&createdEnd=2024-12-31T23:59:59Z&page&limit&orderBy&orderDirection' \
--header 'x-client-id: <api-key>' \
--header 'x-client-secret: <api-key>'

Response Example

200 - Exemplo 1

{
    "data": [
        {
            "ad_group_resource_name": "string",
            "ad_group_id": "string",
            "ad_group_ad_resource_name": "string",
            "ad_group_ad_status": "string",
            "ad_group_ad_ad_resource_name": "string",
            "ad_group_ad_ad_id": "string",
            "ad_group_ad_ad_strength": "string",
            "ad_group_ad_ad_type": "string",
            "ad_group_ad_ad_final_urls": {},
            "ad_group_ad_ad_final_mobile_urls": {},
            "ad_group_ad_ad_responsive_search_ad_headlines": {},
            "ad_group_ad_ad_responsive_search_ad_descriptions": {},
            "metrics_clicks": 0,
            "metrics_conversions_from_interactions_rate": 0,
            "metrics_conversions": 0,
            "metrics_cost_micros": 0,
            "metrics_cost_per_conversion": 0,
            "metrics_ctr": 0,
            "metrics_all_conversions_value": 0,
            "metrics_all_conversions": 0,
            "metrics_average_cpc": 0,
            "metrics_impressions": 0,
            "metrics_cost": 0,
            "segments_date": "2019-08-24",
            "workspace_id": "string",
            "organization_id": "string",
            "user_id": "string",
            "document_id": "string",
            "integration_name": "string",
            "inserted_at": "2019-08-24T14:15:22.123Z"
        }
    ],
    "meta": {
        "page": 0,
        "limit": 0,
        "hasNextPage": true,
        "hasPreviousPage": true
    }
}

Modificado em 2025-12-02 02:02:19