MCP Tools Reference: slidesmcp.googleapis.com

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

string

Obrigatório. O ID da apresentação a ser atualizada.

requests[]

object (Struct format)

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

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

Mapa não ordenado de valores com tipagem dinâmica.

Um objeto com uma lista de pares "key": value. Exemplo: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

FieldsEntry

Representação JSON
{
  "key": string,
  "value": value
}
Campos
key

string

value

value (Value format)

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

null

Representa um null JSON.

numberValue

number

Representa um número JSON. Não pode ser NaN, Infinity ou -Infinity, porque esses valores não são compatíveis com JSON. Isso também não pode representar valores Int64 grandes, já que o formato JSON geralmente não os aceita no tipo de número.

stringValue

string

Representa uma string JSON.

boolValue

boolean

Representa um booleano JSON (literal true ou false em JSON).

structValue

object (Struct format)

Representa um objeto JSON.

listValue

array (ListValue format)

Representa uma matriz JSON.

ListValue

Representação JSON
{
  "values": [
    value
  ]
}
Campos
values[]

value (Value format)

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[]

object (Struct format)

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

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

Mapa não ordenado de valores com tipagem dinâmica.

Um objeto com uma lista de pares "key": value. Exemplo: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

FieldsEntry

Representação JSON
{
  "key": string,
  "value": value
}
Campos
key

string

value

value (Value format)

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

null

Representa um null JSON.

numberValue

number

Representa um número JSON. Não pode ser NaN, Infinity ou -Infinity, porque esses valores não são compatíveis com JSON. Isso também não pode representar valores Int64 grandes, já que o formato JSON geralmente não os aceita no tipo de número.

stringValue

string

Representa uma string JSON.

boolValue

boolean

Representa um booleano JSON (literal true ou false em JSON).

structValue

object (Struct format)

Representa um objeto JSON.

listValue

array (ListValue format)

Representa uma matriz JSON.

ListValue

Representação JSON
{
  "values": [
    value
  ]
}
Campos
values[]

value (Value format)

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/drive
  • https://www.googleapis.com/auth/drive.file
  • https://www.googleapis.com/auth/presentations