MCP Tools Reference: slidesmcp.googleapis.com

Araç: update_presentation

Bir sunuyu bir dizi batchUpdate isteğiyle günceller.

REST API'de presentations.batchUpdate'ye karşılık gelir.

Olası güncellemelerin listesi:

  • createSlide: Yeni bir slayt oluşturur.
  • createShape: Yeni bir şekil oluşturur.
  • createTable: Yeni bir tablo oluşturur.
  • insertText: Şekle veya tablo hücresine metin ekler.
  • insertTableRows: Tabloya satır ekler.
  • insertTableColumns: Tabloya sütun ekler.
  • deleteTableRow: Tablodaki bir satırı siler.
  • deleteTableColumn: Tablodan sütun siler.
  • replaceAllText: Belirtilen metnin tüm örneklerini değiştirir.
  • deleteObject: Sunudan bir sayfayı veya sayfa öğesini siler.
  • updatePageElementTransform: Bir sayfa öğesinin dönüşümünü günceller.
  • updateSlidesPosition: Sunudaki bir dizi slaytın konumunu günceller.
  • deleteText: Şekil veya tablo hücresindeki metni siler.
  • createImage: Görüntü oluşturur.
  • createVideo: Video oluşturur.
  • createSheetsChart: Yerleştirilmiş bir Google E-Tablolar grafiği oluşturur.
  • createLine: Çizgi oluşturur.
  • refreshSheetsChart: Google E-Tablolar grafiğini yeniler.
  • updateShapeProperties: Şeklin özelliklerini günceller.
  • updateImageProperties: Bir resmin özelliklerini günceller.
  • updateVideoProperties: Bir videonun özelliklerini günceller.
  • updatePageProperties: Bir sayfanın özelliklerini günceller.
  • updateTableCellProperties: Bir TableCell'in özelliklerini günceller.
  • updateLineProperties: Bir çizginin özelliklerini günceller.
  • createParagraphBullets: Paragraflar için madde işaretleri oluşturur.
  • replaceAllShapesWithImage: Belirli ölçütlere uyan tüm şekilleri bir resimle değiştirir.
  • duplicateObject: Slaytı veya sayfa öğesini çoğaltır.
  • updateTextStyle: Şekil veya Tablo içindeki metnin stilini günceller.
  • replaceAllShapesWithSheetsChart: Belirli ölçütlere uyan tüm şekilleri Google E-Tablolar grafiğiyle değiştirir.
  • deleteParagraphBullets: Paragraflardaki madde işaretlerini siler.
  • updateParagraphStyle: Şekil veya tablodaki paragrafların stilini günceller.
  • updateTableBorderProperties: Tablodaki tablo kenarlıklarının özelliklerini günceller.
  • updateTableColumnProperties: Tablo sütununun özelliklerini günceller.
  • updateTableRowProperties: Tablo satırının özelliklerini günceller.
  • mergeTableCells: Tablodaki hücreleri birleştirir.
  • unmergeTableCells: Tablodaki hücreleri ayırır.
  • groupObjects: Sayfa öğeleri gibi nesneleri gruplandırır.
  • ungroupObjects: Gruplar gibi nesnelerin gruplarını çözer.
  • updatePageElementAltText: Bir sayfa öğesinin alternatif metin başlığını ve/veya açıklamasını günceller.
  • replaceImage: Mevcut bir resmi yeni bir resimle değiştirir.
  • updateSlideProperties: Bir slaytın özelliklerini günceller.
  • updatePageElementsZOrder: Sayfa öğelerinin Z düzenini günceller.
  • importSlides: Kaynak sunudaki belirtilen bir veya daha fazla slayt sayfasını bu (hedef) sunuya aktarır.
  • updateLineCategory: Bir satırın kategorisini günceller.
  • rerouteLine: Bir çizgiyi, bağlı sayfa öğelerindeki en yakın iki bağlantı sitesine bağlanacak şekilde yeniden yönlendirir.
  • createAudio: Bu sunuda ses oluşturur.
  • updateAudioProperties: Bir sesin özelliklerini günceller.

Aşağıdaki örnekte, update_presentation MCP aracını çağırmak için curl simgesinin nasıl kullanılacağı gösterilmektedir.

Curl İsteği
curl --location 'https://slidesmcp.googleapis.com/mcp' \
--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
}'
                

Giriş Şeması

Sununun güncellenmesini isteme

UpdatePresentationRequest

JSON gösterimi
{
  "presentationId": string,
  "requests": [
    {
      object
    }
  ]
}
Alanlar
presentationId

string

Zorunlu. Güncellenecek sununun kimliği.

requests[]

object (Struct format)

Zorunlu. https://developers.google.com/workspace/slides/api/reference/rest/v1/presentations/request adresinde belgelenen şema ve semantik kullanılarak oluşturulan batchUpdate isteklerinin listesi

Struct

JSON gösterimi
{
  "fields": {
    string: value,
    ...
  }
}
Alanlar
fields

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

Dinamik olarak türü belirlenmiş değerlerin sırasız haritası.

"key": value çiftlerinin listesini içeren bir nesne. Örnek: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

FieldsEntry

JSON gösterimi
{
  "key": string,
  "value": value
}
Alanlar
key

string

value

value (Value format)

Değer

JSON gösterimi
{

  "nullValue": null,
  "numberValue": number,
  "stringValue": string,
  "boolValue": boolean,
  "structValue": {
    object
  },
  "listValue": array
}
Alanlar
kind birleşik alanı. Değer türü. kind aşağıdakilerden yalnızca biri olabilir:
nullValue

null

JSON null değerini temsil eder.

numberValue

number

JSON sayısını temsil eder. JSON'da desteklenmediği için NaN, Infinity veya -Infinity olmamalıdır. JSON biçimi genellikle sayı türünde büyük Int64 değerlerini desteklemediğinden bu değerler de gösterilemez.

stringValue

string

Bir JSON dizesini temsil eder.

boolValue

boolean

JSON boole değerini (JSON'da true veya false değişmez değeri) temsil eder.

structValue

object (Struct format)

JSON nesnesini temsil eder.

listValue

array (ListValue format)

Bir JSON dizisini temsil eder.

ListValue

JSON gösterimi
{
  "values": [
    value
  ]
}
Alanlar
values[]

value (Value format)

Dinamik olarak türü belirlenen değerlerin tekrar eden alanı.

NullValue

JSON null değerini temsil eder.

NullValue, Value tür birliği için boş değeri temsil etmek üzere yalnızca bir değere sahip bir enum kullanan bir sentineldir.

0 dışında bir değere sahip NullValue türündeki bir alan geçersiz kabul edilir. Çoğu ProtoJSON serileştiricisi, tam sayı değerinden bağımsız olarak JSON null olarak ayarlanmış bir Value yayınlar ve bu nedenle 0 değerine gidiş dönüş yapar.null_value

Sıralamalar
NULL_VALUE Boş değer.

Çıkış Şeması

UpdatePresentation yanıtları.

UpdatePresentationResponse

JSON gösterimi
{
  "replies": [
    {
      object
    }
  ]
}
Alanlar
replies[]

object (Struct format)

https://developers.google.com/workspace/slides/api/reference/rest/v1/presentations/response adresinde belgelenen şema ve semantiği kullanan bir grup batchUpdate yanıtı

Struct

JSON gösterimi
{
  "fields": {
    string: value,
    ...
  }
}
Alanlar
fields

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

Dinamik olarak türü belirlenmiş değerlerin sırasız haritası.

"key": value çiftlerinin listesini içeren bir nesne. Örnek: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

FieldsEntry

JSON gösterimi
{
  "key": string,
  "value": value
}
Alanlar
key

string

value

value (Value format)

Değer

JSON gösterimi
{

  "nullValue": null,
  "numberValue": number,
  "stringValue": string,
  "boolValue": boolean,
  "structValue": {
    object
  },
  "listValue": array
}
Alanlar
kind birleşik alanı. Değer türü. kind aşağıdakilerden yalnızca biri olabilir:
nullValue

null

JSON null değerini temsil eder.

numberValue

number

JSON sayısını temsil eder. JSON'da desteklenmediği için NaN, Infinity veya -Infinity olmamalıdır. JSON biçimi genellikle sayı türünde büyük Int64 değerlerini desteklemediğinden bu değerler de gösterilemez.

stringValue

string

Bir JSON dizesini temsil eder.

boolValue

boolean

JSON boole değerini (JSON'da true veya false değişmez değeri) temsil eder.

structValue

object (Struct format)

JSON nesnesini temsil eder.

listValue

array (ListValue format)

Bir JSON dizisini temsil eder.

ListValue

JSON gösterimi
{
  "values": [
    value
  ]
}
Alanlar
values[]

value (Value format)

Dinamik olarak türü belirlenen değerlerin tekrar eden alanı.

NullValue

JSON null değerini temsil eder.

NullValue, Value tür birliği için boş değeri temsil etmek üzere yalnızca bir değere sahip bir enum kullanan bir sentineldir.

0 dışında bir değere sahip NullValue türündeki bir alan geçersiz kabul edilir. Çoğu ProtoJSON serileştiricisi, tam sayı değerinden bağımsız olarak JSON null olarak ayarlanmış bir Value yayınlar ve bu nedenle 0 değerine gidiş dönüş yapar.null_value

Sıralamalar
NULL_VALUE Boş değer.

Araç Ek Açıklamaları

Yıkıcı ipucu: ✅ | İdempotent ipucu: ❌ | Salt okunur ipucu: ❌ | Açık dünya ipucu: ✅