List Google Ads generated assets

curl --request GET \
  --url https://app.base44.com/api/apps/{app_id}/google-ads/assets \
  --header 'api_key: <api-key>'

const options = {method: 'GET', headers: {api_key: '<api-key>'}};

fetch('https://app.base44.com/api/apps/{app_id}/google-ads/assets', 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",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "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"
	"net/http"
	"io"
)

func main() {

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

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("api_key", "<api-key>")

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

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

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

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

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

request = Net::HTTP::Get.new(url)
request["api_key"] = '<api-key>'

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

{
  "session": [],
  "library": [],
  "durable": []
}

Assets

List Google Ads generated assets

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

Returns the ad creative Base44 has generated for the app.

Which field you get back depends on what you ask for, and you never get both session and library:

Send session_id and you get session, the previews from that one generation. Use it to poll a generation you just started. Previews are transient, so an expired session reads as an empty list.
Omit session_id and you get library, the app’s generated assets newest first. This is the durable copy and the one to read when you want to pick something to use. It returns at most the 5,000 most recent, with no pagination and no marker when it truncates.
Add campaign_id to either and you also get durable, read live from Google Ads, listing what is already attached to that campaign.

The two lists carry different fields, because they come from different stores. library rows add status, accepted_campaign_id and accepted_resource_names, which is how you tell what has already been pushed to Google.

A session list is empty rather than missing while a generation is in flight, so poll until assets appear rather than treating the first empty read as failure.

Sending campaign_id brings the campaign’s own errors with it, because the campaign has to be resolved before Google can be read. Without campaign_id this endpoint only ever answers 200, 401 or 403.

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.

GET

api

apps

{app_id}

google-ads

assets

List Google Ads generated assets

curl --request GET \
  --url https://app.base44.com/api/apps/{app_id}/google-ads/assets \
  --header 'api_key: <api-key>'

const options = {method: 'GET', headers: {api_key: '<api-key>'}};

fetch('https://app.base44.com/api/apps/{app_id}/google-ads/assets', 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",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "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"
	"net/http"
	"io"
)

func main() {

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

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("api_key", "<api-key>")

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

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

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

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

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

request = Net::HTTP::Get.new(url)
request["api_key"] = '<api-key>'

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

{
  "session": [],
  "library": [],
  "durable": []
}

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.

Query Parameters

session_id

string | null

Return the previews from this generation session instead of the durable library, as returned in session_id by Generate Google Ads assets.

campaign_id

string | null

Also return what is already attached to this campaign in Google Ads, as returned in id by List campaigns.

Response

The app's generated creative.

The app's generated Google Ads creative.

session

GeneratedAssetSummary · object[] | null

Assets in the generation session you asked for. Present only when you send session_id, and an empty list while the generation is still running or when it produced nothing.

Show child attributes

Example:

[]

library

LibraryAssetSummary · object[] | null

The app's generated assets, newest first, capped at the 5,000 most recent. Present only when you omit session_id. There is no pagination and nothing marks a truncated list, so an app past 5,000 assets silently stops seeing its oldest ones.

Show child attributes

Example:

[]

durable

DurableAssetRow · object[] | null

Assets already attached to the campaign in Google Ads. Present only when you send campaign_id.

Show child attributes

Example:

[]

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

List Google Ads generated assets

Authorizations

Path Parameters

Query Parameters

Response