MCP Tools Reference: sheetsmcp.googleapis.com

الأداة: get_values

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

يوضّح المثال التالي كيفية استخدام curl لاستدعاء أداة get_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": "get_values",
    "arguments": {
      // provide these details according to the tool MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

مخطط الإدخال

GetValuesRequest

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

string

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

string

الحقل مطلوب. تنسيق A1 أو تنسيق R1C1 للنطاق الذي سيتم استرداد القيم منه.

مخطط الناتج

البيانات ضمن نطاق جدول البيانات https://developers.google.com/workspace/sheets/api/reference/rest/v4/spreadsheets.values

ValueRange

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

string

النطاق الذي تغطيه القيم، بتنسيق A1
values[]

array (ListValue format)

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

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 قيمة فارغة

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

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