MCP Tools Reference: sheetsmcp.googleapis.com

Araç: update_values

E-tablonun bir aralığındaki değerleri ayarlar.

REST API'deki spreadsheets.values.update yöntemine karşılık gelir: https://developers.google.com/workspace/sheets/api/reference/rest/v4/spreadsheets.values/update

Şema: - spreadsheet_id (dize, zorunlu): Güncellenecek e-tablonun kimliği. - range (dize, zorunlu): Güncellenecek değerlerin A1 gösterimi (ör. "Sheet1!A1:B2"). - values (dizi dizisi, zorunlu): Hücre değerlerinin 2D dizisi. Desteklenen değer türleri şunlardır: boole, dize ve sayı (kayan/tam sayı).

Aşağıdaki kod örneğinde, update_values MCP aracını çağırmak için curl öğesinin nasıl kullanılacağı gösterilmektedir.

Curl İsteği 
curl --location 'https://sheetsmcp.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_values",
    "arguments": {
      // Provide these details according to the MCP tool specification.
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

Giriş şeması

UpdateValuesRequest

JSON gösterimi 
{
  "spreadsheetId": string,
  "range": string,
  "values": [
    array
  ]
}
Alanlar
spreadsheetId

string

Zorunlu. Güncellenecek e-tablonun kimliği.
range

string

Zorunlu. Güncellenecek değerlerin A1 gösterimi.
values[]

array (ListValue format)

Zorunlu. Okunan veya yazılacak veriler. Bu, dizilerden oluşan bir dizidir. Dış dizi tüm verileri, her iç dizi ise bir satırı temsil eder. İç dizideki her öğe bir hücreye karşılık gelir. Desteklenen değer türleri: bool, dize ve double. Boş değerler atlanır. Bir hücreyi boş bir değere ayarlamak için dize değerini boş bir dizeye ayarlayın.

ListValue

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

value (Value format)

Dinamik olarak yazılan değerlerin yinelenen alanı.

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 temsil edilemez.
stringValue

string

Bir JSON dizesini temsil eder.
boolValue

boolean

JSON boole değerini (JSON'da true veya false dizesi) temsil eder.
structValue

object (Struct format)

Bir JSON nesnesini temsil eder.
listValue

array (ListValue format)

Bir JSON dizisini temsil eder.

Struct

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

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

Dinamik olarak yazılan değerlerin sırasız eşlemesi.

"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)

NullValue

JSON null değerini temsil eder.

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

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

Sıralamalar
NULL_VALUE Boş değer.

Çıkış şeması

UpdateValuesResponse

JSON gösterimi 
{
  "content": {
    object
  }
}
Alanlar
content

object (Struct format)

Sheets API'nin JSON biçimindeki spreadsheets.values.update yanıtı ve bir status alanı.

Struct

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

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

Dinamik olarak yazılan değerlerin sırasız eşlemesi.

"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 temsil edilemez.
stringValue

string

Bir JSON dizesini temsil eder.
boolValue

boolean

JSON boole değerini (JSON'da true veya false dizesi) temsil eder.
structValue

object (Struct format)

Bir 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 yazılan değerlerin yinelenen alanı.

NullValue

JSON null değerini temsil eder.

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

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

Sıralamalar
NULL_VALUE Boş değer.

Araç Notları

Araç notları, belirli bir aracın temel riskini açıklamak için MCP istemcilerine gönderilir. Çoğu istemci bu ipuçlarını güvenilir olmayan olarak değerlendirir ancak kullanıcıya ne zaman onay istemi gönderileceğine karar vermek için kullanılabilir.

Başlık dizesiyle birlikte aşağıdaki boole ipuçları şu şekilde tanımlanır:

  • readOnlyHint: Doğru ise araç, ortamını değiştirmez. Varsayılan: false.
  • destructiveHint: Doğru ise araç, yıkıcı işlemler gerçekleştirebilir. Yanlış ise araç yalnızca ekleme işlemleri gerçekleştirebilir. Varsayılan: true.
  • idempotentHint: Doğru ise aracın aynı bağımsız değişkenlerle tekrar tekrar çağrılması, ortamı üzerinde ek bir etki yaratmaz. Varsayılan: false.
  • openWorldHint: Doğru ise araç, harici varlıkların "açık dünyası" ile etkileşime girebilir. Yanlış ise araç yalnızca dahili varlıklarla etkileşim kurabilir. Örneğin, web arama aracı açık dünya iken bellek aracı açık dünya değildir.

Yıkıcı İpucu: ❌ | Bağımsız İpucu: ❌ | Salt Okunur İpucu: ❌ | Açık Dünya İpucu: ✅

Yetkilendirme Kapsamları

Aşağıdaki OAuth kapsamlarından birini gerektirir:

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