To discuss and provide feedback on our products, join the official Google Ads Discord channel in the Google Advertising and Measurement Community server.

Sharing Campaign Budgets

AI-generated Key Takeaways

When creating a new CampaignBudget using the Google Ads API, you can specify if it's shareable across campaigns using the explicitly_shared field, with true allowing sharing and false restricting it to one campaign.
Once a budget is created, you cannot change explicitly_shared from true to false , but you can change it from false to true if no experiments are running on the associated campaign.
Explicitly shared budgets appear in the Google Ads UI's Shared Library, while non-shared budgets only appear within their associated campaign's Settings.
You can determine if a campaign budget is shared by retrieving the campaign_budget.explicitly_shared field using a GAQL query filtered by the budget ID.

A budget can be applied to a single campaign, or be shared across many campaigns.

Setup

When you create a new CampaignBudget using the Google Ads API, you can specify if it is shareable with the BoolValue of the explicitly_shared field:

true (default): can be shared among multiple campaigns
false : can be used by only one campaign

Explicitly shared budgets appear in an account's Shared Libraryin the Google Ads UI, whereas a non-shared budget appears only within its associated campaign's Settings.

In the following example where a new budget is created, the budget is shared because explicitly_shared is set to true .

Java

 private 
  
 String 
  
 createSharedCampaignBudget 
 ( 
 GoogleAdsClient 
  
 googleAdsClient 
 , 
  
 long 
  
 customerId 
 ) 
  
 { 
  
 try 
  
 ( 
 CampaignBudgetServiceClient 
  
 campaignBudgetServiceClient 
  
 = 
  
 googleAdsClient 
 . 
 getLatestVersion 
 (). 
 createCampaignBudgetServiceClient 
 ()) 
  
 { 
  
 // Creates a shared budget. 
  
 CampaignBudget 
  
 budget 
  
 = 
  
 CampaignBudget 
 . 
 newBuilder 
 () 
  
 . 
 setName 
 ( 
 "Shared Interplanetary Budget #" 
  
 + 
  
 getPrintableDateTime 
 ()) 
  
 . 
 setAmountMicros 
 ( 
 50_000_000L 
 ) 
  
 . 
 setDeliveryMethod 
 ( 
 BudgetDeliveryMethod 
 . 
 STANDARD 
 ) 
  
 . 
 setExplicitlyShared 
 ( 
 true 
 ) 
  
 . 
 build 
 (); 
  
 // Constructs an operation that will create a shared budget. 
  
 CampaignBudgetOperation 
  
 operation 
  
 = 
  
 CampaignBudgetOperation 
 . 
 newBuilder 
 (). 
 setCreate 
 ( 
 budget 
 ). 
 build 
 (); 
  
 // Sends the operation in a mutate request. 
  
 MutateCampaignBudgetsResponse 
  
 response 
  
 = 
  
 campaignBudgetServiceClient 
 . 
 mutateCampaignBudgets 
 ( 
  
 Long 
 . 
 toString 
 ( 
 customerId 
 ), 
  
 Lists 
 . 
 newArrayList 
 ( 
 operation 
 )); 
  
 MutateCampaignBudgetResult 
  
 mutateCampaignBudgetResult 
  
 = 
  
 response 
 . 
 getResults 
 ( 
 0 
 ); 
  
 // Prints the resource name of the created object. 
  
 System 
 . 
 out 
 . 
 printf 
 ( 
  
 "Created shared budget with resource name: '%s'.%n" 
 , 
  
 mutateCampaignBudgetResult 
 . 
 getResourceName 
 ()); 
  
 return 
  
 mutateCampaignBudgetResult 
 . 
 getResourceName 
 (); 
  
 } 
 } 
   UsePortfolioBiddingStrategy 
 . 
 java

C#

 private 
  
 string 
  
 CreateSharedBudget 
 ( 
 GoogleAdsClient 
  
 client 
 , 
  
 long 
  
 customerId 
 , 
  
 string 
  
 name 
 , 
  
 long 
  
 amount 
 ) 
 { 
  
 // Get the CampaignBudgetService. 
  
 CampaignBudgetServiceClient 
  
 campaignBudgetService 
  
 = 
  
 client 
 . 
 GetService 
 ( 
 Services 
 . 
 V22 
 . 
 CampaignBudgetService 
 ); 
  
 // Create a shared budget. 
  
 CampaignBudget 
  
 budget 
  
 = 
  
 new 
  
 CampaignBudget 
 () 
  
 { 
  
 Name 
  
 = 
  
 name 
 , 
  
 AmountMicros 
  
 = 
  
 amount 
 , 
  
 DeliveryMethod 
  
 = 
  
 BudgetDeliveryMethodEnum 
 . 
 Types 
 . 
 BudgetDeliveryMethod 
 . 
 Standard 
 , 
  
 ExplicitlyShared 
  
 = 
  
 true 
  
 }; 
  
 // Create the operation. 
  
 CampaignBudgetOperation 
  
 campaignBudgetOperation 
  
 = 
  
 new 
  
 CampaignBudgetOperation 
 () 
  
 { 
  
 Create 
  
 = 
  
 budget 
  
 }; 
  
 // Make the mutate request. 
  
 MutateCampaignBudgetsResponse 
  
 retVal 
  
 = 
  
 campaignBudgetService 
 . 
 MutateCampaignBudgets 
 ( 
  
 customerId 
 . 
 ToString 
 (), 
  
 new 
  
 CampaignBudgetOperation 
 [] 
  
 { 
  
 campaignBudgetOperation 
  
 }); 
  
 return 
  
 retVal 
 . 
 Results 
 [ 
 0 
 ]. 
 ResourceName 
 ; 
 } 
   UsePortfolioBiddingStrategy 
 . 
 cs

PHP

 private static function createSharedCampaignBudget( 
 GoogleAdsClient $googleAdsClient, 
 int $customerId 
 ) { 
 // Creates a shared budget. 
 $budget = new CampaignBudget([ 
 'name' => 'Shared Interplanetary Budget #' . Helper::getPrintableDatetime(), 
 'delivery_method' => BudgetDeliveryMethod::STANDARD, 
 // Sets the amount of budget. 
 'amount_micros' => 50000000, 
 // Makes the budget explicitly shared. 
 'explicitly_shared' => true 
 ]); 
 // Constructs a campaign budget operation. 
 $campaignBudgetOperation = new CampaignBudgetOperation(); 
 $campaignBudgetOperation->setCreate($budget); 
 // Issues a mutate request to create the budget. 
 $campaignBudgetServiceClient = $googleAdsClient->getCampaignBudgetServiceClient(); 
 $response = $campaignBudgetServiceClient->mutateCampaignBudgets( 
 MutateCampaignBudgetsRequest::build($customerId, [$campaignBudgetOperation]) 
 ); 
 /** @var CampaignBudget $addedBudget */ 
 $addedBudget = $response->getResults()[0]; 
 printf( 
 "Created a shared budget with resource name '%s'.%s", 
 $addedBudget->getResourceName(), 
 PHP_EOL 
 ); 
 return $addedBudget->getResourceName(); 
 }  UsePortfolioBiddingStrategy.php

# Create a budget, which can be shared by multiple campaigns. campaign_budget_operation : CampaignBudgetOperation = client . get_type ( "CampaignBudgetOperation" ) campaign_budget : CampaignBudget = campaign_budget_operation . create campaign_budget . name = f "Interplanetary Budget { uuid . uuid4 () } " campaign_budget . delivery_method = ( client . enums . BudgetDeliveryMethodEnum . STANDARD ) campaign_budget . amount_micros = 500000 campaign_budget . explicitly_shared = True # Add budget. try : campaign_budget_response : MutateCampaignBudgetsResponse = ( campaign_budget_service . mutate_campaign_budgets ( customer_id = customer_id , operations = [ campaign_budget_operation ] ) ) campaign_budget_id : str = campaign_budget_response . results [ 0 ] . resource_name print ( f 'Budget " { campaign_budget_id } " was created.' ) except GoogleAdsException as ex : handle_googleads_exception ( ex )

use_portfolio_bidding_strategy . py

# Create a budget, which can be shared by multiple campaigns. budget = client . resource . campaign_budget do | cb | cb . name = "Interplanetary budget # #{ ( Time . new . to_f * 1000 ) . to_i } " cb . amount_micros = 50_000_000 cb . delivery_method = :STANDARD cb . explicitly_shared = true end operation = client . operation . create_resource . campaign_budget ( budget ) response = client . service . campaign_budget . mutate_campaign_budgets ( customer_id : customer_id , operations : [ operation ] , ) budget_id = response . results . first . resource_name

use_portfolio_bidding_strategy

. rb

sub create_shared_campaign_buget { my ( $api_client , $customer_id ) = @_ ; # Create a shared budget. my $campaign_budget = Google::Ads::GoogleAds::V22::Resources:: CampaignBudget - > new ({ name = > "Shared Interplanetary Budget #" . uniqid (), deliveryMethod = > STANDARD , # Set the amount of budget. amountMicros = > 50000000 , # Makes the budget explicitly shared. explicitlyShared = > 'true' }); # Create a campaign budget operation. my $campaign_budget_operation = Google::Ads::GoogleAds::V22::Services::CampaignBudgetService:: CampaignBudgetOperation - > new ({ create = > $campaign_budget }); # Add the campaign budget. my $campaign_budgets_response = $api_client - > CampaignBudgetService () - > mutate ({ customerId = > $customer_id , operations = > [ $campaign_budget_operation ]}); my $campaign_budget_resource_name = $campaign_budgets_response - > { results }[ 0 ]{ resourceName }; printf "Created a shared budget with resource name: '%s'.\n" , $campaign_budget_resource_name ; return $campaign_budget_resource_name ; }

use_portfolio_bidding_strategy . pl

Determine if a campaign budget is shared

You can retrieve the budget setting value by searching for the campaign_budget.explicitly_shared field. Here is the GAQL query for the field, filtering on a budget ID:

 SELECT 
  
 campaign_budget 
 . 
 explicitly_shared 
 FROM 
  
 campaign_budget 
 WHERE 
  
 campaign_budget 
 . 
 id 
  
 = 
  
  campaign_budget_id

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-11-05 UTC.

Sharing Campaign Budgets

AI-generated Key Takeaways

Setup

Java

C#

PHP

Python

Ruby

Perl

Determine if a campaign budget is shared

Sharing Campaign Budgets Stay organized with collections Save and categorize content based on your preferences.

AI-generated Key Takeaways

Setup

Java

C#

PHP

Python

Ruby

Perl

Determine if a campaign budget is shared

Sharing Campaign Budgets