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 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
--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)

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

Value

تمثيل 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

بنية

تمثيل 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

يمثّل قيمة JSON null

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

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

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

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

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

نطاقات التفويض

يجب توفير أحد نطاقات OAuth التالية:

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