MCP Tools Reference: sheetsmcp.googleapis.com

الأداة: update_values

تضبط هذه الطريقة القيم في نطاق من جدول بيانات. يتوافق مع spreadsheets.values.update في واجهة REST API: https://developers.google.com/workspace/sheets/api/reference/rest/v4/spreadsheets.values/update

يوضّح المثال التالي كيفية استخدام curl لاستدعاء أداة update_values MCP.

طلب Curl 
curl --location 'https://sheetsmcp.googleapis.com/mcp' \
--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 tool MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

مخطط الإدخال

UpdateValuesRequest

تمثيل JSON 
{
  "spreadsheetId": string,
  "range": string,
  "values": [
    array
  ]
}
الحقول
spreadsheetId

string

الحقل مطلوب. معرّف جدول البيانات المطلوب تعديله
range

string

الحقل مطلوب. ترميز A1 للقيم المطلوب تعديلها.
values[]

array (ListValue format)

الحقل مطلوب. البيانات التي تمت قراءتها أو التي سيتم كتابتها هذا هو صفيف من الصفائف، ويمثّل الصفيف الخارجي جميع البيانات ويمثّل كل صفيف داخلي صفًا. يتطابق كل عنصر في المصفوفة الداخلية مع خلية واحدة. أنواع القيم المتوافقة هي: bool وstring وdouble. سيتم تخطّي القيم الخالية. لضبط قيمة خلية على قيمة فارغة، اضبط قيمة السلسلة على سلسلة فارغة.

ListValue

تمثيل JSON 
{
  "values": [
    value
  ]
}
الحقول
values[]

value (Value format)

حقل متكرّر للقيم ذات الأنواع الديناميكية

القيمة

تمثيل JSON 
{

  "nullValue": null,
  "numberValue": number,
  "stringValue": string,
  "boolValue": boolean,
  "structValue": {
    object
  },
  "listValue": array
}
الحقول
حقل الربط kind نوع القيمة يمكن أن يكون التعليق kind إحدى القيم التالية فقط:
nullValue

null

يمثّل هذا النوع null بتنسيق JSON.
numberValue

number

تمثّل هذه السمة رقم JSON، ويجب ألا تكون NaN أو Infinity أو -Infinity لأنّ هذه القيم غير متاحة في JSON، كما لا يمكن أن تمثّل قيم Int64 كبيرة لأنّ تنسيق JSON لا يتيحها بشكل عام في نوع الأرقام.
stringValue

string

تمثّل سلسلة JSON.
boolValue

boolean

تمثّل قيمة منطقية بتنسيق JSON (القيمة الحرفية true أو false في JSON).
structValue

object (Struct format)

تمثّل هذه السمة عنصر JSON.
listValue

array (ListValue format)

تمثّل هذه السمة مصفوفة JSON.

بنية

تمثيل JSON 
{
  "fields": {
    string: value,
    ...
  }
}
الحقول
fields

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

خريطة غير مرتبة للقيم ذات الأنواع الديناميكية

كائن يحتوي على قائمة بأزواج "key": value، مثل: { "name": "wrench", "mass": "1.3kg", "count": "3" }

FieldsEntry

تمثيل JSON 
{
  "key": string,
  "value": value
}
الحقول
key

string
value

value (Value format)

NullValue

يمثّل هذا النوع null بتنسيق JSON.

‫NullValue هو عنصر فاصل، ويستخدم تعدادًا بقيمة واحدة فقط لتمثيل القيمة الفارغة لاتحاد النوع Value.

يُعدّ الحقل من النوع NullValue غير صالح إذا كانت قيمته أي قيمة أخرى غير 0. ستُصدر معظم أدوات التسلسل ProtoJSON Value مع ضبط null_value كـ null JSON بغض النظر عن قيمة العدد الصحيح، وبالتالي ستُجري رحلة ذهاب وعودة إلى قيمة 0.

عمليات التعداد
NULL_VALUE قيمة فارغة

مخطط الناتج

تمثّل هذه السمة عنصر JSON.

خريطة غير مرتبة للقيمة والمفتاح، تهدف إلى التقاط دلالات عنصر JSON بشكل مثالي. يتيح ذلك تحليل أي حمولة JSON عشوائية كحقل رسالة بتنسيق ProtoJSON.

يتّبع هذا النوع إرشادات RFC 8259 بشأن JSON القابل للتشغيل التفاعلي: لا يمكن لهذا النوع تمثيل قيم Int64 كبيرة أو أرقام NaN/Infinity، لأنّ تنسيق JSON لا يتيح بشكل عام هذه القيم في نوع الأرقام.

إذا كنت لا تنوي تحليل JSON عشوائي في رسالتك، يجب استخدام رسالة مكتوبة مخصّصة بدلاً من هذا النوع.

بنية

تمثيل JSON 
{
  "fields": {
    string: value,
    ...
  }
}
الحقول
fields

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

خريطة غير مرتبة للقيم ذات الأنواع الديناميكية

كائن يحتوي على قائمة بأزواج "key": value، مثل: { "name": "wrench", "mass": "1.3kg", "count": "3" }

FieldsEntry

تمثيل JSON 
{
  "key": string,
  "value": value
}
الحقول
key

string
value

value (Value format)

القيمة

تمثيل JSON 
{

  "nullValue": null,
  "numberValue": number,
  "stringValue": string,
  "boolValue": boolean,
  "structValue": {
    object
  },
  "listValue": array
}
الحقول
حقل الربط kind نوع القيمة يمكن أن يكون التعليق kind إحدى القيم التالية فقط:
nullValue

null

يمثّل هذا النوع null بتنسيق JSON.
numberValue

number

تمثّل هذه السمة رقم JSON، ويجب ألا تكون NaN أو Infinity أو -Infinity لأنّ هذه القيم غير متاحة في JSON، كما لا يمكن أن تمثّل قيم Int64 كبيرة لأنّ تنسيق JSON لا يتيحها بشكل عام في نوع الأرقام.
stringValue

string

تمثّل سلسلة JSON.
boolValue

boolean

تمثّل قيمة منطقية بتنسيق JSON (القيمة الحرفية true أو false في JSON).
structValue

object (Struct format)

تمثّل هذه السمة عنصر JSON.
listValue

array (ListValue format)

تمثّل هذه السمة مصفوفة JSON.

ListValue

تمثيل JSON 
{
  "values": [
    value
  ]
}
الحقول
values[]

value (Value format)

حقل متكرّر للقيم ذات الأنواع الديناميكية

NullValue

يمثّل هذا النوع null بتنسيق JSON.

‫NullValue هو عنصر فاصل، ويستخدم تعدادًا بقيمة واحدة فقط لتمثيل القيمة الفارغة لاتحاد النوع Value.

يُعدّ الحقل من النوع NullValue غير صالح إذا كانت قيمته أي قيمة أخرى غير 0. ستُصدر معظم أدوات التسلسل ProtoJSON Value مع ضبط null_value كـ null JSON بغض النظر عن قيمة العدد الصحيح، وبالتالي ستُجري رحلة ذهاب وعودة إلى قيمة 0.

عمليات التعداد
NULL_VALUE قيمة فارغة

التعليقات التوضيحية للأدوات

Destructive Hint: ❌ | Idempotent Hint: ❌ | Read Only Hint: ❌ | Open World Hint: ✅