عندما يختار مستخدم ملفًا وينقر على عنصر قائمة السياق "فتح باستخدام"، فإن Drive يعيد توجيه المستخدم إلى عنوان URL المفتوح لهذا التطبيق المحدد عند تهيئة دمج Drive.
في حال وضع علامة في المربّع "استيراد" عند إعداد دمج Drive، يمكن للمستخدم اختيار مجموعة من الملفات الخاصة بالتطبيقات وGoogle Workspace لفتحها. يتم تحديد الملفات الخاصة بالتطبيقات في الحقلين "أنواع MIME التلقائية" و"امتدادات الملفات التلقائية" عند إعداد دمج Drive. يتم تحديد ملفاتGoogle Workspace في الحقلين "أنواع MIME الثانوية" و"إضافات الملفات الثانوية" عند إعداد دمج Drive.
بالنسبة إلى كل ملف يريد المستخدم فتحه، يتحقّق Drive من أنواع MIME مقابل أنواع MIME التلقائية والثانوية التي حدَّدتها:
بالنسبة إلى أنواع MIME المحددة في حقل أنواع MIME الافتراضية، يتم تمرير معرف الملف إلى تطبيقك. للحصول على معلومات حول كيفية التعامل مع الملفات الخاصة بالتطبيق، يمكنك الرجوع إلى معالجة عنوان URL المفتوح لمستند خاص بالتطبيق
بالنسبة إلى أنواع MIME المحددة في الحقل أنواع Mime الثانوية ، تعرض واجهة مستخدم Drive مربع حوار يسأل المستخدم عن نوع الملف لتحويل الملفGoogle Workspace . على سبيل المثال، إذا اختَرت أحد "مستندات Google" في واجهة مستخدم Drive واقترح حقل "أنواع Mime الثانوية" أن تطبيقك يتيح استخدام نص/html أو نص/عادي أو تطبيق/pdf، ستسأل واجهة مستخدم Drive المستخدم ما إذا كان يريد التحويل إلى HTML أو نص عادي أو PDF. للحصول على معلومات عن طريقة معالجة Google Workspace الملفات، يُرجى الرجوع إلى التعامل مع عنوان URL مفتوح في Google Workspace مستند. للحصول على قائمة من Google Workspace المستندات، وتنسيقات الإحالات الناجحة، وأنواع mime المتوافقة، يُرجى الرجوع إلى Google Workspace أنواع تصدير MIME المقابلة.
معالجة عنوان URL المفتوح لمستند محدَّد للتطبيق
كما ورد في تهيئة دمج واجهة مستخدم Drive،
يتلقى تطبيقك متغيرات نماذج تحتفظ بمعلومات حول تطبيقك
لفتح الملف. يتلقّى تطبيقك مجموعة تلقائية من متغيّرات النموذج
ضمن معلَمة state
. معلومات state
التلقائية لعنوان URL المفتوح الخاص بالتطبيق هي:
{
"ids": ["0Bz0bd"],
"resourceKeys":{"0Bz0bd":"AAshj23Ad1"},
"action":"open",
"userId":"103354693083460731603"
}
لمعالجة هذه المعلومات:
يمكنك رصد القيمة
open
في المَعلمةstate
للتأكّد من أنّ هذا طلب لفتح ملف.يمكنك التحقق من الأذونات وجلب البيانات الوصفية للملف وتنزيل محتوى الملف باستخدام طريقة files.get.
المعلمة state
بترميز URL، لذلك يجب أن يتعامل تطبيقك مع أحرف الإلغاء ويحللها كملف JSON.
التعامل مع عنوان URL مفتوح لأحد المستندات Google Workspace
كما ورد في إعداد دمج واجهة مستخدم Drive، يتلقى تطبيقك مجموعة تلقائية من متغيّرات النموذج ضمن معلَمة state
. معلومات state
التلقائية لعنوان URL المفتوح الخاص بالتطبيق هي:
{
"exportIds": ["0Bz0bd"],
"resourceKeys":{"0Bz0bd":"AAshj23Ad1"},
"action":"open",
"userId":"103354693083460731603"
}
لمعالجة هذه المعلومات:
يمكنك رصد القيمة
open
في المَعلمةstate
للتأكّد من أنّ هذا طلب لفتح ملف.يمكنك التحقّق من الأذونات وجلب البيانات الوصفية للملف وتحديد نوع MIME.
تحويل محتوى الملف باستخدام طريقة files.export. يعرض المقتطف التالي كيفية تحويل ملف كنوع ملف جديد.
لغة Java
لغة Python
Node.js
لغة PHP
اعرض الملفات المحولة كملف للقراءة فقط أو قدّم مربع حوار يسمح للمستخدم بحفظ الملف كملف من النوع الجديد.
المعلمة state
بترميز URL، لذلك يجب أن يتعامل تطبيقك مع أحرف الإلغاء ويحللها كملف JSON.
التعامل مع أحداث "فتح باستخدام"
يجب أن تتعامل تطبيقات Drive مع جميع أحداث "فتح باستخدام" باعتبارها عمليات تسجيل دخول محتملة. قد يكون لدى بعض المستخدمين حسابات متعددة، لذلك قد لا يتطابق رقم تعريف المستخدم في المعلمة state
مع الجلسة الحالية. إذا لم يتطابق User ID في المعلمة state
مع الجلسة الحالية، يمكنك إنهاء الجلسة الحالية لتطبيقك وتسجيل الدخول باسم المستخدم المطلوب.
الخطوة التالية
بالإضافة إلى تشغيل أحد التطبيقات من واجهة مستخدم Google Drive، يمكن للتطبيقات عرض منتقي الملفات لتحديد المحتوى من داخل التطبيق نفسه. راجع دليل منتقي الملفات للحصول على تفاصيل إضافية.
يجب أن تعرض التطبيقات الملفات المحولة كملفات للقراءة فقط، أو تسمح للمستخدمين بحفظها كملفات جديدة.