Get Google ad accounts

GET 
/ad-publishing/google/ad-accounts

Retrieve Google Ads accounts available for the connected user

Request

Version stringrequired

API Version

Available optionsv3

locationId stringrequired

Location identifier

type string

Account type

Available optionsINTEGRATIONAD_MANAGER

application/json

Ad accounts, shaped by type. INTEGRATION resolves each account from Google and returns its billing status, name, and connection flag; AD_MANAGER reads the location's stored integrations and returns only accId and mccId.

application/json

Schema

Schema

• Array [
oneOf
• GoogleAdAccountDTO
• GoogleManagedAccountDTO

accIdstringrequired

Google Ads customer id of the account

mccIdstringrequired

Customer id of the manager (MCC) account above it

paymentStatusstringrequired

Billing setup status, resolved by preferring APPROVED over APPROVED_HELD, PENDING then CANCELLED. NO_PAYMENT_METHOD means no billing setup was found.

Available optionsAPPROVEDAPPROVED_HELDPENDINGCANCELLEDNO_PAYMENT_METHOD

namestringrequired

Account display name

emailstring

Email of a user with access to the account. Absent when Google returns no customer_user_access row, which is common for MCC-managed child accounts.

statusstring

Google Ads account status

integrationConnectedbooleanrequired

True when this account is the one currently connected to the location

• ]

Example (auto)

[
  {
    "accId": "6776452901",
    "mccId": "6776452901",
    "paymentStatus": "APPROVED",
    "name": "Acme Test Account",
    "email": "[email protected]",
    "status": "ENABLED",
    "integrationConnected": true
  },
  {
    "accId": "6776452901",
    "mccId": "6776452901"
  }
]