Ferramenta: update_presentation
Atualiza uma apresentação com um conjunto de solicitações batchUpdate.
Corresponde a presentations.batchUpdate na API REST.
A lista de possíveis atualizações é:
createSlide: cria um novo slide.createShape: cria uma nova forma.createTable: cria uma nova tabela.insertText: insere texto em uma forma ou célula de tabela.insertTableRows: insere linhas em uma tabela.insertTableColumns: insere colunas em uma tabela.deleteTableRow: exclui uma linha de uma tabela.deleteTableColumn: exclui uma coluna de uma tabela.replaceAllText: substitui todas as instâncias do texto especificado.deleteObject: exclui uma página ou um elemento de página da apresentação.updatePageElementTransform: atualiza a transformação de um elemento da página.updateSlidesPosition: atualiza a posição de um conjunto de slides na apresentação.deleteText: exclui texto de uma forma ou célula de tabela.createImage: cria uma imagem.createVideo: cria um vídeo.createSheetsChart: cria um gráfico incorporado das Planilhas Google.createLine: cria uma linha.refreshSheetsChart: atualiza um gráfico das Planilhas Google.updateShapeProperties: atualiza as propriedades de uma forma.updateImageProperties: atualiza as propriedades de uma imagem.updateVideoProperties: atualiza as propriedades de um vídeo.updatePageProperties: atualiza as propriedades de uma página.updateTableCellProperties: atualiza as propriedades de um TableCell.updateLineProperties: atualiza as propriedades de uma linha.createParagraphBullets: cria marcadores para parágrafos.replaceAllShapesWithImage: substitui todas as formas que correspondem a alguns critérios por uma imagem.duplicateObject: duplica um slide ou elemento de página.updateTextStyle: atualiza o estilo do texto em uma forma ou tabela.replaceAllShapesWithSheetsChart: substitui todas as formas que correspondem a alguns critérios por um gráfico das Planilhas Google.deleteParagraphBullets: exclui marcadores de parágrafos.updateParagraphStyle: atualiza o estilo dos parágrafos em uma forma ou tabela.updateTableBorderProperties: atualiza as propriedades das bordas de uma tabela.updateTableColumnProperties: atualiza as propriedades de uma coluna da tabela.updateTableRowProperties: atualiza as propriedades de uma linha da tabela.mergeTableCells: mescla células em uma tabela.unmergeTableCells: cancela a mesclagem de células em uma tabela.groupObjects: agrupa objetos, como elementos de página.ungroupObjects: desagrupa objetos, como grupos.updatePageElementAltText: atualiza o título e/ou a descrição do texto alternativo de um elemento da página.replaceImage: substitui uma imagem atual por uma nova.updateSlideProperties: atualiza as propriedades de um slide.updatePageElementsZOrder: atualiza a ordem Z dos elementos da página.importSlides: importa uma ou mais páginas de slides especificadas de uma apresentação de origem para esta apresentação (de destino).updateLineCategory: atualiza a categoria de uma linha.rerouteLine: redireciona uma linha para que ela seja conectada aos dois sites de conexão mais próximos nos elementos da página conectada.createAudio: cria um áudio nesta apresentação.updateAudioProperties: atualiza as propriedades de um áudio.
O exemplo a seguir demonstra como usar curl para invocar a ferramenta update_presentation MCP.
| Solicitação curl |
|---|
curl --location 'https://slidesmcp.googleapis.com/mcp' \ --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 tool MCP specification } }, "jsonrpc": "2.0", "id": 1 }' |
Esquema de entrada
Solicitação para atualizar uma apresentação.
UpdatePresentationRequest
| Representação JSON |
|---|
{ "presentationId": string, "requests": [ { object } ] } |
| Campos | |
|---|---|
presentationId |
Obrigatório. O ID da apresentação a ser atualizada. |
requests[] |
Obrigatório. Uma lista de solicitações "batchUpdate", usando o esquema e a semântica documentados em https://developers.google.com/workspace/slides/api/reference/rest/v1/presentations/request |
Struct
| Representação JSON |
|---|
{ "fields": { string: value, ... } } |
| Campos | |
|---|---|
fields |
Mapa não ordenado de valores com tipagem dinâmica. Um objeto com uma lista de pares |
FieldsEntry
| Representação JSON |
|---|
{ "key": string, "value": value } |
| Campos | |
|---|---|
key |
|
value |
|
Valor
| Representação JSON |
|---|
{ "nullValue": null, "numberValue": number, "stringValue": string, "boolValue": boolean, "structValue": { object }, "listValue": array } |
| Campos | |
|---|---|
Campo de união kind. O tipo de valor. kind pode ser apenas de um dos tipos a seguir: |
|
nullValue |
Representa um |
numberValue |
Representa um número JSON. Não pode ser |
stringValue |
Representa uma string JSON. |
boolValue |
Representa um booleano JSON (literal |
structValue |
Representa um objeto JSON. |
listValue |
Representa uma matriz JSON. |
ListValue
| Representação JSON |
|---|
{ "values": [ value ] } |
| Campos | |
|---|---|
values[] |
Campo repetido de valores digitados dinamicamente. |
NullValue
Representa um null JSON.
NullValue é um sentinela que usa uma enumeração com apenas um valor para representar o valor nulo da união de tipos Value.
Um campo do tipo NullValue com qualquer valor diferente de 0 é considerado inválido. A maioria dos serializadores ProtoJSON vai emitir um Value com um null_value definido como um null JSON, independente do valor inteiro, e, portanto, fará uma viagem de ida e volta para um valor 0.
| Tipos enumerados | |
|---|---|
NULL_VALUE |
Valor nulo. |
Esquema de saída
Respostas de UpdatePresentation.
UpdatePresentationResponse
| Representação JSON |
|---|
{ "replies": [ { object } ] } |
| Campos | |
|---|---|
replies[] |
Um conjunto de respostas "batchUpdate", usando o esquema e a semântica documentados em https://developers.google.com/workspace/slides/api/reference/rest/v1/presentations/response |
Struct
| Representação JSON |
|---|
{ "fields": { string: value, ... } } |
| Campos | |
|---|---|
fields |
Mapa não ordenado de valores com tipagem dinâmica. Um objeto com uma lista de pares |
FieldsEntry
| Representação JSON |
|---|
{ "key": string, "value": value } |
| Campos | |
|---|---|
key |
|
value |
|
Valor
| Representação JSON |
|---|
{ "nullValue": null, "numberValue": number, "stringValue": string, "boolValue": boolean, "structValue": { object }, "listValue": array } |
| Campos | |
|---|---|
Campo de união kind. O tipo de valor. kind pode ser apenas de um dos tipos a seguir: |
|
nullValue |
Representa um |
numberValue |
Representa um número JSON. Não pode ser |
stringValue |
Representa uma string JSON. |
boolValue |
Representa um booleano JSON (literal |
structValue |
Representa um objeto JSON. |
listValue |
Representa uma matriz JSON. |
ListValue
| Representação JSON |
|---|
{ "values": [ value ] } |
| Campos | |
|---|---|
values[] |
Campo repetido de valores digitados dinamicamente. |
NullValue
Representa um null JSON.
NullValue é um sentinela que usa uma enumeração com apenas um valor para representar o valor nulo da união de tipos Value.
Um campo do tipo NullValue com qualquer valor diferente de 0 é considerado inválido. A maioria dos serializadores ProtoJSON vai emitir um Value com um null_value definido como um null JSON, independente do valor inteiro, e, portanto, fará uma viagem de ida e volta para um valor 0.
| Tipos enumerados | |
|---|---|
NULL_VALUE |
Valor nulo. |
Anotações de ferramentas
Dica destrutiva: ✅ | Dica idempotente: ❌ | Dica somente leitura: ❌ | Dica de mundo aberto: ✅
Escopos de autorização
Requer um dos seguintes escopos do OAuth:
https://www.googleapis.com/auth/drivehttps://www.googleapis.com/auth/drive.filehttps://www.googleapis.com/auth/presentations