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.