presentation | string | Yes | - | Google Slides presentation URL or ID. You must ask the user for it if not provided. |
refresh_type | string or SelectableOption | Yes | - | Whether to refresh all charts or specific charts. Available options: ‘all’ - Refresh all Google Sheets charts in the presentation (DEFAULT) ‘specific’ - Refresh only specified charts using identifiers ‘Refresh all charts’ is recommended for most use cases as it’s simpler and ensures all data is current. |
identifier_type | string or SelectableOption | No | - | Type of identifier used to select specific charts. REQUIRED when refresh_type is ‘specific’. MUST BE NULL/EMPTY when refresh_type is ‘all’ - clear this field if refresh_type changes to ‘all’. Available options: ‘chart_id’ - Use Google Sheets chart IDs to identify charts ‘alt_text’ - Use alt text values to identify charts (RECOMMENDED) Alt text is recommended as it’s easier to work with than chart IDs. |
chart_identifiers | array of string | No | - | List of chart IDs or alt texts to refresh. REQUIRED when refresh_type is ‘specific’. MUST BE NULL/EMPTY when refresh_type is ‘all’ - clear this field if refresh_type changes to ‘all’. When identifier_type is ‘chart_id’: List of Google Sheets chart IDs When identifier_type is ‘alt_text’: List of alt text values assigned to charts Examples: - Chart IDs: [‘1234567890’, ‘0987654321’] - Alt texts: [‘Sales Chart’, ‘Revenue Dashboard’, ‘Performance Metrics’] |
slide_number | integer | No | - | Optional slide number to refresh charts on only that slide (1-based indexing). Leave empty to refresh charts on all slides in the presentation. Must be a positive integer if specified. Example: 1 for first slide, 2 for second slide, etc. |
