GenerateTextRequest

  • The GenerateText request requires a customer_id and asset_field_types to specify which text asset types to generate.

  • Optional fields like final_url, freeform_prompt, and keywords can be provided to guide the text generation process.

  • The generation context can be set using either an existing_generation_context or by specifying an advertising_channel_type.

  • A final_url is required unless an existing_generation_context with an associated final URL is provided.

  • The advertising channel type is required if no existing_context is provided, supporting SEARCH, PERFORMANCE_MAX, DISPLAY, and DEMAND_GEN.

Request message for AssetGenerationService.GenerateText

Proto definition GitHub

Fields

asset_field_types[]

AssetFieldType

Required. Which field types text is being generated for. Supported values are: HEADLINE, LONG_HEADLINE, DESCRIPTION. Required.

context

Union field. Additional context to guide the generation process.

context can be only one of the following:

advertising_channel_type

AdvertisingChannelType

Optional. The advertising channel for which to generate assets. Required if existing_context is not provided.

Supported channel types: SEARCH, PERFORMANCE_MAX, DISPLAY, and DEMAND_GEN

existing_generation_context

AssetGenerationExistingContext

Optional. The setting for which assets are being generated, such as an existing AssetGroup or AdGroupAd.

customer_id

string

Required. The ID of the customer to generate assets for. Required.

final_url

string

Optional. Final url to use as a source for generating assets. Required if existing_generation_context is not provided or does not have a final url associated with it.

freeform_prompt

string

Optional. A freeform description of what assets should be generated. The string length must be between 1 and 1500, inclusive.

keywords[]

string

Optional. A freeform list of keywords that are relevant, used to inform asset generation.