Accept a generated Google Ads asset

curl --request POST \
  --url https://app.base44.com/api/apps/{app_id}/google-ads/assets/{session_asset_id}/accept \
  --header 'Content-Type: application/json' \
  --header 'api_key: <api-key>' \
  --data '
{
  "session_id": "9c1d2e3f-4a5b-6c7d-8e9f-0a1b2c3d4e5f",
  "campaign_id": "68b1c0d4e7b91d003c45a1f2"
}
'

import requests

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

payload = {
    "session_id": "9c1d2e3f-4a5b-6c7d-8e9f-0a1b2c3d4e5f",
    "campaign_id": "68b1c0d4e7b91d003c45a1f2"
}
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({
    session_id: '9c1d2e3f-4a5b-6c7d-8e9f-0a1b2c3d4e5f',
    campaign_id: '68b1c0d4e7b91d003c45a1f2'
  })
};

fetch('https://app.base44.com/api/apps/{app_id}/google-ads/assets/{session_asset_id}/accept', 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/{session_asset_id}/accept",
  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([
    'session_id' => '9c1d2e3f-4a5b-6c7d-8e9f-0a1b2c3d4e5f',
    'campaign_id' => '68b1c0d4e7b91d003c45a1f2'
  ]),
  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/{session_asset_id}/accept"

	payload := strings.NewReader("{\n  \"session_id\": \"9c1d2e3f-4a5b-6c7d-8e9f-0a1b2c3d4e5f\",\n  \"campaign_id\": \"68b1c0d4e7b91d003c45a1f2\"\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/{session_asset_id}/accept")
  .header("api_key", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"session_id\": \"9c1d2e3f-4a5b-6c7d-8e9f-0a1b2c3d4e5f\",\n  \"campaign_id\": \"68b1c0d4e7b91d003c45a1f2\"\n}")
  .asString();

require 'uri'
require 'net/http'

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

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  \"session_id\": \"9c1d2e3f-4a5b-6c7d-8e9f-0a1b2c3d4e5f\",\n  \"campaign_id\": \"68b1c0d4e7b91d003c45a1f2\"\n}"

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

{
  "accepted": true,
  "session_asset_id": "b7f3a1c8-52d4-4a0e-9b31-2c6f0d8e4a19",
  "asset_field_type": "SQUARE_MARKETING_IMAGE",
  "kind": "image",
  "source": "google",
  "asset_group_count": 2,
  "resource_name": "customers/1234567890/assets/98765432"
}

Assets

Accept a generated Google Ads asset

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

Puts one generated asset onto a live Performance Max campaign.

This is the step that reaches Google Ads. Up to here creative is only a preview, and this creates the asset on the app’s own Google Ads account and links it to every asset group the campaign has, with the slot the asset was generated for. After this Google Ads is the source of truth for it.

You can accept an asset long after the generation that produced it. Base44 looks the asset up in the app’s durable library first and only falls back to the live session, so an asset you read from library works even though its preview has expired. session_id is still required, because it is what the fallback needs.

Performance Max only. Other campaign types have no asset groups, so they are rejected with a 422.

A 409 covers four different situations and the message is what tells them apart, so read it rather than retrying blindly. Waiting is right for an image that is still processing, syncing is right for a campaign that has not reached Google Ads, and regenerating is right for an asset that is no longer usable.

Accepting the same picture twice creates a second asset on the campaign. Google has no content check for images, so a retried or repeated accept leaves you with duplicate creative that you have to remove in Google Ads. Copy is safe to repeat, because Google matches identical text and reuses the existing asset. Treat an image accept as a one-shot and read List Google Ads generated assets to check status before retrying.

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

{session_asset_id}

Accept a generated Google Ads asset

curl --request POST \
  --url https://app.base44.com/api/apps/{app_id}/google-ads/assets/{session_asset_id}/accept \
  --header 'Content-Type: application/json' \
  --header 'api_key: <api-key>' \
  --data '
{
  "session_id": "9c1d2e3f-4a5b-6c7d-8e9f-0a1b2c3d4e5f",
  "campaign_id": "68b1c0d4e7b91d003c45a1f2"
}
'

import requests

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

payload = {
    "session_id": "9c1d2e3f-4a5b-6c7d-8e9f-0a1b2c3d4e5f",
    "campaign_id": "68b1c0d4e7b91d003c45a1f2"
}
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({
    session_id: '9c1d2e3f-4a5b-6c7d-8e9f-0a1b2c3d4e5f',
    campaign_id: '68b1c0d4e7b91d003c45a1f2'
  })
};

fetch('https://app.base44.com/api/apps/{app_id}/google-ads/assets/{session_asset_id}/accept', 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/{session_asset_id}/accept",
  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([
    'session_id' => '9c1d2e3f-4a5b-6c7d-8e9f-0a1b2c3d4e5f',
    'campaign_id' => '68b1c0d4e7b91d003c45a1f2'
  ]),
  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/{session_asset_id}/accept"

	payload := strings.NewReader("{\n  \"session_id\": \"9c1d2e3f-4a5b-6c7d-8e9f-0a1b2c3d4e5f\",\n  \"campaign_id\": \"68b1c0d4e7b91d003c45a1f2\"\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/{session_asset_id}/accept")
  .header("api_key", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"session_id\": \"9c1d2e3f-4a5b-6c7d-8e9f-0a1b2c3d4e5f\",\n  \"campaign_id\": \"68b1c0d4e7b91d003c45a1f2\"\n}")
  .asString();

require 'uri'
require 'net/http'

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

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  \"session_id\": \"9c1d2e3f-4a5b-6c7d-8e9f-0a1b2c3d4e5f\",\n  \"campaign_id\": \"68b1c0d4e7b91d003c45a1f2\"\n}"

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

{
  "accepted": true,
  "session_asset_id": "b7f3a1c8-52d4-4a0e-9b31-2c6f0d8e4a19",
  "asset_field_type": "SQUARE_MARKETING_IMAGE",
  "kind": "image",
  "source": "google",
  "asset_group_count": 2,
  "resource_name": "customers/1234567890/assets/98765432"
}

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.

session_asset_id

string

required

ID of the generated asset to attach, as returned in session_asset_id by Generate Google Ads assets or List Google Ads generated assets.

Body

application/json

session_id

string

required

The generation the asset came from, as returned in session_id by Generate Google Ads assets.

Example:

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

campaign_id

string

required

The Performance Max campaign to attach the asset to, as returned in id by List campaigns.

Example:

"68b1c0d4e7b91d003c45a1f2"

Response

The asset was attached to the campaign.

The outcome of attaching a generated asset to a campaign.

accepted

boolean

required

Always true on a success, so it carries no information beyond the status code. Read asset_group_count to see how far the attach reached.

Example:

true

session_asset_id

string

required

The asset that was attached, echoed from the path.

Example:

"b7f3a1c8-52d4-4a0e-9b31-2c6f0d8e4a19"

asset_field_type

string

required

Which slot on the ad this asset fills. Text assets are HEADLINE, LONG_HEADLINE or DESCRIPTION. Image assets are MARKETING_IMAGE, SQUARE_MARKETING_IMAGE, PORTRAIT_MARKETING_IMAGE or TALL_PORTRAIT_MARKETING_IMAGE.

Example:

"SQUARE_MARKETING_IMAGE"

kind

string

required

Whether the asset is copy (text) or a picture (image).

Example:

"image"

source

string

required

Which engine wrote it. The value is google for Google's own asset generation and inhouse for the Base44 model that covers languages Google does not generate for, and that stands in when Google's call fails.

Example:

"google"

asset_group_count

integer

required

How many of the campaign's asset groups the asset was linked to. The asset goes on every asset group the campaign has, so this is that count.

Example:

2

resource_name

string

required

Google Ads resource name of the asset that now holds this creative. Empty when Google's response carried no resource name, which does not mean the attach failed.

Example:

"customers/1234567890/assets/98765432"

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

Accept a generated Google Ads asset

Authorizations

Path Parameters

Body

Response