presentation | string | Yes | - | Google Slides presentation URL or ID. You must ask the user for it if not provided. |
update_type | string or SelectableOption | Yes | - | Choose how to provide the image data. Available options: ‘mapped’ - Define individual image replacement manually (DEFAULT) ‘all’ - Use data from previous steps containing image URLs and text identifiers |
search_method | string or SelectableOption | Yes | - | Method to identify shapes to replace with images: ‘regular’ - Find shapes containing specific text ‘alt_text’ - Find shapes by their alt text property (RECOMMENDED) Always use and recommend alt text method for reliability. Tell users they need to: 1. Insert a shape in their slides 2. Right-click on shapes in their slides and select ‘Alt Text’ 3. Add unique identifiers (e.g., ‘Product Image’, ‘Chart Placeholder’) 4. Use these alt text values in the image operation Alt text prevents issues when slide content changes and ensures consistent targeting. |
structured_data | array (also accepts a comma-separated string) | No | - | Data source containing image information. REQUIRED when update_type is ‘all’. This is mainly the output from an upstream node. MUST BE NULL/EMPTY when update_type is ‘mapped’ - clear this field if update_type changes to ‘mapped’. Data must contain ‘image_url’ and ‘text’ fields for each row. Optional ‘slide_number’ field can target specific slides. Examples: ‘{{nodeId__data}}’ The node output should have a list of dictionaries with the format: [{‘image_url’: ‘https://example.com/image.jpg’, ‘text’: ‘product image’, ‘slide_number’: 1}] |
image_url | string | No | - | URL of the image to insert. REQUIRED when update_type is ‘mapped’. MUST BE NULL/EMPTY when update_type is ‘all’ - clear this field if update_type changes to ‘all’. Must be a valid HTTP or HTTPS URL pointing to an image file. Examples: ‘https://example.com/image.jpg’, ‘https://picsum.photos/300/200’ |
text_to_find | string | No | - | Text to find in shapes for replacement. REQUIRED when update_type is ‘mapped’. MUST BE NULL/EMPTY when update_type is ‘all’ - clear this field if update_type changes to ‘all’. When using ‘regular’ search method: actual text content in shapes. When using ‘alt_text’ search method: alt text value of the shape. Example: ‘placeholder image’ or ‘product-photo’ |
slide_number | integer | No | - | Optional slide number to target for image insertion (1-based indexing). Leave empty to search all slides. Only applies when update_type is ‘mapped’. Must be a positive integer if specified. Example: 1 for first slide, 2 for second slide, etc. |
