Apply a Google Ads budget recommendation

curl --request POST \
  --url https://app.base44.com/api/apps/{app_id}/google-ads/campaigns/{campaign_id}/recommendations/apply-budget \
  --header 'Content-Type: application/json' \
  --header 'api_key: <api-key>' \
  --data '
{
  "recommendation_resource_name": "customers/1234567890/recommendations/AbC123",
  "recommended_daily_budget_micros": 45000000,
  "recommendation_type": "CAMPAIGN_BUDGET"
}
'

import requests

url = "https://app.base44.com/api/apps/{app_id}/google-ads/campaigns/{campaign_id}/recommendations/apply-budget"

payload = {
    "recommendation_resource_name": "customers/1234567890/recommendations/AbC123",
    "recommended_daily_budget_micros": 45000000,
    "recommendation_type": "CAMPAIGN_BUDGET"
}
headers = {
    "api_key": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {api_key: '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    recommendation_resource_name: 'customers/1234567890/recommendations/AbC123',
    recommended_daily_budget_micros: 45000000,
    recommendation_type: 'CAMPAIGN_BUDGET'
  })
};

fetch('https://app.base44.com/api/apps/{app_id}/google-ads/campaigns/{campaign_id}/recommendations/apply-budget', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://app.base44.com/api/apps/{app_id}/google-ads/campaigns/{campaign_id}/recommendations/apply-budget",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'recommendation_resource_name' => 'customers/1234567890/recommendations/AbC123',
    'recommended_daily_budget_micros' => 45000000,
    'recommendation_type' => 'CAMPAIGN_BUDGET'
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "api_key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://app.base44.com/api/apps/{app_id}/google-ads/campaigns/{campaign_id}/recommendations/apply-budget"

	payload := strings.NewReader("{\n  \"recommendation_resource_name\": \"customers/1234567890/recommendations/AbC123\",\n  \"recommended_daily_budget_micros\": 45000000,\n  \"recommendation_type\": \"CAMPAIGN_BUDGET\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("api_key", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://app.base44.com/api/apps/{app_id}/google-ads/campaigns/{campaign_id}/recommendations/apply-budget")
  .header("api_key", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"recommendation_resource_name\": \"customers/1234567890/recommendations/AbC123\",\n  \"recommended_daily_budget_micros\": 45000000,\n  \"recommendation_type\": \"CAMPAIGN_BUDGET\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://app.base44.com/api/apps/{app_id}/google-ads/campaigns/{campaign_id}/recommendations/apply-budget")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["api_key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"recommendation_resource_name\": \"customers/1234567890/recommendations/AbC123\",\n  \"recommended_daily_budget_micros\": 45000000,\n  \"recommendation_type\": \"CAMPAIGN_BUDGET\"\n}"

response = http.request(request)
puts response.read_body

{
  "id": "68b1c0d4e7b91d003c45a1f2",
  "daily_budget_micros": 45000000,
  "already_applied": true
}

{
  "detail": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>"
    }
  ]
}

Campaigns

Apply a Google Ads budget recommendation

This API is in beta. Endpoints, fields, and behavior may still change, so avoid depending on it in production.

Applies a Google Ads budget recommendation to a campaign, raising what it can spend per day.

Take recommendation_resource_name, recommended_daily_budget_micros and recommendation_type from a suggestion returned by List campaign optimization suggestions whose recommendation_type is CAMPAIGN_BUDGET.

You do not choose the amount. Base44 re-reads the recommendation from Google and applies Google’s current figure. recommended_daily_budget_micros is the amount you are confirming, not a value to set: if Google’s figure has changed since you read the suggestion, the call is rejected with a 409 so nobody raises a budget to a number they never saw. Read the suggestions again and resend.

This changes real spend. Applying the same recommendation twice is safe: the second call changes nothing and returns already_applied set to true.

Some recommendations cover a budget shared by several campaigns. Applying one raises the budget for all of them, so Base44 rejects it with a 409 unless every campaign it touches is one you manage here.

A 409 means the change may or may not have been applied: the request to Google Ads timed out after it was sent. Read the campaign back with Get campaign before retrying, or you can end up applying it twice.

This endpoint accepts a personal API key. Workspace API keys are not authorized for it and are rejected with a 403.

POST

api

apps

{app_id}

google-ads

campaigns

{campaign_id}

recommendations

apply-budget

Apply a Google Ads budget recommendation

curl --request POST \
  --url https://app.base44.com/api/apps/{app_id}/google-ads/campaigns/{campaign_id}/recommendations/apply-budget \
  --header 'Content-Type: application/json' \
  --header 'api_key: <api-key>' \
  --data '
{
  "recommendation_resource_name": "customers/1234567890/recommendations/AbC123",
  "recommended_daily_budget_micros": 45000000,
  "recommendation_type": "CAMPAIGN_BUDGET"
}
'

import requests

url = "https://app.base44.com/api/apps/{app_id}/google-ads/campaigns/{campaign_id}/recommendations/apply-budget"

payload = {
    "recommendation_resource_name": "customers/1234567890/recommendations/AbC123",
    "recommended_daily_budget_micros": 45000000,
    "recommendation_type": "CAMPAIGN_BUDGET"
}
headers = {
    "api_key": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {api_key: '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    recommendation_resource_name: 'customers/1234567890/recommendations/AbC123',
    recommended_daily_budget_micros: 45000000,
    recommendation_type: 'CAMPAIGN_BUDGET'
  })
};

fetch('https://app.base44.com/api/apps/{app_id}/google-ads/campaigns/{campaign_id}/recommendations/apply-budget', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://app.base44.com/api/apps/{app_id}/google-ads/campaigns/{campaign_id}/recommendations/apply-budget",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'recommendation_resource_name' => 'customers/1234567890/recommendations/AbC123',
    'recommended_daily_budget_micros' => 45000000,
    'recommendation_type' => 'CAMPAIGN_BUDGET'
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "api_key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://app.base44.com/api/apps/{app_id}/google-ads/campaigns/{campaign_id}/recommendations/apply-budget"

	payload := strings.NewReader("{\n  \"recommendation_resource_name\": \"customers/1234567890/recommendations/AbC123\",\n  \"recommended_daily_budget_micros\": 45000000,\n  \"recommendation_type\": \"CAMPAIGN_BUDGET\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("api_key", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://app.base44.com/api/apps/{app_id}/google-ads/campaigns/{campaign_id}/recommendations/apply-budget")
  .header("api_key", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"recommendation_resource_name\": \"customers/1234567890/recommendations/AbC123\",\n  \"recommended_daily_budget_micros\": 45000000,\n  \"recommendation_type\": \"CAMPAIGN_BUDGET\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://app.base44.com/api/apps/{app_id}/google-ads/campaigns/{campaign_id}/recommendations/apply-budget")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["api_key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"recommendation_resource_name\": \"customers/1234567890/recommendations/AbC123\",\n  \"recommended_daily_budget_micros\": 45000000,\n  \"recommendation_type\": \"CAMPAIGN_BUDGET\"\n}"

response = http.request(request)
puts response.read_body

{
  "id": "68b1c0d4e7b91d003c45a1f2",
  "daily_budget_micros": 45000000,
  "already_applied": true
}

{
  "detail": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>"
    }
  ]
}

Authorizations

api_key

string

header

required

Personal API key.

Path Parameters

app_id

string

required

ID of the app whose Google Ads campaigns to manage.

campaign_id

string

required

Base44's ID for the campaign, as returned in id by List campaigns. This is not the Google Ads campaign ID, which is reported separately as google_campaign_id.

Body

application/json

Request shape for the user-approved budget-recommendation apply.

recommendation_resource_name is Google's customers/.../recommendations/... id (used for idempotency + server-side re-resolution). The route re-fetches the recommendation from Google and applies Google's own recommended amount for the recommendation's target campaign, so the request body amount is advisory only (what the user saw) and a tampered value can't change what is applied. It is still bounds-checked by update_campaign_budget.

recommendation_resource_name

string

required

Google's identifier for the recommendation, taken from action_payload on the suggestion you are applying.

Minimum string length: 1

Example:

"customers/1234567890/recommendations/AbC123"

recommended_daily_budget_micros

integer

required

The daily budget the suggestion showed, in micros. This confirms what you saw rather than choosing an amount: if Google's current figure differs, the call is rejected with a 409 and nothing changes.

Example:

45000000

recommendation_type

string

default:""

The suggestion's recommendation_type, recorded for auditing.

Example:

"CAMPAIGN_BUDGET"

Response

The campaign's budget after the change.

The campaign's budget after applying Google's recommendation.

string

required

Base44's ID for the campaign whose budget changed.

Example:

"68b1c0d4e7b91d003c45a1f2"

daily_budget_micros

integer

required

The campaign's daily budget after the change, in micros.

Example:

45000000

already_applied

boolean | null

true when this recommendation had already been applied and nothing changed on this call, so a retry is safe. Absent when the call applied the change.

Example:

true

⌘I

App Management API (Beta)

Entities API (Beta)

Virality API (Beta)

Workflows API (Beta)

Analytics API (Beta)

Google Ads API (Beta)

Monitoring API

Audit Logs API

Apply a Google Ads budget recommendation

Authorizations

Path Parameters

Body

Response