List Google Ads generated assets

Changed on

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

get/api/apps/{app_id}/google-ads/assets

Request

  • Base URL: https://app.base44.com
  • URL: https://app.base44.com/api/apps/{app_id}/google-ads/assets
  • Auth: HTTP bearer

Path parameters

app_idstring required

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

Query parameters

session_idstring

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

campaign_idstring

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

    • breaking

      query request parameter campaign_id list-of-types was narrowed by removing types null

    • breaking

      query request parameter session_id list-of-types was narrowed by removing types null

    • info

      for the query request parameter campaign_id, the type was generalized from no type to string

    • info

      for the query request parameter session_id, the type was generalized from no type to string

    • info

      the security scope read_only was added to the endpoint's security scheme PersonalAccessTokenAuth

    • info

      the security scope full_access was removed from the endpoint's security scheme PersonalAccessTokenAuth