Generate Google Ads assets

curl --request POST \
  --url https://app.base44.com/api/apps/{app_id}/google-ads/assets/generate-all \
  --header 'Content-Type: application/json' \
  --header 'api_key: <api-key>' \
  --data '
{
  "channel_type": "PERFORMANCE_MAX",
  "final_url": "https://example.com/spring"
}
'

import requests

url = "https://app.base44.com/api/apps/{app_id}/google-ads/assets/generate-all"

payload = {
    "channel_type": "PERFORMANCE_MAX",
    "final_url": "https://example.com/spring"
}
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({channel_type: 'PERFORMANCE_MAX', final_url: 'https://example.com/spring'})
};

fetch('https://app.base44.com/api/apps/{app_id}/google-ads/assets/generate-all', 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/assets/generate-all",
  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([
    'channel_type' => 'PERFORMANCE_MAX',
    'final_url' => 'https://example.com/spring'
  ]),
  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/assets/generate-all"

	payload := strings.NewReader("{\n  \"channel_type\": \"PERFORMANCE_MAX\",\n  \"final_url\": \"https://example.com/spring\"\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/assets/generate-all")
  .header("api_key", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"channel_type\": \"PERFORMANCE_MAX\",\n  \"final_url\": \"https://example.com/spring\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://app.base44.com/api/apps/{app_id}/google-ads/assets/generate-all")

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  \"channel_type\": \"PERFORMANCE_MAX\",\n  \"final_url\": \"https://example.com/spring\"\n}"

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

{
  "session_id": "9c1d2e3f-4a5b-6c7d-8e9f-0a1b2c3d4e5f",
  "text": [],
  "images": [],
  "background_image_count": 3,
  "language": "de"
}

Assets

Generate Google Ads assets

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

Writes ad copy and generates pictures for the app in one call, and returns them as previews.

Nothing reaches Google Ads here. Everything comes back as a preview you look at first, and only Accept a generated Google Ads asset puts one on a live campaign.

Which slots get filled follows channel_type. SEARCH gets HEADLINE and DESCRIPTION copy plus landscape and square pictures. DISPLAY gets the same pictures and adds LONG_HEADLINE copy. PERFORMANCE_MAX and DEMAND_GEN get that copy plus all four picture shapes, adding portrait and tall portrait. You cannot ask for individual slots on this endpoint.

The copy is written in the language of the app’s own site, not the language you ask in, and the response reports which one in language.

Pictures take longer than copy, so the response returns as soon as the copy is ready. images holds only the pictures that finished in time and background_image_count says how many more are coming. Poll List Google Ads generated assets with the returned session_id for the rest.

Only one generation runs per app at a time. Calling this while one is already running returns a 200 carrying that run’s session_id with text and images empty, and with background_image_count and language absent. That absence is how you tell it apart from a generation that genuinely produced nothing, and the right response is to poll the session_id you were given rather than to retry.

Rate limits are per app and split across two pools. The copy costs 2 of 20 requests a minute. The pictures cost one of 10 requests a minute for each picture shape, so a PERFORMANCE_MAX call costs 4 and a SEARCH call costs 2. The picture pool runs out first, which puts a PERFORMANCE_MAX ceiling of about two calls a minute. A leg that has nothing to do costs nothing. Each leg can also retry once, as below, and the retry costs that leg the same again.

When Google refuses the page you pointed at, Base44 retries once on the app’s own published URL, and that retry costs the same again. Pace requests against the doubled figure, not the single one, or a refusal-heavy app hits a 429 part-way through its own recovery.

Generating creative does not spend credits and is not billed. It is capped by rate limits instead, so a burst gets a 429 rather than a bill.

When one leg fails and the other produced something, you get a 200 with only the successful leg’s assets. The failure is only raised when neither leg produced anything, so check text and images rather than assuming a 200 means both ran.

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

The response includes fields beyond the ones documented here. Don’t rely on undocumented response fields, as they can change at any time. Send only the fields documented here. Other request fields are not supported and their behavior can change.

POST

api

apps

{app_id}

google-ads

assets

generate-all

Generate Google Ads assets

curl --request POST \
  --url https://app.base44.com/api/apps/{app_id}/google-ads/assets/generate-all \
  --header 'Content-Type: application/json' \
  --header 'api_key: <api-key>' \
  --data '
{
  "channel_type": "PERFORMANCE_MAX",
  "final_url": "https://example.com/spring"
}
'

import requests

url = "https://app.base44.com/api/apps/{app_id}/google-ads/assets/generate-all"

payload = {
    "channel_type": "PERFORMANCE_MAX",
    "final_url": "https://example.com/spring"
}
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({channel_type: 'PERFORMANCE_MAX', final_url: 'https://example.com/spring'})
};

fetch('https://app.base44.com/api/apps/{app_id}/google-ads/assets/generate-all', 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/assets/generate-all",
  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([
    'channel_type' => 'PERFORMANCE_MAX',
    'final_url' => 'https://example.com/spring'
  ]),
  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/assets/generate-all"

	payload := strings.NewReader("{\n  \"channel_type\": \"PERFORMANCE_MAX\",\n  \"final_url\": \"https://example.com/spring\"\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/assets/generate-all")
  .header("api_key", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"channel_type\": \"PERFORMANCE_MAX\",\n  \"final_url\": \"https://example.com/spring\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://app.base44.com/api/apps/{app_id}/google-ads/assets/generate-all")

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  \"channel_type\": \"PERFORMANCE_MAX\",\n  \"final_url\": \"https://example.com/spring\"\n}"

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

{
  "session_id": "9c1d2e3f-4a5b-6c7d-8e9f-0a1b2c3d4e5f",
  "text": [],
  "images": [],
  "background_image_count": 3,
  "language": "de"
}

Authorizations

api_key

string

header

required

Personal API key.

Path Parameters

app_id

string

required

ID of the app whose Google Ads creative you want to generate or read.

Body

application/json

channel_type

string

default:PERFORMANCE_MAX

Campaign type to generate for, which decides the slots that get filled. One of PERFORMANCE_MAX, DEMAND_GEN, SEARCH or DISPLAY.

Example:

"PERFORMANCE_MAX"

final_url

string

Page the pictures should be based on. Send this or freeform_prompt, not both.

Example:

"https://example.com/spring"

freeform_prompt

string

What the pictures should show, in your own words, up to 1500 characters. Send this or final_url, not both.

Example:

"Warm studio shots of handmade oak dining tables"

Response

The creative that was generated.

The creative one generation produced.

session_id

string

required

ID of this generation. Pass it as session_id to List Google Ads generated assets to poll for the images that are still coming.

Example:

"9c1d2e3f-4a5b-6c7d-8e9f-0a1b2c3d4e5f"

text

GeneratedAssetSummary · object[]

required

The copy that was generated. Empty when the text engine produced nothing and when a generation for this app was already running.

Show child attributes

Example:

[]

images

GeneratedAssetSummary · object[]

required

The pictures that finished in time to be returned inline. The rest are counted in background_image_count.

Show child attributes

Example:

[]

background_image_count

integer | null

How many more pictures are still being generated for this session. The response comes back as soon as the copy is done, so poll List Google Ads generated assets with session_id for these. The field is absent when a generation for this app was already running, which is how you tell that case apart.

Example:

3

language

string | null

Language the copy was written in, as a lowercase two-letter code. It comes from the app's own site rather than from anything you send. The field is absent when a generation for this app was already running.

Example:

"de"

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

Generate Google Ads assets

Authorizations

Path Parameters

Body

Response