MCP Tools Reference: slidesmcp.googleapis.com

Herramienta: update_presentation

Actualiza una presentación con un conjunto de solicitudes de batchUpdate.

Corresponde a presentations.batchUpdate en la API de REST.

La lista de actualizaciones posibles es la siguiente:

  • createSlide: Crea una diapositiva nueva. Esquema:
    • objectId (cadena, opcional): Es un ID de objeto proporcionado por el usuario. Debe ser único si se especifica (entre 5 y 50 caracteres, que coincidan con [a-zA-Z0-9_-:]). Si se omite, se genera un ID.
    • insertionIndex (número entero, opcional): Índice basado en cero que indica dónde insertar la diapositiva. Si se omite, se inserta al final.
    • slideLayoutReference (objeto, opcional): Es la referencia de diseño de la diapositiva que se insertará (se requiere exactamente una si se especifica):
    • predefinedLayout (cadena): Es el nombre del diseño predefinido (p.ej., "BLANK", "TITLE_AND_BODY", "TITLE", "SECTION_HEADER", "SECTION_TITLE_AND_DESCRIPTION", "ONE_COLUMN_TEXT", "MAIN_POINT", "BIG_NUMBER", "TITLE_AND_TWO_COLUMNS").
    • layoutId (cadena): Es el ID de diseño del diseño principal actual.
    • placeholderIdMappings (array de objetos, opcional): Es la asignación de marcadores de posición del diseño a la diapositiva. Cada elemento:
    • layoutPlaceholder (objeto): {"type": string, "index": integer}.
    • objectId (cadena, obligatorio): Es el ID del objeto proporcionado por el usuario para el elemento de marcador de posición.
  • createShape: Crea una forma nueva. Esquema:
    • objectId (cadena, opcional): Es un ID de objeto proporcionado por el usuario. Si se omite, se genera un ID.
    • elementProperties (objeto, obligatorio): Ubicación y tamaño del elemento:
    • pageObjectId (cadena, obligatorio): Es el ID del objeto de la página en la que se encuentra la forma.
    • size (objeto, opcional): {"width": {"magnitude": number, "unit": string}, "height": {"magnitude": number, "unit": string}} (unidad: "PT" o "EMU").
    • transform (objeto, opcional): AffineTransform {"scaleX": number, "scaleY": number, "shearX": number, "shearY": number, "translateX": number, "translateY": number, "unit": string}.
    • shapeType (cadena, obligatorio): Tipo de forma (p. ej., "RECTANGLE", "ROUND_RECTANGLE", "ELLIPSE", "TEXT_BOX", "LINE", etcétera).
  • createTable: crea una nueva tabla. Esquema:
    • objectId (cadena, opcional): Es un ID de objeto proporcionado por el usuario. Si se omite, se genera un ID.
    • elementProperties (objeto, obligatorio): Ubicación y tamaño del elemento:
    • pageObjectId (cadena, obligatorio): Es el ID del objeto de la página en la que se encuentra la tabla.
    • size (objeto, opcional): {"width": {"magnitude": number, "unit": string}, "height": {"magnitude": number, "unit": string}}.
    • transform (objeto, opcional): AffineTransform {"scaleX": number, "scaleY": number, "shearX": number, "shearY": number, "translateX": number, "translateY": number, "unit": string}.
    • rows (número entero, obligatorio): Es la cantidad de filas de la tabla.
    • columns (número entero, obligatorio): Es la cantidad de columnas de la tabla.
  • insertText: Inserta texto en una forma o celda de tabla. Esquema:
    • objectId (cadena, obligatorio): Es el ID del objeto de la forma o la tabla.
    • cellLocation (objeto, opcional): Celda de la tabla si se inserta en la tabla: {"rowIndex": integer, "columnIndex": integer}.
    • text (cadena, obligatorio): Es el texto que se insertará.
    • insertionIndex (número entero, opcional): Es el índice de caracteres basado en cero en el que se insertará el texto. La configuración predeterminada es 0.
  • insertTableRows: Inserta filas en una tabla. Esquema:
    • tableObjectId (cadena, obligatorio): Es el ID del objeto de la tabla.
    • cellLocation (objeto, obligatorio): Ubicación de la celda de referencia: {"rowIndex": integer, "columnIndex": integer}.
    • insertBelow (booleano, obligatorio): Indica si se deben insertar filas nuevas debajo de la celda de referencia.
    • number (número entero, obligatorio): Es la cantidad de filas que se insertarán (máximo 20).
  • insertTableColumns: Inserta columnas en una tabla. Esquema:
    • tableObjectId (cadena, obligatorio): Es el ID del objeto de la tabla.
    • cellLocation (objeto, obligatorio): Ubicación de la celda de referencia: {"rowIndex": integer, "columnIndex": integer}.
    • insertRight (booleano, obligatorio): Indica si se deben insertar columnas nuevas a la derecha de la celda de referencia.
    • number (número entero, obligatorio): Es la cantidad de columnas que se insertarán (máximo 20).
  • deleteTableRow: Borra una fila de una tabla. Esquema:
    • tableObjectId (cadena, obligatorio): Es el ID del objeto de la tabla.
    • cellLocation (objeto, obligatorio): Ubicación de la celda de referencia: {"rowIndex": integer, "columnIndex": integer}. Borra la fila que contiene esta celda.
  • deleteTableColumn: Borra una columna de una tabla. Esquema:
    • tableObjectId (cadena, obligatorio): Es el ID del objeto de la tabla.
    • cellLocation (objeto, obligatorio): Ubicación de la celda de referencia: {"rowIndex": integer, "columnIndex": integer}. Borra la columna que contiene esta celda.
  • replaceAllText: Reemplaza todas las instancias del texto especificado. Esquema:
    • replaceText (cadena, obligatorio): Es el texto de reemplazo.
    • containsText (objeto, obligatorio): Criterios para la coincidencia de texto:
    • text (cadena, obligatorio): Es el texto que se buscará.
    • matchCase (booleano, opcional): Indica si la búsqueda distingue mayúsculas de minúsculas.
    • pageObjectIds (array de cadenas, opcional): Si se especifica, limita el reemplazo a los elementos de estas páginas.
  • deleteObject: Borra una página o un elemento de página de la presentación. Esquema:
    • objectId (cadena, obligatorio): Es el ID del objeto de la página o del elemento de página que se borrará.
  • updatePageElementTransform: Actualiza la transformación de un elemento de página. Esquema:
    • objectId (cadena, obligatorio): Es el ID del objeto del elemento de página que se actualizará.
    • transform (objeto, obligatorio): AffineTransform {"scaleX": number, "scaleY": number, "shearX": number, "shearY": number, "translateX": number, "translateY": number, "unit": string}.
    • applyMode (cadena, obligatorio): Modo de aplicación de la transformación: "RELATIVE" o "ABSOLUTE".
  • updateSlidesPosition: Actualiza la posición de un conjunto de diapositivas en la presentación. Esquema:
    • slideObjectIds (array de cadenas, obligatorio): IDs de los objetos de las diapositivas que se moverán.
    • insertionIndex (número entero, obligatorio): Es el índice basado en cero en el que se insertarán las diapositivas.
  • deleteText: Borra texto de una forma o de una celda de tabla. Esquema:
    • objectId (cadena, obligatorio): Es el ID del objeto de la forma o la tabla.
    • cellLocation (objeto, opcional): Celda de la tabla si se borra de la tabla: {"rowIndex": integer, "columnIndex": integer}.
    • textRange (objeto, opcional): {"startIndex": integer, "endIndex": integer, "type": string}. Si se omite, se borra todo el texto.
  • createImage: Crea una imagen. Esquema:
    • objectId (cadena, opcional): Es un ID de objeto proporcionado por el usuario. Si se omite, se genera un ID.
    • url (cadena, obligatorio): URL de la imagen que se recuperará y almacenará. Debe ser de acceso público.
    • elementProperties (objeto, obligatorio): Ubicación y tamaño del elemento:
    • pageObjectId (cadena, obligatorio): Es el ID del objeto de la página en la que se colocará la imagen.
    • size (objeto, opcional): {"width": {"magnitude": number, "unit": string}, "height": {"magnitude": number, "unit": string}}.
    • transform (objeto, opcional): AffineTransform {"scaleX": number, "scaleY": number, "shearX": number, "shearY": number, "translateX": number, "translateY": number, "unit": string}.
  • createVideo: Crea un video. Esquema:
    • objectId (cadena, opcional): Es un ID de objeto proporcionado por el usuario. Si se omite, se genera un ID.
    • source (cadena, obligatorio): Fuente del video: "YOUTUBE" o "DRIVE".
    • id (cadena, obligatorio): Es el ID del video (p.ej., el ID de video de YouTube).
    • elementProperties (objeto, obligatorio): Ubicación y tamaño del elemento:
    • pageObjectId (cadena, obligatorio): Es el ID del objeto de la página en la que se colocará el video.
    • size (objeto, opcional): {"width": {"magnitude": number, "unit": string}, "height": {"magnitude": number, "unit": string}}.
    • transform (objeto, opcional): AffineTransform {"scaleX": number, "scaleY": number, "shearX": number, "shearY": number, "translateX": number, "translateY": number, "unit": string}.
  • createSheetsChart: Crea un gráfico de Hojas de cálculo de Google incorporado. Esquema:
    • objectId (cadena, opcional): Es un ID de objeto proporcionado por el usuario. Si se omite, se genera un ID.
    • spreadsheetId (cadena, obligatorio): Es el ID de la hoja de cálculo de Hojas de cálculo de Google que contiene el gráfico.
    • chartId (número entero, obligatorio): Es el ID del gráfico específico en la hoja de cálculo.
    • linkingMode (cadena, obligatorio): Modo de vinculación: "LINKED" o "NOT_LINKED_IMAGE".
    • elementProperties (objeto, obligatorio): Ubicación y tamaño del elemento:
    • pageObjectId (cadena, obligatorio): Es el ID del objeto de la página en la que se colocará el gráfico.
    • size (objeto, opcional): {"width": {"magnitude": number, "unit": string}, "height": {"magnitude": number, "unit": string}}.
    • transform (objeto, opcional): AffineTransform {"scaleX": number, "scaleY": number, "shearX": number, "shearY": number, "translateX": number, "translateY": number, "unit": string}.
  • createLine: Crea una línea. Esquema:
    • objectId (cadena, opcional): Es un ID de objeto proporcionado por el usuario. Si se omite, se genera un ID.
    • elementProperties (objeto, obligatorio): Ubicación y tamaño del elemento:
    • pageObjectId (cadena, obligatorio): Es el ID del objeto de la página en la que se colocará la línea.
    • size (objeto, opcional): {"width": {"magnitude": number, "unit": string}, "height": {"magnitude": number, "unit": string}}.
    • transform (objeto, opcional): AffineTransform {"scaleX": number, "scaleY": number, "shearX": number, "shearY": number, "translateX": number, "translateY": number, "unit": string}.
    • category (cadena, obligatorio): Categoría de la línea: "STRAIGHT", "BENT" o "CURVED".
  • refreshSheetsChart: Actualiza un gráfico de Hojas de cálculo de Google. Esquema:
    • objectId (cadena, obligatorio): Es el ID del objeto del gráfico que se actualizará.
  • updateShapeProperties: Actualiza las propiedades de una forma. Esquema:
    • objectId (cadena, obligatorio): Es el ID del objeto de la forma que se actualizará.
    • shapeProperties (objeto, obligatorio): Propiedades de forma que se actualizarán:
    • shapeBackgroundFill (objeto, opcional): {"solidFill": {"color": {"rgbColor": {"red": number, "green": number, "blue": number}}}}.
    • outline (objeto, opcional): {"outlineFill": {"solidFill": ...}, "weight": {"magnitude": number, "unit": string}, "dashStyle": string}.
    • shadow (objeto, opcional): Propiedades de la sombra.
    • link (objeto, opcional): Destino del hipervínculo: {"url": string}.
    • fields (cadena, obligatorio): Es una lista de campos separados por comas que se deben actualizar (p.ej., "shapeBackgroundFill" o "*").
  • updateImageProperties: Actualiza las propiedades de una imagen. Esquema:
    • objectId (cadena, obligatorio): Es el ID del objeto de la imagen que se actualizará.
    • imageProperties (objeto, obligatorio): Propiedades de la imagen que se actualizarán:
    • cropProperties (objeto, opcional): Desplazamientos de recorte: {"leftOffset": number, "rightOffset": number, "topOffset": number, "bottomOffset": number, "angle": number}.
    • transparency (número, opcional): Nivel de transparencia (de 0.0 a 1.0).
    • brightness (número, opcional): Ajuste de brillo (de -1.0 a 1.0).
    • contrast (número, opcional): Ajuste de contraste (de -1.0 a 1.0).
    • recolor (objeto, opcional): Efecto de cambio de color.
    • shadow (objeto, opcional): Propiedades de la sombra.
    • outline (objeto, opcional): Propiedades del esquema.
    • link (objeto, opcional): Destino del hipervínculo: {"url": string}.
    • fields (cadena, obligatorio): Es una lista de campos separados por comas que se deben actualizar (p.ej., "transparency,brightness" o "*").
  • updateVideoProperties: Actualiza las propiedades de un video. Esquema:
    • objectId (cadena, obligatorio): Es el ID del objeto del video que se actualizará.
    • videoProperties (objeto, obligatorio): Propiedades del video que se actualizarán:
    • outline (objeto, opcional): Propiedades del esquema.
    • autoPlay (booleano, opcional): Indica si se debe reproducir el video automáticamente durante la presentación.
    • start (número entero, opcional): Hora de inicio en segundos.
    • end (número entero, opcional): Hora de finalización en segundos.
    • mute (booleano, opcional): Indica si el audio está silenciado.
    • fields (cadena, obligatorio): Es una lista de campos separados por comas que se deben actualizar (p.ej., "autoPlay,mute" o "*").
  • updatePageProperties: Actualiza las propiedades de una página. Esquema:
    • objectId (cadena, obligatorio): Es el ID del objeto de la página que se actualizará.
    • pageProperties (objeto, obligatorio): Propiedades de la página que se actualizarán:
    • pageBackgroundFill (objeto, opcional): {"solidFill": {"color": {"rgbColor": {"red": number, "green": number, "blue": number}}}} o {"stretchedPictureFill": {"contentUrl": string}}.
    • colorScheme (objeto, opcional): Es el esquema de colores del tema.
    • fields (cadena, obligatorio): Es una lista de campos separados por comas que se deben actualizar (p.ej., "pageBackgroundFill" o "*").
  • updateTableCellProperties: Actualiza las propiedades de un TableCell. Esquema:
    • objectId (cadena, obligatorio): Es el ID del objeto de la tabla.
    • tableRange (objeto, opcional): Es un subconjunto de celdas de la tabla que se actualizarán: {"location": {"rowIndex": integer, "columnIndex": integer}, "rowSpan": integer, "columnSpan": integer}. Si se omite, se aplica a todas las celdas.
    • tableCellProperties (objeto, obligatorio): Propiedades de la celda que se actualizarán:
    • tableCellBackgroundFill (objeto, opcional): {"solidFill": {"color": {"rgbColor": {"red": number, "green": number, "blue": number}}}}.
    • contentAlignment (cadena, opcional): Es la alineación vertical: "TOP", "MIDDLE", "BOTTOM".
    • fields (cadena, obligatorio): Es una lista de campos separados por comas que se deben actualizar (p.ej., "tableCellBackgroundFill" o "*").
  • updateLineProperties: Actualiza las propiedades de una línea. Esquema:
    • objectId (cadena, obligatorio): Es el ID del objeto de la línea que se actualizará.
    • lineProperties (objeto, obligatorio): Propiedades de la línea que se actualizarán:
    • lineFill (objeto, opcional): {"solidFill": {"color": {"rgbColor": {"red": number, "green": number, "blue": number}}}}.
    • weight (objeto, opcional): Grosor de la línea: {"magnitude": number, "unit": string}.
    • dashStyle (cadena, opcional): Estilo de guion: "SOLID", "DOT", "DASH", "DASH_DOT", "LONG_DASH", "LONG_DASH_DOT".
    • startArrow (cadena, opcional): Estilo de flecha de inicio: "NONE", "STEALTH_ARROW", "FILL_ARROW", "FILL_CIRCLE", "FILL_SQUARE", "FILL_DIAMOND", "OPEN_ARROW", "OPEN_CIRCLE", "OPEN_SQUARE", "OPEN_DIAMOND".
    • endArrow (cadena, opcional): Es el estilo de la flecha final (las mismas opciones que startArrow).
    • link (objeto, opcional): Destino del hipervínculo: {"url": string}.
    • fields (cadena, obligatorio): Es una lista de campos separados por comas que se deben actualizar (p.ej., "lineFill,weight" o "*").
  • createParagraphBullets: Crea viñetas para los párrafos. Esquema:
    • objectId (cadena, obligatorio): Es el ID del objeto de la forma o la tabla.
    • cellLocation (objeto, opcional): Celda de la tabla si el texto está en una tabla: {"rowIndex": integer, "columnIndex": integer}.
    • textRange (objeto, opcional): Es el rango de texto para agregar viñetas: {"startIndex": integer, "endIndex": integer, "type": string}.
    • bulletPreset (cadena, opcional): Es un parámetro predeterminado de estilo de viñeta (p.ej., "BULLET_DISC_CIRCLE_SQUARE", "BULLET_DIAMONDX_ARROW3D_SQUARE", "NUMBERED_DIGIT_ALPHA_ROMAN", "NUMBERED_DIGIT_NESTED"). El valor predeterminado es "BULLET_DISC_CIRCLE_SQUARE".
  • replaceAllShapesWithImage: Reemplaza todas las formas que coinciden con algunos criterios por una imagen. Esquema:
    • imageUrl (cadena, obligatorio): Es la URL de la imagen que se recuperará y se insertará.
    • imageReplaceMethod (cadena, opcional): Método de reemplazo: "CENTER_INSIDE" (predeterminado) o "CENTER_CROP".
    • containsText (objeto, obligatorio): Las formas de los criterios deben coincidir:
    • text (cadena, obligatorio): Es el texto que se buscará en las formas.
    • matchCase (booleano, opcional): Indica si la búsqueda distingue mayúsculas de minúsculas.
    • pageObjectIds (array de cadenas, opcional): Si se especifica, limita el reemplazo a los elementos de estas páginas.
  • duplicateObject: Duplica una diapositiva o un elemento de página. Esquema:
    • objectId (cadena, obligatorio): Es el ID del objeto de la diapositiva o el elemento que se duplicará.
    • objectIds (objeto, opcional): Es la asignación de ID para los elementos duplicados: {"originalObjectId": "newObjectId"}. Si se omite, se asignarán IDs aleatorios.
  • updateTextStyle: Actualiza el diseño del texto dentro de una forma o tabla. Esquema:
    • objectId (cadena, obligatorio): Es el ID del objeto de la forma o la tabla.
    • cellLocation (objeto, opcional): Celda de la tabla si el texto está en una tabla: {"rowIndex": integer, "columnIndex": integer}.
    • style (objeto, obligatorio): Propiedades de diseño del texto:
    • bold (booleano, opcional): Indica si el texto está en negrita.
    • italic (booleano, opcional): Indica si el texto está en cursiva.
    • fontFamily (cadena, opcional): Es la familia de fuentes (p.ej., "Arial", "Roboto").
    • fontSize (objeto, opcional): Tamaño de la fuente: {"magnitude": number, "unit": string}.
    • foregroundColor (objeto, opcional): Color de la fuente: {"opaqueColor": {"rgbColor": {"red": number, "green": number, "blue": number}}}.
    • backgroundColor (objeto, opcional): Color de fondo del texto: {"opaqueColor": ...}.
    • underline (booleano, opcional): Indica si el texto está subrayado.
    • strikethrough (booleano, opcional): Indica si el texto tiene un tachado.
    • smallCaps (booleano, opcional): Indica si el texto se renderiza en letras pequeñas capitalizadas.
    • baselineOffset (cadena, opcional): "NONE", "SUPERSCRIPT" o "SUBSCRIPT".
    • link (objeto, opcional): Destino del hipervínculo: {"url": string}.
    • textRange (objeto, opcional): Es el rango de texto al que se le aplicará el estilo: {"startIndex": integer, "endIndex": integer, "type": string}. Si se omite, se aplica a todo el texto.
    • fields (cadena, obligatorio): Es una lista de campos separados por comas que se deben actualizar (p.ej., "bold,foregroundColor" o "*").
  • replaceAllShapesWithSheetsChart: Reemplaza todas las formas que coinciden con algunos criterios por un gráfico de Hojas de cálculo de Google. Esquema:
    • spreadsheetId (cadena, obligatorio): Es el ID de la hoja de cálculo de Hojas de cálculo de Google que contiene el gráfico.
    • chartId (número entero, obligatorio): Es el ID del gráfico específico en la hoja de cálculo.
    • linkingMode (cadena, obligatorio): Modo de vinculación: "LINKED" o "NOT_LINKED_IMAGE".
    • containsText (objeto, obligatorio): Las formas de los criterios deben coincidir:
    • text (cadena, obligatorio): Es el texto que se buscará en las formas.
    • matchCase (booleano, opcional): Indica si la búsqueda distingue mayúsculas de minúsculas.
    • pageObjectIds (array de cadenas, opcional): Si se especifica, limita el reemplazo a los elementos de estas páginas.
  • deleteParagraphBullets: Borra las viñetas de los párrafos. Esquema:
    • objectId (cadena, obligatorio): Es el ID del objeto de la forma o la tabla que contiene texto.
    • cellLocation (objeto, opcional): Celda de la tabla si el texto está en una tabla: {"rowIndex": integer, "columnIndex": integer}.
    • textRange (objeto, opcional): Es el rango de texto del que se borrarán las viñetas: {"startIndex": integer, "endIndex": integer, "type": string}.
  • updateParagraphStyle: Actualiza el diseño de los párrafos dentro de una forma o tabla. Esquema:
    • objectId (cadena, obligatorio): Es el ID del objeto de la forma o la tabla.
    • cellLocation (objeto, opcional): Celda de la tabla si el texto está en una tabla: {"rowIndex": integer, "columnIndex": integer}.
    • style (objeto, obligatorio): Propiedades de estilo de párrafo:
    • alignment (cadena, opcional): Es la alineación del texto: "START", "CENTER", "END", "JUSTIFIED".
    • lineSpacing (número, opcional): Porcentaje de interlineado (p.ej., 100 para 100%).
    • spaceAbove (objeto, opcional): Espacio sobre el párrafo: {"magnitude": number, "unit": string}.
    • spaceBelow (objeto, opcional): Espacio debajo del párrafo: {"magnitude": number, "unit": string}.
    • indentFirstLine (objeto, opcional): Sangría de la primera línea: {"magnitude": number, "unit": string}.
    • indentStart (objeto, opcional): Sangría al inicio: {"magnitude": number, "unit": string}.
    • indentEnd (objeto, opcional): Indent at end: {"magnitude": number, "unit": string}.
    • direction (cadena, opcional): Dirección del texto: "LEFT_TO_RIGHT" o "RIGHT_TO_LEFT".
    • spacingMode (cadena, opcional): Modo de espaciado: "NEVER_COLLAPSE" o "COLLAPSE_LISTS".
    • textRange (objeto, opcional): Es el rango de texto al que se le aplicará el estilo: {"startIndex": integer, "endIndex": integer, "type": string}. Si se omite, se aplica a todo el texto.
    • fields (cadena, obligatorio): Es una lista de campos separados por comas que se deben actualizar (p.ej., "alignment,lineSpacing" o "*").
  • updateTableBorderProperties: Actualiza las propiedades de los bordes de la tabla en una tabla. Esquema:
    • objectId (cadena, obligatorio): Es el ID del objeto de la tabla.
    • tableRange (objeto, opcional): Es un subconjunto de los bordes de la tabla que se actualizarán: {"location": {"rowIndex": integer, "columnIndex": integer}, "rowSpan": integer, "columnSpan": integer}. Si se omite, se aplica a toda la tabla.
    • borderPosition (cadena, obligatorio): Posición del borde: "ALL", "BOTTOM", "INNER", "INNER_HORIZONTAL", "INNER_VERTICAL", "LEFT", "OUTER", "RIGHT", "TOP".
    • tableBorderProperties (objeto, obligatorio): Propiedades de borde que se actualizarán:
    • tableBorderFill (objeto, opcional): {"solidFill": {"color": {"rgbColor": {"red": number, "green": number, "blue": number}}}}.
    • weight (objeto, opcional): Grosor del borde: {"magnitude": number, "unit": string}.
    • dashStyle (cadena, opcional): Es el estilo de guion: "SOLID", "DOT", "DASH".
    • fields (cadena, obligatorio): Es una lista de campos separados por comas que se deben actualizar (p.ej., "tableBorderFill,weight" o "*").
  • updateTableColumnProperties: Actualiza las propiedades de una columna de tabla. Esquema:
    • objectId (cadena, obligatorio): Es el ID del objeto de la tabla.
    • columnIndices (array de números enteros, obligatorio): Índices basados en cero de las columnas que se actualizarán.
    • tableColumnProperties (objeto, obligatorio): Propiedades de la columna:
    • columnWidth (objeto, opcional): Ancho de la columna: {"magnitude": number, "unit": string}.
    • fields (cadena, obligatorio): Es una lista de campos separados por comas que se deben actualizar (p.ej., "columnWidth" o "*").
  • updateTableRowProperties: Actualiza las propiedades de una fila de la tabla. Esquema:
    • objectId (cadena, obligatorio): Es el ID del objeto de la tabla.
    • rowIndices (array de números enteros, obligatorio): Índices basados en cero de las filas que se actualizarán.
    • tableRowProperties (objeto, obligatorio): Propiedades de la fila:
    • minRowHeight (objeto, opcional): Altura mínima de la fila: {"magnitude": number, "unit": string}.
    • fields (cadena, obligatorio): Es una lista de campos separados por comas que se deben actualizar (p.ej., "minRowHeight" o "*").
  • mergeTableCells: Combina celdas en una tabla. Esquema:
    • objectId (cadena, obligatorio): Es el ID del objeto de la tabla.
    • tableRange (objeto, obligatorio): Es el rango de celdas que se combinarán: {"location": {"rowIndex": integer, "columnIndex": integer}, "rowSpan": integer, "columnSpan": integer}.
  • unmergeTableCells: Separa las celdas de una tabla. Esquema:
    • objectId (cadena, obligatorio): Es el ID del objeto de la tabla.
    • tableRange (objeto, obligatorio): Es el rango de celdas que se separarán: {"location": {"rowIndex": integer, "columnIndex": integer}, "rowSpan": integer, "columnSpan": integer}.
  • groupObjects: Agrupa objetos, como elementos de la página. Esquema:
    • groupObjectId (cadena, opcional): Es un ID de objeto proporcionado por el usuario para el grupo. Si se omite, se genera un ID.
    • childrenObjectIds (array de cadenas, obligatorio): IDs de objeto de los elementos que se agruparán (se requieren al menos 2, en la misma página y que no estén agrupados).
  • ungroupObjects: Desagrupa objetos, como grupos. Esquema:
    • objectIds (array de cadenas, obligatorio): IDs de los objetos de los grupos que se desagruparán.
  • updatePageElementAltText: Actualiza el título y/o la descripción del texto alternativo de un elemento de página. Esquema:
    • objectId (cadena, obligatorio): Es el ID del elemento de página.
    • title (cadena, opcional): Es el título del texto alternativo actualizado.
    • description (cadena, opcional): Es la descripción actualizada del texto alternativo.
  • replaceImage: Reemplaza una imagen existente por una nueva. Esquema:
    • imageObjectId (cadena, obligatorio): Es el ID del objeto de la imagen existente que se reemplazará.
    • url (cadena, obligatorio): Es la URL de la imagen nueva.
    • imageReplaceMethod (cadena, opcional): Método de reemplazo: "CENTER_INSIDE" (predeterminado) o "CENTER_CROP".
  • updateSlideProperties: Actualiza las propiedades de una diapositiva. Esquema:
    • objectId (cadena, obligatorio): Es el ID del objeto de la diapositiva que se actualizará.
    • slideProperties (objeto, obligatorio): Propiedades de la diapositiva:
    • isSkipped (booleano, opcional): Indica si se omite la diapositiva en el modo de presentación.
    • fields (cadena, obligatorio): Es una lista de campos separados por comas que se deben actualizar (p.ej., "isSkipped" o "*").
  • updatePageElementsZOrder: Actualiza el orden Z de los elementos de la página. Esquema:
    • pageElementObjectIds (array de cadenas, obligatorio): IDs de objetos de los elementos de la página que se actualizarán (deben estar en la misma página, no agrupados).
    • operation (cadena, obligatorio): Operación de orden Z: "BRING_TO_FRONT", "BRING_FORWARD", "SEND_BACKWARD", "SEND_TO_BACK".
  • importSlides: Importa una o más páginas de diapositivas especificadas desde una presentación de origen a esta presentación (de destino). Esquema:
    • sourcePresentationId (cadena, obligatorio): Es el ID de la presentación fuente.
    • importIndex (número entero, opcional): Índice basado en cero en el que se importarán las diapositivas. Si se omite, se importa al final.
    • sourceSlides (array de objetos, opcional): Asignaciones de IDs de diapositivas: [{"sourceSlideObjectId": string, "destinationObjectIds": {"sourceObjectId": "destinationObjectId"}}]. Si se omite, se importarán todas las diapositivas.
    • preserveTheme (cadena, opcional): Política de conservación del tema: "USE_SOURCE_THEME" o "USE_DESTINATION_THEME".
  • updateLineCategory: Actualiza la categoría de una línea. Esquema:
    • objectId (cadena, obligatorio): Es el ID del objeto de la línea del conector que se actualizará.
    • lineCategory (cadena, obligatorio): Categoría de la línea: "STRAIGHT", "BENT" o "CURVED".
  • rerouteLine: Vuelve a trazar una línea de modo que se conecte en los dos sitios de conexión más cercanos de los elementos de la página conectada. Esquema:
    • objectId (cadena, obligatorio): Es el ID del objeto de la línea del conector que se redireccionará.
  • createAudio: Crea un audio en esta presentación. Esquema:
    • objectId (cadena, opcional): Es un ID de objeto proporcionado por el usuario. Si se omite, se genera un ID.
    • source (cadena, obligatorio): Fuente de audio: "DRIVE".
    • sourceAudioId (cadena, obligatorio): Es el ID del archivo de audio en Google Drive.
    • elementProperties (objeto, obligatorio): Ubicación y tamaño del elemento:
    • pageObjectId (cadena, obligatorio): Es el ID del objeto de la página en la que se colocará el audio.
    • size (objeto, opcional): {"width": {"magnitude": number, "unit": string}, "height": {"magnitude": number, "unit": string}}.
    • transform (objeto, opcional): AffineTransform {"scaleX": number, "scaleY": number, "shearX": number, "shearY": number, "translateX": number, "translateY": number, "unit": string}.
  • updateAudioProperties: Actualiza las propiedades de un objeto Audio. Esquema:
    • objectId (cadena, obligatorio): Es el ID del objeto de audio que se actualizará.
    • audioProperties (objeto, obligatorio): Propiedades de audio:
    • playbackVolume (número entero, opcional): Volumen de reproducción de 0 a 100.
    • repeat (booleano, opcional): Indica si se debe repetir la reproducción de forma indefinida durante la presentación.
    • showWhenPresenting (booleano, opcional): Indica si el clip de audio se debe mostrar de forma visible durante la presentación.
    • playAcrossSlides (booleano, opcional): Indica si el audio continúa reproduciéndose en las diapositivas.
    • fields (cadena, obligatorio): Es una lista de campos separados por comas que se deben actualizar (p.ej., "playbackVolume,repeat" o "*").
  • insertComment: Inserta un comentario en la presentación. Esquema:
    • content (cadena, obligatorio): Contenido del comentario de texto sin formato.
    • Anclaje (se requiere exactamente uno):
    • shapeTextAnchor (objeto): Para anclar a texto dentro de una forma:
      • shapeId (cadena, obligatorio): Es el ID del objeto de la forma.
      • textRange (objeto, opcional): {"startIndex": int, "endIndex": int}.
    • objectId (cadena): Para anclar a una página o un elemento.
  • addCommentReply: Agrega una respuesta a un comentario existente. Esquema:
    • commentId (cadena, obligatorio): ID del debate.
    • post (objeto, obligatorio): {"content": "reply text"}.
  • updateCommentPost: Actualiza el contenido de una publicación de comentario en un hilo de comentarios. Esquema:
    • commentId (cadena, obligatorio): ID del debate.
    • postId (cadena, obligatorio): Es el ID de la publicación de comentario que se actualizará.
    • content (cadena, obligatorio): Es el contenido actualizado de la publicación de comentario.
  • deleteComment: Borra un hilo de comentarios. Esquema:
    • commentId (cadena, obligatorio): Es el ID del subproceso de comentarios que se borrará.
  • deleteCommentReply: Borra una publicación de respuesta. Esquema:
    • commentId (cadena, obligatorio): ID del debate.
    • postId (cadena, obligatorio): Es el ID de la publicación de respuesta que se borrará.

En la siguiente muestra de código, se muestra cómo usar curl para llamar a la herramienta de MCP update_presentation.

Solicitud de cURL 
curl --location 'https://slidesmcp.googleapis.com/mcp/v1' \
--header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
--header 'content-type: application/json' \
--header 'accept: application/json, text/event-stream' \
--data '{
  "method": "tools/call",
  "params": {
    "name": "update_presentation",
    "arguments": {
      // Provide these details according to the MCP tool specification.
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

Esquema de entrada

Es una solicitud para actualizar una presentación.

UpdatePresentationRequest

Representación JSON 
{
  "presentationId": string,
  "requests": [
    {
      object
    }
  ],
  "writeControl": {
    object (WriteControl)
  }
}
Campos
presentationId

string

Obligatorio. Es el ID de la presentación que se actualizará.
requests[]

object (Struct format)

Obligatorio. Es una lista de solicitudes de batchUpdate, que usa el esquema y la semántica documentados en https://developers.google.com/workspace/slides/api/reference/rest/v1/presentations/request.
writeControl

object (WriteControl)

Opcional. Proporciona control sobre cómo se ejecutan las solicitudes de escritura.

Struct

Representación JSON 
{
  "fields": {
    string: value,
    ...
  }
}
Campos
fields

map (key: string, value: value (Value format))

Es un mapa no ordenado de valores escritos de forma dinámica.

Un objeto que contiene una lista de pares "key": value. Ejemplo: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

FieldsEntry

Representación JSON 
{
  "key": string,
  "value": value
}
Campos
key

string
value

value (Value format)

Valor

Representación JSON 
{

  "nullValue": null,
  "numberValue": number,
  "stringValue": string,
  "boolValue": boolean,
  "structValue": {
    object
  },
  "listValue": array
}
Campos
Campo de unión kind. Es el tipo de valor. kind puede ser solo uno de los parámetros siguientes:
nullValue

null

Representa un null de JSON.
numberValue

number

Representa un número JSON. No debe ser NaN, Infinity ni -Infinity, ya que no se admiten en JSON. Tampoco puede representar valores Int64 grandes, ya que el formato JSON generalmente no los admite en su tipo de número.
stringValue

string

Representa una cadena JSON.
boolValue

boolean

Representa un valor booleano de JSON (literal true o false en JSON).
structValue

object (Struct format)

Representa un objeto JSON.
listValue

array (ListValue format)

Representa un array JSON.

ListValue

Representación JSON 
{
  "values": [
    value
  ]
}
Campos
values[]

value (Value format)

Es un campo repetido de valores escritos de forma dinámica.

WriteControl

Representación JSON 
{
  "requiredRevisionId": string
}
Campos
requiredRevisionId

string

Es el ID de revisión de la presentación que se requiere para la solicitud de escritura. Si se especifica y el ID de revisión requerido no coincide con el ID de revisión actual de la presentación, no se procesa la solicitud y se devuelve un error 400 de solicitud incorrecta.

NullValue

Representa un null de JSON.

NullValue es un centinela que usa un enum con solo un valor para representar el valor nulo de la unión de tipos Value.

Un campo de tipo NullValue con cualquier valor que no sea 0 se considera no válido. La mayoría de los serializadores de ProtoJSON emitirán un Value con un null_value establecido como un null de JSON, independientemente del valor entero, y, por lo tanto, se realizará un viaje de ida y vuelta a un valor de 0.

Enums
NULL_VALUE Valor nulo.

Esquema de salida

Son las respuestas de UpdatePresentation.

UpdatePresentationResponse

Representación JSON 
{
  "replies": [
    {
      object
    }
  ]
}
Campos
replies[]

object (Struct format)

Es un conjunto de respuestas de batchUpdate que usan el esquema y la semántica documentados en https://developers.google.com/workspace/slides/api/reference/rest/v1/presentations/response.

Struct

Representación JSON 
{
  "fields": {
    string: value,
    ...
  }
}
Campos
fields

map (key: string, value: value (Value format))

Es un mapa no ordenado de valores escritos de forma dinámica.

Un objeto que contiene una lista de pares "key": value. Ejemplo: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

FieldsEntry

Representación JSON 
{
  "key": string,
  "value": value
}
Campos
key

string
value

value (Value format)

Valor

Representación JSON 
{

  "nullValue": null,
  "numberValue": number,
  "stringValue": string,
  "boolValue": boolean,
  "structValue": {
    object
  },
  "listValue": array
}
Campos
Campo de unión kind. Es el tipo de valor. kind puede ser solo uno de los parámetros siguientes:
nullValue

null

Representa un null de JSON.
numberValue

number

Representa un número JSON. No debe ser NaN, Infinity ni -Infinity, ya que no se admiten en JSON. Tampoco puede representar valores Int64 grandes, ya que el formato JSON generalmente no los admite en su tipo de número.
stringValue

string

Representa una cadena JSON.
boolValue

boolean

Representa un valor booleano de JSON (literal true o false en JSON).
structValue

object (Struct format)

Representa un objeto JSON.
listValue

array (ListValue format)

Representa un array JSON.

ListValue

Representación JSON 
{
  "values": [
    value
  ]
}
Campos
values[]

value (Value format)

Es un campo repetido de valores escritos de forma dinámica.

NullValue

Representa un null de JSON.

NullValue es un centinela que usa un enum con solo un valor para representar el valor nulo de la unión de tipos Value.

Un campo de tipo NullValue con cualquier valor que no sea 0 se considera no válido. La mayoría de los serializadores de ProtoJSON emitirán un Value con un null_value establecido como un null de JSON, independientemente del valor entero, y, por lo tanto, se realizará un viaje de ida y vuelta a un valor de 0.

Enums
NULL_VALUE Valor nulo.

Anotaciones de herramientas

Las anotaciones de herramientas se envían a los clientes de MCP para describir el riesgo básico de una herramienta determinada. La mayoría de los clientes tratan estas sugerencias como no confiables, pero se pueden usar para decidir cuándo se le puede enviar un mensaje de confirmación a un usuario.

Junto con la cadena de título, se definen las siguientes sugerencias booleanas:

  • readOnlyHint: Si es verdadero, la herramienta no modifica su entorno. Valor predeterminado: false.
  • destructiveHint: Si es verdadero, la herramienta puede realizar acciones destructivas. Si es falso, la herramienta solo puede realizar acciones aditivas. Valor predeterminado: true.
  • idempotentHint: Si es verdadero, llamar a la herramienta varias veces con los mismos argumentos no tendrá ningún efecto adicional en su entorno. Valor predeterminado: false.
  • openWorldHint: Si es verdadero, la herramienta puede interactuar con un "mundo abierto" de entidades externas. Si es falso, la herramienta solo puede interactuar con entidades internas. Por ejemplo, una herramienta de búsqueda web sería de mundo abierto, mientras que una herramienta de memoria no lo sería.

Sugerencia destructiva: ✅ | Sugerencia idempotente: ❌ | Sugerencia de solo lectura: ❌ | Sugerencia de mundo abierto: ✅

Alcances de la autorización

Se necesita uno de los siguientes alcances de OAuth:

  • https://www.googleapis.com/auth/drive
  • https://www.googleapis.com/auth/drive.file
  • https://www.googleapis.com/auth/presentations