MCP Tools Reference: drivemcp.googleapis.com

الأداة: get_file_permissions

يمكنك استدعاء هذه الأداة لإدراج أذونات ملف Drive.

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

طلب Curl 
curl --location 'https://drivemcp.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": "get_file_permissions",
    "arguments": {
      // provide these details according to the tool's MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

مخطط الإدخال

طلب الحصول على أذونات الملفات

GetFilePermissionsRequest

تمثيل JSON 
{
  "fileId": string
}
الحقول
fileId

string

الحقل مطلوب. رقم تعريف الملف المطلوب الحصول على أذونات له

مخطط النتائج

استجابة للحصول على أذونات الملف

GetFilePermissionsResponse

تمثيل JSON 
{
  "permissions": [
    {
      object (Permission)
    }
  ]
}
الحقول
permissions[]

object (Permission)

قائمة الأذونات

الإذن

تمثيل JSON 
{

  "role": string

  "displayName": string

  "type": string

  "emailAddress": string

  "view": string
}
الحقول

حقل الربط _role

يمكن أن يكون التعليق _role إحدى القيم التالية فقط:
role

string

دور المستخدم الذي تم منحه الإذن في الملف تشمل الأدوار المحتملة ما يلي: * owner * organizer * fileOrganizer * writer * commenter * reader

حقل الربط _display_name

يمكن أن يكون التعليق _display_name إحدى القيم التالية فقط:
displayName

string

النتائج فقط. الاسم "pretty" (جميلة) الخاص بقيمة الإذن. في ما يلي قائمة أمثلة لكل نوع من الأذونات: * user - الاسم الكامل للمستخدم، كما هو محدّد في حساب Google، مثل "Dana A." * group: اسم مجموعة Google، مثل "مشرفو الشركة" * domain - اسم نطاق السلسلة، مثل "cymbalgroup.com" * anyone: لا يتوفّر displayName.

حقل الربط _type

يمكن أن يكون التعليق _type إحدى القيم التالية فقط:
type

string

تمثّل هذه السمة نوع المستفيد من المنحة. تشمل القيم المسموح بها ما يلي: * user * group * domain * anyone

حقل الربط _email_address

يمكن أن يكون التعليق _email_address إحدى القيم التالية فقط:
emailAddress

string

عنوان البريد الإلكتروني الخاص بالمستخدم أو المجموعة التي يشير إليها هذا الإذن

حقل الربط _view

يمكن أن يكون التعليق _view إحدى القيم التالية فقط:
view

string

تحدّد هذه السمة العرض الذي ينطبق عليه هذا الإذن، إن وُجد. تشمل القيم المسموح بها: * published * metadata

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

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

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

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

  • https://www.googleapis.com/auth/drive
  • https://www.googleapis.com/auth/drive.appdata
  • https://www.googleapis.com/auth/drive.file
  • https://www.googleapis.com/auth/drive.meet.readonly
  • https://www.googleapis.com/auth/drive.metadata
  • https://www.googleapis.com/auth/drive.metadata.readonly
  • https://www.googleapis.com/auth/drive.photos.readonly
  • https://www.googleapis.com/auth/drive.readonly