Skip to main content
Google IntegrationVersion: v3

Get Google ad accounts

GET/ad-publishing/google/ad-accounts

Retrieve Google Ads accounts available for the connected user

Authorizations

Authorizationstringheaderrequired

Bearer authentication header of the form Bearer <token>, where <token> is your access token.

Scope:adPublishing.readonly
Auth methods:OAuthPrivate Integration
Token type:Sub-Account Token

Request​

Headers

Versionstringrequired

API Version

Available optionsv3
Example:v3

Query Parameters

locationIdstringrequired

Location identifier

Example:HChooFuiyPpVYzeJ4HMe
typestring

Account source to read. INTEGRATION walks the connected user's MCC tree, AD_MANAGER returns the stored ad-manager integrations, EMAIL resolves the Google connection matching email. Defaults to INTEGRATION.

Available optionsINTEGRATIONAD_MANAGEREMAIL
Example:AD_MANAGER
emailstring

Google account email to match a connection against. Required when type=EMAIL.

Example:[email protected]

Response

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.

  • Array items
    • oneOf
    accIdstringrequired

    Google Ads customer id of the account

    Example:6776452901
    mccIdstringrequired

    Customer id of the manager (MCC) account above it

    Example:6776452901
    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
    Example:APPROVED
    namestringrequired

    Account display name

    Example:Acme Test Account
    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.

    Example:[email protected]
    statusstring

    Google Ads account status

    Example:ENABLED
    integrationConnectedbooleanrequired

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

    Example:true