نطاقات API في Drive وأذوناتها بالتفصيل
مرجع لنطاقات API الإحدى عشرة في TrekMail Drive والوصول حسب الخطة والإضافة وقيود صناديق البريد وأذونات الحذف وتصميم الرموز الآمن.
تفاصيل المقال
النوع والصعوبة والخطط ومعلومات آخر تحديث.
▼
تفاصيل المقال
النوع والصعوبة والخطط ومعلومات آخر تحديث.
- النوع
- مرجع
- الصعوبة
- متوسط
- الخطط
- Starter · Pro · Agency · + Drive Add-on
- آخر تحديث
- 10 سبتمبر 2026
تحدد نطاقات Drive بالضبط ما يستطيع رمز API أو وكيل MCP فعله في TrekMail Drive. يكون الرمز الجيد محدودا: أصغر مجموعة نطاقات لمهمة واحدة واسم واضح وتاريخ انتهاء صلاحية.
تحتوي API في Drive على 11 نطاقا تشمل Drive للحساب وصندوق البريد وروابط المشاركة والحذف الدائم وحالة إضافة Drive وكلمات مرور أجهزة المزامنة. تخص هذه النطاقات رموز العمليات (tm_live_...). وتظل رموز الرسائل (tm_msg_...) لعمليات البريد الإلكتروني.
مرجع النطاقات
| النطاق | الاستخدام | ملاحظات |
|---|---|---|
drive:account:read |
عرض المساحات والمجلدات والملفات والمهملات والاستخدام وروابط التنزيل | إعداد آمن لوكلاء التقارير والبحث |
drive:account:write |
إنشاء المجلدات والرفع وإعادة التسمية والنقل والإرسال للمهملات والاستعادة | يغير الملفات دون حذف دائم |
drive:account:share |
إنشاء روابط عامة لملفات الحساب وعرضها وإلغاؤها | تعاد رموز المشاركة الخام عند الإنشاء فقط |
drive:account:purge |
حذف عناصر المهملات نهائيا وإفراغها | عالي الخطورة؛ للوكلاء الموثوقين فقط |
drive:mailbox:read |
تصفح مساحات صناديق البريد المسموح بها | يمكن تضييقه بقيود الصناديق |
drive:mailbox:write |
رفع الملفات وإدارتها في المساحات المسموح بها | يغير بيانات Drive المملوكة للصندوق |
drive:mailbox:share |
إنشاء الروابط العامة للملفات المسموح بها وعرضها وإلغاؤها | استخدم انتهاء وحدود تنزيل واضحة |
drive:mailbox:purge |
حذف ملفات ومجلدات الصندوق في المهملات نهائيا | عالي الخطورة؛ افصله عن الأتمتة اليومية |
drive:addon:read |
قراءة حالة الإضافة وأسعارها ومعاينة إلغائها | للقراءة فقط؛ لا تغيير للاشتراك |
drive:devices:read |
عرض كلمات مرور أجهزة مزامنة Drive | يعرض التسميات والنطاق وآخر استخدام والانتهاء، لا كلمة المرور الصريحة |
drive:devices:write |
إنشاء كلمات مرور الأجهزة وتبديلها وإلغاؤها | ضمن أذونات Drive الخاصة بالمتصل فقط |
القراءة والكتابة والمشاركة والحذف النهائي
يفصل Drive المهام إلى أربعة مستويات:
- القراءة تعرض المساحات والمجلدات والبيانات الوصفية والمهملات وتطلب عناوين URL للتنزيل.
- الكتابة ترفع الملفات وتنشئ المجلدات وتعيد التسمية وتنقل وتحذف وتستعيد.
- المشاركة تنشئ روابط المشاركة العامة وتعرضها وتلغيها.
- الحذف النهائي يحذف عناصر المهملات نهائيا أو يفرغها.
لا تمنح الحذف النهائي لمساعد عام. أنشئ للتنظيف التلقائي رمزا منفصلا باسم المهمة، وأبقه معطلا في MCP حتى الحاجة، وراجع سجل التدقيق بعد كل تشغيل.
الوصول حسب الخطة والإضافة
تتاح API في Drive عندما يملك الحساب استحقاق Drive عبر خطة مدفوعة أو إضافة تخزين نشطة. يستطيع الحساب المجاني ذو الإضافة النشطة استخدام نطاقات Drive، مثل توفر نطاقات مدقق البريد مستقلة عن الوصول الكامل إلى API للبنية التحتية.
بعد إلغاء الإضافة، قد تبقى القراءة في المهلة لمراجعة الملفات وتصديرها. وقد تقيد الكتابة والمشاركة والحذف حتى تعود حالة التخزين نشطة.
Drive للحساب وDrive لصندوق البريد
نطاقات الحساب والصندوق منفصلة عمدا. قد يحتاج وكيل الفوترة إلى Drive للحساب فقط، ومساعد البريد إلى Drive لصندوق واحد فقط.
استخدم قيود الصندوق عند إنشاء الرمز. لا يرى الرمز المقيد إلا المساحات المسموح بها. تعيد طلبات الصناديق الأخرى استجابة تشبه «غير موجود» حتى لا تكشف بنية الحساب.
نطاق إضافة Drive للقراءة فقط
يقرأ drive:addon:read الحالة والأسعار ومعاينة الإلغاء، ولا يشتري التخزين أو يغير السعة أو يلغي الاشتراك أو يبدأ الدفع.
هذه الحدود مقصودة. تبقى تغييرات الفوترة في لوحة المعلومات، حيث يراجع شخص السعة والسعر والعملة والفترة وتأكيد الدفع. لا يوجد نطاق drive:addon:write.
كلمات مرور أجهزة المزامنة
يدير drive:devices:read وdrive:devices:write كلمات مرور منفصلة لتطبيقات WebDAV، وليست رمز API. تظهر الكلمة الجديدة مرة واحدة، فاحفظها فورا في التطبيق أو مدير كلمات المرور. افصل إدارة الأجهزة عن أتمتة الملفات وألغ الكلمة عندما يجب أن يتوقف الاتصال.
تتضمن استجابات العرض والإنشاء والتبديل server_url. استخدم العنوان المعاد بدلا من تركيب /dav: تحصل الحسابات ذات منطقة White Label المكتملة على اسم مضيف DAV بعلامتها، وتحصل البقية على اسم مضيف المنصة العامل.
أنماط الرموز الموصى بها
| المهمة | النطاقات الموصى بها | تجنب |
|---|---|---|
| التقارير | drive:account:read، وربما drive:mailbox:read |
الكتابة/المشاركة/الحذف |
| الرفع | drive:account:read، drive:account:write |
الحذف |
| روابط العملاء | drive:account:read، drive:account:share |
الحذف إلا مع تنظيف منفصل |
| مساعد الصندوق | drive:mailbox:read، وربما drive:mailbox:write، مقيد بصندوق |
نطاقات الحساب كله |
| التنظيف | القراءة/الكتابة ونطاق الحذف المطلوب | الرموز الواسعة غير المقيدة |
| مراقبة التخزين | drive:addon:read، drive:account:read |
كتابة الفوترة غير المتاحة عبر API |
| إدارة الأجهزة | drive:devices:read، drive:devices:write ونطاقات الملفات اللازمة |
رمز حساب كامل بأذونات كتابة غير مرتبطة |
عند غياب نطاق
تعيد API خطأ أذونات إذا غاب نطاق Drive المطلوب. وإذا استبعد القيد صندوقا أو موردا، فقد تعيد «غير موجود». يحمي ذلك بنية الحساب الخاصة.
مقالات ذات صلة
انتقل إلى الأدلة القريبة التي تُكمل سير العمل.