The Google Ads API lets you programmatically manage end-to-end billing workflows, from initial billing setup and account-level budget management, to customer invoice reconciliation.

Each of the following entities encapsulates a distinct functional portion of the billing lifecycle.

Billing setup

A billing setup is an association between a Payments account and a specific Google Ads account. It effectively determines who pays for an advertiser's account.

Use BillingSetup resources to get and manage account-wide billing configuration.

Account budget

An account budget defines account-level budget properties, such as start time, end time, and spending limit. All changes to account budgets are done by submitting separate account budget proposals, which, after being reviewed and approved, become account budgets.

Use AccountBudgetProposal resources to create new AccountBudgets or update existing ones.


An invoice is issued monthly when enabled by the advertiser. Invoices contain details such as adjustments, regulatory costs, taxes and account budgets, and can be downloaded as PDF files. Google Ads managers typically use them to automatically reconcile their own customer invoices.

Retrieve Invoice resources for invoice data.