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) versus 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.
In the AdWords API, you use
BudgetOrderServiceto get available billing accounts usingGetBillingAccounts.In the Google Ads API, you can retrieve this entity directly using
PaymentsAccountService.ListPaymentsAccounts, which will return all available Payments accounts for your authenticated Google Ads account. You can also create a new Payments account at the same time you create a billing setup.
Billing customer (AdWords API) versus Payments profile (Google Ads API)
Both represent the same thing and each is indexed by a 12-digit ID (e.g.,
1234-5678-9012).
The AdWords API doesn't allow you to manipulate this entity directly, but it appears as a part of
BudgetOrder.You need this ID to create a new Payments account in the Google Ads API.
Budget order (AdWords API) versus Account budget (Google Ads API)
Both represent the same thing and each is indexed by an ID.
In the AdWords API, you use the
BudgetOrderServiceto create a newBudgetOrder. Read more about budget orders.In the Google Ads API, you manipulate an
AccountBudgetusing theAccountBudgetProposal. Read more about mutating account budgets.
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.