حدود API لإضافة مساحة تخزين Drive

تزيد إضافة مساحة تخزين Drive سعة التخزين المجمعة لحسابات TrekMail. يستطيع الوكلاء قراءة حالة الإضافة وأسعارها، لكنهم لا يستطيعون شراءها أو زيادة سعتها أو تقليلها أو إلغاءها أو تغيير الاشتراك بأي طريقة أخرى من خلال عمليات الكتابة في API أو MCP.

توضح هذه الصفحة هذه الحدود حتى تكون الأتمتة مفيدة دون تحويل قرارات الفوترة إلى إجراءات ينفذها الوكلاء في الخلفية.

ما يستطيع الوكلاء قراءته

باستخدام drive:addon:read، يستطيع التكامل قراءة ما يلي:

• الحالة الحالية لإضافة Drive.
• السعة وفترة الفوترة عندما تكون الإضافة نشطة.
• خيارات الأسعار للعملات المدعومة.
• معلومات معاينة الإلغاء، عند توفرها.
• سياق استخدام مساحة التخزين الذي يساعد في توضيح ما إذا كانت هناك حاجة إلى سعة إضافية.

تكفي هذه المعلومات لوكلاء إعداد التقارير ولوحات المعلومات وأدوات مراقبة التخزين ومهام الدعم.

ما لا يستطيع الوكلاء تغييره

لا توفر API ولا خادم MCP عمليات كتابة من أجل:

• شراء إضافة Drive.
• زيادة سعة الإضافة أو تقليلها.
• تغيير فترة الفوترة أو طريقة الدفع.
• إلغاء الإضافة أو إعادة تنشيطها.
• بدء عمليات خصم من البطاقة أو إجراء تغييرات على الاشتراك.

لا يوجد نطاق drive:addon:write. ولا يحتوي خادم MCP على أداة للشراء أو تغيير السعة أو الإلغاء.

سبب وجود هذه الحدود

قد تؤثر تغييرات التخزين في الفواتير والعملة وتخطيط السعة والاحتفاظ بالبيانات. يستطيع الوكيل المفيد ملاحظة ارتفاع الاستخدام وشرح الخيارات، لكن يجب تنفيذ خطوة الفوترة النهائية في لوحة المعلومات، حيث يرى المستخدم السعر ويؤكد الإجراء.

تحد هذه الضوابط أيضا من الضرر إذا كان الوكيل معدا بطريقة غير صحيحة. يستطيع رمز محدود النطاق لمراقبة التخزين الإبلاغ بأن الحصة أوشكت على النفاد دون أن يتمكن من إنفاق المال أو إلغاء السعة.

نمط الأتمتة الموصى به

1. امنح drive:addon:read ونطاق القراءة المناسب في Drive.
2. اطلب من الوكيل التحقق من الاستخدام وحالة الإضافة.
3. إذا أوشكت مساحة التخزين على النفاد، فاطلب من الوكيل إعداد توصية قصيرة.
4. وجه المستخدم إلى صفحة إضافة Drive في لوحة المعلومات عند الرغبة في الشراء أو تغيير السعة أو الإلغاء.

مثال على رد الوكيل:

يستخدم حسابك 91% من مساحة التخزين المجمعة. إضافة Drive الحالية نشطة. استنادا إلى معدل النمو الحالي، ننصح بمراجعة سعة الإضافة في لوحة المعلومات قبل الدفعة التالية من عمليات الرفع.

حالات المهلة والسماح بالقراءة فقط

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