Google Ads API is returning to beta status. Please read our blog post for more details.

Migrating Billing Features from the AdWords API to the Google Ads API

This guide compares the billing terms used in both APIs:

AdWords API Google Ads API
Billing account Payments account
Billing customer Payments profile
Budget order Account budget
n/a Billing setup

Billing account (AdWords API) vs. Payments account (Google Ads API)

Both represent the same thing and each is indexed by a 16-digit ID (e.g., 1234-5678-9012-3456). This ID is needed to create a new billing setup in the Google Ads API.

Billing customer (AdWords API) vs. Payments profile (Google Ads API)

Both represent the same thing and each is indexed by a 12-digit ID (e.g., 1234-5678-9012).

Budget order (AdWords API) vs. Account budget (Google Ads API)

Both represent the same thing and each is indexed by an ID.

Billing setup (Google Ads API)

  • The AdWords API doesn't allow you to manipulate this entity directly.

  • A billing setup is a link between a Google Ads account and a Payments account. This entity is needed for creating a new account budget in the Google Ads API.