List Google Ads generated assets
<Info>This API is in beta. Endpoints, fields, and behavior may still change, so avoid depending on it in production.</Info>
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.
<Note>This endpoint accepts a personal API key. Workspace API keys are not authorized for it and are rejected with a 403.</Note>
<Warning>The response includes fields beyond the ones documented here. Don't rely on undocumented response fields, as they can change at any time.</Warning>
Path parameters
ID of the app whose Google Ads creative you want to generate or read.
ID of the app whose Google Ads creative you want to generate or read.
Query parameters
Return the previews from this generation session instead of the durable library, as returned in session_id by Generate Google Ads assets.
Return the previews from this generation session instead of the durable library, as returned in session_id by Generate Google Ads assets.
Also return what is already attached to this campaign in Google Ads, as returned in id by List campaigns.
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.
Example response
{
"session": [],
"library": [],
"durable": []
}Changes
No recorded changes to this endpoint across all 1 revision of this API.