Remove a Campaign Budget
Stay organized with collections
Save and categorize content based on your preferences.
Before removing a budget, ensure that no
ENABLED
or
PAUSED
campaigns
are using it by checking its
reference_count
.
If this field is greater than 0, there are ENABLED
or PAUSED
campaigns still
using the budget. You can retrieve this information by searching for metrics
with campaign_budget
as the main resource. Here is the GAQL query for the
reference count of a budget, filtering on its ID:
SELECT campaign_budget.reference_count
FROM campaign_budget
WHERE campaign_budget.id = campaign_budget_id
Once you've determined that a CampaignBudget
is no longer used and can be removed, send a
remove
operation with the resource name of the campaign budget.
When removing a campaign, you're also removing any non-shared budget being
used by that campaign.
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2025-08-25 UTC.
[null,null,["Last updated 2025-08-25 UTC."],[[["\u003cp\u003eBefore removing a budget, ensure no active or paused campaigns are using it by checking its \u003ccode\u003ereference_count\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eIf the \u003ccode\u003ereference_count\u003c/code\u003e is greater than 0, retrieve information using a GAQL query with \u003ccode\u003ecampaign_budget\u003c/code\u003e as the main resource.\u003c/p\u003e\n"],["\u003cp\u003eTo remove an unused \u003ccode\u003eCampaignBudget\u003c/code\u003e, send a \u003ccode\u003eremove\u003c/code\u003e operation with the resource name of the campaign budget.\u003c/p\u003e\n"],["\u003cp\u003eRemoving a campaign also removes any non-shared budget associated with it.\u003c/p\u003e\n"]]],[],null,["# Remove a Campaign Budget\n\nBefore removing a budget, ensure that no\n[`ENABLED`](/google-ads/api/reference/rpc/v21/CampaignStatusEnum.CampaignStatus#enabled) or\n[`PAUSED`](/google-ads/api/reference/rpc/v21/CampaignStatusEnum.CampaignStatus#paused) campaigns\nare using it by checking its\n[`reference_count`](/google-ads/api/reference/rpc/v21/CampaignBudget#reference_count).\nIf this field is greater than 0, there are `ENABLED` or `PAUSED` campaigns still\nusing the budget. You can retrieve this information by searching for metrics\nwith `campaign_budget` as the main resource. Here is the GAQL query for the\nreference count of a budget, filtering on its ID: \n\n SELECT campaign_budget.reference_count\n FROM campaign_budget\n WHERE campaign_budget.id = \u003cvar translate=\"no\"\u003e\u003cspan class=\"devsite-syntax-n\"\u003ecampaign_budget_id\u003c/span\u003e\u003c/var\u003e\n\nOnce you've determined that a [`CampaignBudget`](/google-ads/api/reference/rpc/v21/CampaignBudget)\nis no longer used and can be removed, send a\n[`remove`](/google-ads/api/reference/rpc/v21/CampaignBudgetOperation#remove)\noperation with the resource name of the campaign budget.\n\nWhen removing a campaign, you're also removing any non-shared budget being\nused by that campaign."]]