Generate Google Ads image assets

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

import requests

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

payload = {
    "asset_field_types": ["MARKETING_IMAGE", "SQUARE_MARKETING_IMAGE"],
    "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({
    asset_field_types: ['MARKETING_IMAGE', 'SQUARE_MARKETING_IMAGE'],
    final_url: 'https://example.com/spring'
  })
};

fetch('https://app.base44.com/api/apps/{app_id}/google-ads/assets/generate-images', 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-images",
  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([
    'asset_field_types' => [
        'MARKETING_IMAGE',
        'SQUARE_MARKETING_IMAGE'
    ],
    '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-images"

	payload := strings.NewReader("{\n  \"asset_field_types\": [\n    \"MARKETING_IMAGE\",\n    \"SQUARE_MARKETING_IMAGE\"\n  ],\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-images")
  .header("api_key", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"asset_field_types\": [\n    \"MARKETING_IMAGE\",\n    \"SQUARE_MARKETING_IMAGE\"\n  ],\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-images")

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  \"asset_field_types\": [\n    \"MARKETING_IMAGE\",\n    \"SQUARE_MARKETING_IMAGE\"\n  ],\n  \"final_url\": \"https://example.com/spring\"\n}"

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

{
  "session_id": "9c1d2e3f-4a5b-6c7d-8e9f-0a1b2c3d4e5f",
  "assets": [],
  "background_pending": true,
  "background_count": 3,
  "in_flight": true
}

Assets

Generate Google Ads image assets

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

Generates ad pictures for the app and returns them as previews.

Nothing reaches Google Ads here. Each picture comes back with a session_asset_id you pass to Accept a generated Google Ads asset to put it on a live campaign.

Send exactly one of final_url and freeform_prompt. Sending both is rejected, and so is sending neither, which is the one place this endpoint differs from Generate Google Ads assets, where omitting both is allowed and grounds the pictures in the app’s home page.

Pictures are slower than copy, so the response returns once the first one is ready. assets holds what finished in time and background_pending with background_count say that more are coming. Poll List Google Ads generated assets with the returned session_id for the rest. assets can be empty while background_pending is true, which means the pictures are being generated but none landed in time.

Only one generation of each kind runs per app at a time. Calling this while one is running returns a 200 carrying in_flight set to true, that run’s session_id, and an empty assets. Poll the session_id you were given rather than retrying.

Each shape in asset_field_types costs one of 10 picture requests a minute per app, and the retry below costs the whole shape count again. So four shapes cost 4 normally and 8 on a retry, which is one call a minute in the worst case rather than two, and a single shape costs 1 or 2.

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.

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-images

Generate Google Ads image assets

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

import requests

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

payload = {
    "asset_field_types": ["MARKETING_IMAGE", "SQUARE_MARKETING_IMAGE"],
    "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({
    asset_field_types: ['MARKETING_IMAGE', 'SQUARE_MARKETING_IMAGE'],
    final_url: 'https://example.com/spring'
  })
};

fetch('https://app.base44.com/api/apps/{app_id}/google-ads/assets/generate-images', 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-images",
  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([
    'asset_field_types' => [
        'MARKETING_IMAGE',
        'SQUARE_MARKETING_IMAGE'
    ],
    '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-images"

	payload := strings.NewReader("{\n  \"asset_field_types\": [\n    \"MARKETING_IMAGE\",\n    \"SQUARE_MARKETING_IMAGE\"\n  ],\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-images")
  .header("api_key", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"asset_field_types\": [\n    \"MARKETING_IMAGE\",\n    \"SQUARE_MARKETING_IMAGE\"\n  ],\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-images")

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  \"asset_field_types\": [\n    \"MARKETING_IMAGE\",\n    \"SQUARE_MARKETING_IMAGE\"\n  ],\n  \"final_url\": \"https://example.com/spring\"\n}"

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

{
  "session_id": "9c1d2e3f-4a5b-6c7d-8e9f-0a1b2c3d4e5f",
  "assets": [],
  "background_pending": true,
  "background_count": 3,
  "in_flight": true
}

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 the pictures are for, one of PERFORMANCE_MAX, DEMAND_GEN, SEARCH or DISPLAY. It does not restrict the shapes you may ask for.

Example:

"PERFORMANCE_MAX"

asset_field_types

string[]

Which picture shapes to generate, from MARKETING_IMAGE, SQUARE_MARKETING_IMAGE, PORTRAIT_MARKETING_IMAGE or TALL_PORTRAIT_MARKETING_IMAGE. Send between one and four entries. Each shape costs one request against the picture rate limit, so asking for fewer gets you more calls a minute. A text field type here is rejected with a 422.

One of MARKETING_IMAGE, SQUARE_MARKETING_IMAGE, PORTRAIT_MARKETING_IMAGE or TALL_PORTRAIT_MARKETING_IMAGE.

Example:

["MARKETING_IMAGE", "SQUARE_MARKETING_IMAGE"]

final_url

string

Page to base the pictures on. Send exactly one of this and freeform_prompt.

Example:

"https://example.com/spring"

freeform_prompt

string

What the pictures should show, in your own words, up to 1500 characters. Send exactly one of this and final_url.

Example:

"Warm studio shots of handmade oak dining tables"

Response

The pictures that were generated.

The pictures one image generation produced.

session_id

string

required

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

Example:

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

assets

GeneratedAssetSummary · object[]

required

The pictures that finished in time to be returned inline. Empty when nothing landed in time, when the engine produced nothing, and when a generation for this app was already running, which in_flight tells apart.

Show child attributes

Example:

[]

background_pending

boolean | null

Present and true when more pictures are still being generated under this session_id, including when assets came back empty because the first one took too long. Absent on a lock-miss response.

Example:

true

background_count

integer | null

How many more pictures are still being generated. Absent on a lock-miss response.

Example:

3

in_flight

boolean | null

Present and true only when an image generation for this app was already running, in which case session_id is that run's and assets is empty. Poll the returned session_id rather than retrying. The field is absent on every other response.

Example:

true

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 image assets

Authorizations

Path Parameters

Body

Response