Regenerate Google Ads asset group creative
Generates fresh creative for one asset group, for when its existing creative has stopped performing.
Use it when List Google Ads asset performance shows an asset group rated POOR or LOW. That endpoint tells you creative has gone stale; this is what replaces it.
Nothing reaches Google Ads here. The response is the same shape as Generate Google Ads assets, and the new creative comes back as previews you accept one at a time with Accept a generated Google Ads asset. Nothing on the asset group is replaced or removed for you, so accepting adds to what is already there rather than swapping it.
Pass the asset group’s Google Ads ID, which is numeric. Anything else is rejected with a 422 without a call to Google.
The rate limits, the two 200 shapes, and the retry accounting are the same as Generate Google Ads assets, because this runs the same generation underneath.
Authorizations
Personal API key.
Path Parameters
ID of the app whose Google Ads creative you want to generate or read.
Google Ads' own numeric ID for the asset group, as reported in asset_group_id by List Google Ads asset performance.
Body
Campaign type to generate for, which decides the slots that get filled. One of PERFORMANCE_MAX, DEMAND_GEN, SEARCH or DISPLAY. Asset groups belong to Performance Max campaigns, so the default is the value you almost always want.
"PERFORMANCE_MAX"
Page the new pictures should be based on. Send this or freeform_prompt, not both, or omit both to ground the creative in the app's own home page.
"https://example.com/spring"
What the new creative should show, in your own words, up to 1500 characters. Send this or final_url, not both.
"Brighter lifestyle shots with the product in use"
Response
The replacement creative that was generated.
The creative one generation produced.
ID of this generation. Pass it as session_id to List Google Ads generated assets to poll for the images that are still coming.
"9c1d2e3f-4a5b-6c7d-8e9f-0a1b2c3d4e5f"
The copy that was generated. Empty when the text engine produced nothing and when a generation for this app was already running.
The pictures that finished in time to be returned inline. The rest are counted in background_image_count.
How many more pictures are still being generated for this session. The response comes back as soon as the copy is done, so poll List Google Ads generated assets with session_id for these. The field is absent when a generation for this app was already running, which is how you tell that case apart.
3
Language the copy was written in, as a lowercase two-letter code. It comes from the app's own site rather than from anything you send. The field is absent when a generation for this app was already running.
"de"