Google Ads Customer Accounts

A Customer account is a standard Google Ads advertising account that contains campaigns, ad groups, keywords, and search terms.

Account Identification

Customer ID

Each account is identified by a unique Customer ID in the format XXX-XXX-XXXX (10 digits).

Where to find it:

1. Sign in to Google Ads
2. Click the avatar/account icon in the top-right corner
3. Customer ID is shown in the dropdown menu
4. Alternatively: Tools → Settings → Account Settings

Usage in the API:

• In requests, Customer ID is specified without dashes: XXXXXXXXXX
• The customer_id parameter is required for all Google Ads API requests

Descriptive Number

An additional identifier that can be set manually:

• An arbitrary string used to identify the account (e.g. "Main Brand Account")
• Not used in the API, only in the Google Ads interface

Account Fields

Field	Type	Description
customer.id	integer	Customer ID (without dashes)
customer.descriptive_name	string	Account name
customer.currency_code	string	ISO currency code (USD, EUR, RUB)
customer.time_zone	string	Account time zone
customer.manager	boolean	Whether the account is a Manager account
customer.test_account	boolean	Whether it's a test account
customer.call_reporting_setting.call_conversion_action	string	Call conversion setting
customer.auto_tagging_enabled	boolean	Whether auto-tagging is enabled

Currency Fields and cost_micros

A key feature of the Google Ads API: all monetary values are returned in micro-units (micros of the base currency).

Conversion

# Example: 5,000,000 micros = $5.00
cost_in_micros = 5_000_000
real_cost = cost_in_micros / 1_000_000
# real_cost = 5.0

Fields that use micros:

• metrics.cost_micros
• metrics.average_cpc
• metrics.average_cpm
• metrics.cost_per_conversion
• metrics.conversion_value

LightLead automatically converts all micros into real currency when displaying data.

Account Status

Status	Description
ENABLED	The account is active
SUSPENDED	The account is suspended
CANCELLED	The account is canceled
CLOSED	The account is closed

LightLead can only retrieve data from accounts in ENABLED status.

Retrieving Account Data

Basic Query

SELECT
  customer.id,
  customer.descriptive_name,
  customer.currency_code,
  customer.time_zone,
  customer.auto_tagging_enabled
FROM customer

List of All Accessible Accounts

GET /customers:listAccessibleCustomers

This request returns all accounts accessible to the current user (both directly and through Manager accounts).

Related Pages

• Manager and Customer Accounts
• Entities and Fields
• Metrics
• Connecting Google Ads