Billing

  • The Google Ads API enables programmatic management of billing workflows, including setup, budgets, and invoice reconciliation, for accounts set up with monthly invoicing.

  • Billing setups link Payments accounts to Google Ads accounts, determining payment responsibility and managed using BillingSetup resources.

  • Account budgets, defined by start/end times and spending limits, are managed via AccountBudgetProposal and AccountBudget resources for creation and updates.

  • Monthly invoices, providing detailed billing breakdowns, are retrievable as PDF files using Invoice resources for automated reconciliation by Google Ads managers.

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.

Invoice

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.

Next
Billing setup