MCP Tools Reference: sheetsmcp.googleapis.com

الأداة: get_spreadsheet

تعرض هذه الأداة محتوى جدول البيانات المحدّد. وتعرض عناوين جدول البيانات وأسماء الأوراق وخصائص الشبكة والبيانات الوصفية الأخرى لمعرّف جدول البيانات المحدّد. تعرض أيضًا بيانات الشبكة الكاملة إذا طُلب ذلك. يتطابق هذا مع spreadsheets.get في واجهة REST API: https://developers.google.com/workspace/sheets/api/reference/rest/v4/spreadsheets/get

يوضّح المثال التالي كيفية استخدام curl لاستدعاء أداة get_spreadsheet في "مركز التحكّم في السياسات".

طلب 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_spreadsheet",
    "arguments": {
      // provide these details according to the tool MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

مخطط الإدخال

GetContentRequest

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

string

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

boolean

صحيح إذا كان يجب عرض بيانات الشبكة.

مخطط النتائج

يمثّل عنصر 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

يمثّل JSON null
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

يمثّل JSON null

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

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

عمليات التعداد
NULL_VALUE القيمة الخالية

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

تلميح بشأن الإجراءات المدمّرة: ❌ | تلميح بشأن الإجراءات غير المؤثرة: ✅ | تلميح بشأن الإجراءات للقراءة فقط: ✅ | تلميح بشأن الإجراءات في العالم المفتوح: ✅