batch_update_presentation
Apply multiple updates to a Google Slides presentation in a single batch operation. Specify the user email, presentation ID, and list of update requests to modify slides efficiently.
Instructions
Apply batch updates to a Google Slides presentation.
Args: user_google_email (str): The user's Google email address. Required. presentation_id (str): The ID of the presentation to update. requests (List[Dict[str, Any]]): List of update requests to apply.
Returns: str: Details about the batch update operation results.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| presentation_id | Yes | ||
| requests | Yes | ||
| user_google_email | Yes |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |
Implementation Reference
- gslides/slides_tools.py:109-163 (handler)The primary handler function for the 'batch_update_presentation' tool. It registers the tool via @server.tool(), handles authentication and errors, and executes batch updates on a Google Slides presentation using the API's batchUpdate method. Processes requests, executes the API call off-thread, parses replies, and returns a formatted confirmation message with results.
@server.tool() @handle_http_errors("batch_update_presentation", service_type="slides") @require_google_service("slides", "slides") async def batch_update_presentation( service, user_google_email: str, presentation_id: str, requests: List[Dict[str, Any]] ) -> str: """ Apply batch updates to a Google Slides presentation. Args: user_google_email (str): The user's Google email address. Required. presentation_id (str): The ID of the presentation to update. requests (List[Dict[str, Any]]): List of update requests to apply. Returns: str: Details about the batch update operation results. """ logger.info(f"[batch_update_presentation] Invoked. Email: '{user_google_email}', ID: '{presentation_id}', Requests: {len(requests)}") body = { 'requests': requests } result = await asyncio.to_thread( service.presentations().batchUpdate( presentationId=presentation_id, body=body ).execute ) replies = result.get('replies', []) confirmation_message = f"""Batch Update Completed for {user_google_email}: - Presentation ID: {presentation_id} - URL: https://docs.google.com/presentation/d/{presentation_id}/edit - Requests Applied: {len(requests)} - Replies Received: {len(replies)}""" if replies: confirmation_message += "\n\nUpdate Results:" for i, reply in enumerate(replies, 1): if 'createSlide' in reply: slide_id = reply['createSlide'].get('objectId', 'Unknown') confirmation_message += f"\n Request {i}: Created slide with ID {slide_id}" elif 'createShape' in reply: shape_id = reply['createShape'].get('objectId', 'Unknown') confirmation_message += f"\n Request {i}: Created shape with ID {shape_id}" else: confirmation_message += f"\n Request {i}: Operation completed" logger.info(f"Batch update completed successfully for {user_google_email}") return confirmation_message