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.

> [!IMPORTANT]
> **Important:** The payments setting in your Google Ads account must be configured for [monthly invoicing](https://support.google.com/google-ads/answer/2393035) in order to manage billing setups, account budgets, and invoices with the Google Ads API. Promotional incentives don't require monthly invoicing, but require allowlist access.

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

[Billing setups](https://developers.google.com/google-ads/api/docs/billing/billing-setups)

:   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`](https://developers.google.com/google-ads/api/reference/rpc/v26/BillingSetup) resources to get and manage
    account-wide billing configuration.

[Account budgets](https://developers.google.com/google-ads/api/docs/billing/account-budgets)

:   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`](https://developers.google.com/google-ads/api/reference/rpc/v26/AccountBudgetProposal) resources to create
    new [`AccountBudget`](https://developers.google.com/google-ads/api/reference/rpc/v26/AccountBudget) resources or update existing ones.

[Invoices](https://developers.google.com/google-ads/api/docs/billing/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`](https://developers.google.com/google-ads/api/reference/rpc/v26/Invoice) resources for invoice data.

[Incentives](https://developers.google.com/google-ads/api/docs/billing/incentives)

:   **Incentives** are promotional offers provided to eligible customers to
    incentivize usage of Google Ads (available for accounts on an allowlist).

    Use [`IncentiveService`](https://developers.google.com/google-ads/api/reference/rpc/v26/IncentiveService) to fetch and apply promotional
    offers, and query [`AppliedIncentive`](https://developers.google.com/google-ads/api/reference/rpc/v26/AppliedIncentive) resources to
    inspect redemption status and reward balances.