Accounts

GET

https://api.data.v4.marketing/v1/google/accounts

Retrieve Google Ads account information and budget details.

This endpoint returns account-level data including customer information, account status, currency, timezone, and budget configurations.

Dimensions Available:

Customer resource name, customer ID, descriptive name

Currency code, timezone, status

Account budget details: resource name, status, billing setup, spending limits

Limitations:

Maximum 5000 records per page

Default page size: 500

Supports pagination

Filters:

workspaceId (required)

organizationId (optional)

userId (optional)

integrationName (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/accounts?workspaceId=workspace_123&organizationId&userId&integrationName&page&limit' \
--header 'x-client-id: <api-key>' \
--header 'x-client-secret: <api-key>'

Response Example

200 - Exemplo 1

{
    "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:22.123Z",
            "account_budget_approved_start_date_time": "2019-08-24T14:15:22.123Z",
            "account_budget_proposed_spending_limit": 0,
            "account_budget_approved_spending_limit": 0,
            "account_budget_adjusted_spending_limit": 0,
            "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