> ## Documentation Index > Fetch the complete documentation index at: https://docs.base44.com/llms.txt > Use this file to discover all available pages before exploring further. # Generate Google Ads assets > This API is in beta. Endpoints, fields, and behavior may still change, so avoid depending on it in production. Writes ad copy and generates pictures for the app in one call, and returns them as previews. Nothing reaches Google Ads here. Everything comes back as a preview you look at first, and only [Accept a generated Google Ads asset](/api-reference/accept-a-generated-google-ads-asset) puts one on a live campaign. Which slots get filled follows `channel_type`. `SEARCH` gets `HEADLINE` and `DESCRIPTION` copy plus landscape and square pictures. `DISPLAY` gets the same pictures and adds `LONG_HEADLINE` copy. `PERFORMANCE_MAX` and `DEMAND_GEN` get that copy plus all four picture shapes, adding portrait and tall portrait. You cannot ask for individual slots on this endpoint. The copy is written in the language of the app's own site, not the language you ask in, and the response reports which one in `language`. Pictures take longer than copy, so the response returns as soon as the copy is ready. `images` holds only the pictures that finished in time and `background_image_count` says how many more are coming. Poll [List Google Ads generated assets](/api-reference/list-google-ads-generated-assets) with the returned `session_id` for the rest. Only one generation runs per app at a time. Calling this while one is already running returns a 200 carrying **that** run's `session_id` with `text` and `images` empty, and with `background_image_count` and `language` absent. That absence is how you tell it apart from a generation that genuinely produced nothing, and the right response is to poll the `session_id` you were given rather than to retry. Rate limits are per app and split across two pools. The copy costs 2 of 20 requests a minute. The pictures cost one of 10 requests a minute for each picture shape, so a `PERFORMANCE_MAX` call costs 4 and a `SEARCH` call costs 2. The picture pool runs out first, which puts a `PERFORMANCE_MAX` ceiling of about two calls a minute. A leg that has nothing to do costs nothing. Each leg can also retry once, as below, and the retry costs that leg the same again. When Google refuses the page you pointed at, Base44 retries once on the app's own published URL, and that retry costs the same again. Pace requests against the doubled figure, not the single one, or a refusal-heavy app hits a 429 part-way through its own recovery. Generating creative does not spend credits and is not billed. It is capped by rate limits instead, so a burst gets a 429 rather than a bill. When one leg fails and the other produced something, you get a 200 with only the successful leg's assets. The failure is only raised when neither leg produced anything, so check `text` and `images` rather than assuming a 200 means both ran. 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. ## OpenAPI ````yaml /developers/references/app-management/app-management-openapi.json post /api/apps/{app_id}/google-ads/assets/generate-all openapi: 3.1.0 info: title: Base44 App Management API version: 1.0.0 servers: - url: https://app.base44.com security: - ApiKeyAuth: [] paths: /api/apps/{app_id}/google-ads/assets/generate-all: post: summary: Generate Google Ads assets description: >- This API is in beta. Endpoints, fields, and behavior may still change, so avoid depending on it in production. Writes ad copy and generates pictures for the app in one call, and returns them as previews. Nothing reaches Google Ads here. Everything comes back as a preview you look at first, and only [Accept a generated Google Ads asset](/api-reference/accept-a-generated-google-ads-asset) puts one on a live campaign. Which slots get filled follows `channel_type`. `SEARCH` gets `HEADLINE` and `DESCRIPTION` copy plus landscape and square pictures. `DISPLAY` gets the same pictures and adds `LONG_HEADLINE` copy. `PERFORMANCE_MAX` and `DEMAND_GEN` get that copy plus all four picture shapes, adding portrait and tall portrait. You cannot ask for individual slots on this endpoint. The copy is written in the language of the app's own site, not the language you ask in, and the response reports which one in `language`. Pictures take longer than copy, so the response returns as soon as the copy is ready. `images` holds only the pictures that finished in time and `background_image_count` says how many more are coming. Poll [List Google Ads generated assets](/api-reference/list-google-ads-generated-assets) with the returned `session_id` for the rest. Only one generation runs per app at a time. Calling this while one is already running returns a 200 carrying **that** run's `session_id` with `text` and `images` empty, and with `background_image_count` and `language` absent. That absence is how you tell it apart from a generation that genuinely produced nothing, and the right response is to poll the `session_id` you were given rather than to retry. Rate limits are per app and split across two pools. The copy costs 2 of 20 requests a minute. The pictures cost one of 10 requests a minute for each picture shape, so a `PERFORMANCE_MAX` call costs 4 and a `SEARCH` call costs 2. The picture pool runs out first, which puts a `PERFORMANCE_MAX` ceiling of about two calls a minute. A leg that has nothing to do costs nothing. Each leg can also retry once, as below, and the retry costs that leg the same again. When Google refuses the page you pointed at, Base44 retries once on the app's own published URL, and that retry costs the same again. Pace requests against the doubled figure, not the single one, or a refusal-heavy app hits a 429 part-way through its own recovery. Generating creative does not spend credits and is not billed. It is capped by rate limits instead, so a burst gets a 429 rather than a bill. When one leg fails and the other produced something, you get a 200 with only the successful leg's assets. The failure is only raised when neither leg produced anything, so check `text` and `images` rather than assuming a 200 means both ran. 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. operationId: >- generate_all_assets_api_apps__app_id__google_ads_assets_generate_all_post parameters: - name: app_id in: path required: true schema: type: string description: >- ID of the app whose Google Ads creative you want to generate or read. title: App Id description: >- ID of the app whose Google Ads creative you want to generate or read. example: 6820f3a4e7b91d003c45a1f2 requestBody: required: true content: application/json: schema: title: GenerateAssets type: object properties: channel_type: type: string description: >- Campaign type to generate for, which decides the slots that get filled. One of `PERFORMANCE_MAX`, `DEMAND_GEN`, `SEARCH` or `DISPLAY`. default: PERFORMANCE_MAX example: PERFORMANCE_MAX final_url: type: string description: >- Page the pictures should be based on. Send this or `freeform_prompt`, not both. example: https://example.com/spring freeform_prompt: type: string description: >- What the pictures should show, in your own words, up to 1500 characters. Send this or `final_url`, not both. example: Warm studio shots of handmade oak dining tables example: channel_type: PERFORMANCE_MAX final_url: https://example.com/spring responses: '200': description: The creative that was generated. content: application/json: schema: $ref: '#/components/schemas/GenerateAssetsResult' '400': description: >- Google Ads rejected the generation request, for example a landing page it could not read. The response message carries Google's reason. '401': description: Missing or invalid credentials. '403': description: >- You don't have access to this app, the app does not exist, or you used a workspace API key. A missing app and an app you cannot reach are deliberately the same answer. '409': description: >- The request to Google Ads timed out after being sent. Nothing was attached to a campaign, so retrying is safe. '422': description: >- You sent both `final_url` and `freeform_prompt`, or `freeform_prompt` is longer than 1500 characters. '429': description: >- The app has used up one of the creative rate limits, either 20 copy requests a minute or 10 picture requests a minute. Retry later. components: schemas: GenerateAssetsResult: properties: session_id: type: string title: Session Id description: >- ID of this generation. Pass it as `session_id` to [List Google Ads generated assets](/api-reference/list-google-ads-generated-assets) to poll for the images that are still coming. example: 9c1d2e3f-4a5b-6c7d-8e9f-0a1b2c3d4e5f text: items: $ref: '#/components/schemas/GeneratedAssetSummary' type: array title: Text description: >- The copy that was generated. Empty when the text engine produced nothing and when a generation for this app was already running. example: [] images: items: $ref: '#/components/schemas/GeneratedAssetSummary' type: array title: Images description: >- The pictures that finished in time to be returned inline. The rest are counted in `background_image_count`. example: [] background_image_count: anyOf: - type: integer - type: 'null' title: Background Image Count description: >- 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](/api-reference/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. example: 3 language: anyOf: - type: string - type: 'null' title: Language description: >- 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. example: de type: object required: - session_id - text - images title: GenerateAssetsResult description: The creative one generation produced. GeneratedAssetSummary: properties: session_asset_id: type: string title: Session Asset Id description: >- ID of this asset within the session. Pass it as `session_asset_id` to [Accept a generated Google Ads asset](/api-reference/accept-a-generated-google-ads-asset). example: b7f3a1c8-52d4-4a0e-9b31-2c6f0d8e4a19 asset_field_type: type: string title: Asset Field Type description: >- 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: HEADLINE kind: type: string title: Kind description: Whether the asset is copy (`text`) or a picture (`image`). example: text text: anyOf: - type: string - type: 'null' title: Text description: The generated copy, or `null` on an image asset. example: Handmade oak furniture, built to last image_url: anyOf: - type: string - type: 'null' title: Image Url description: >- URL of the generated picture, or `null` on a text asset. It is a Base44 preview URL, not a Google one, and it stops resolving once the asset is cleaned up. example: https://storage.base44.com/gads-assets/b7f3a1c8-square.png source: type: string title: Source description: >- 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 language: anyOf: - type: string - type: 'null' title: Language description: >- Language of a text asset as a lowercase two-letter code, or `null` on an image, because image assets carry no copy. example: de channel_type: type: string title: Channel Type description: >- Campaign type the asset was generated for, one of `SEARCH`, `PERFORMANCE_MAX`, `DISPLAY` or `DEMAND_GEN`. example: PERFORMANCE_MAX created_at: type: string format: date-time title: Created At description: When the asset was generated. example: '2026-08-25T14:05:00Z' type: object required: - session_asset_id - asset_field_type - kind - text - image_url - source - language - channel_type - created_at title: GeneratedAssetSummary description: One generated asset in a live generation session. securitySchemes: ApiKeyAuth: type: apiKey in: header name: api_key description: Personal API key. ````