عندما يختار المستخدم ملفًا وينقر على عنصر قائمة "فتح باستخدام" في واجهة مستخدم Drive، يعيد Drive توجيه المستخدم إلى عنوان URL المفتوح لهذا التطبيق المحدد في ضبط دمج واجهة مستخدم Drive.
إذا وضعت علامة في المربّع "استيراد" عند ضبط عملية دمج واجهة مستخدم Drive، يمكن للمستخدم اختيار مجموعة من الملفات الخاصة بالتطبيقات وملفات Google Workspace لفتحها. عند إعداد عملية دمج لواجهة مستخدم Drive، يتم تحديد الملفات الخاصة بالتطبيقات في الحقلين "أنواع MIME التلقائية" و"امتدادات الملفات التلقائية"، بينما يتم تحديد ملفات Google Workspace في الحقلَين "أنواع MIME الثانوية" و "امتدادات الملفات الثانوية".
بالنسبة إلى كل ملف يريد المستخدم فتحه، يتحقّق Drive من أنواع MIME في مقابل أنواع MIME التلقائية والثانوية المحدّدة:
بالنسبة إلى أنواع MIME التي تم تحديدها في حقل "أنواع MIME التلقائية"، يتم تمرير رقم تعريف الملف إلى تطبيقك. وللحصول على معلومات حول كيفية التعامل مع الملفات الخاصة بالتطبيق، راجع التعامل مع عنوان URL مفتوح للمستندات الخاصة بالتطبيق.
بالنسبة إلى أنواع MIME الثانوية المحدّدة في حقل "أنواع MIME الثانوية"، تعرض واجهة مستخدم Drive مربّع حوار يطلب من المستخدم نوع الملف الذي يريد تحويل ملف Google Workspace إليه. على سبيل المثال، إذا اخترت ملف "مستندات Google" في واجهة مستخدم Drive وكان حقل "أنواع MIME الثانوية" يقترح أن تطبيقك يتوافق مع النص/العادي أو application/pdf، ستسأل واجهة مستخدم Drive المستخدم ما إذا كان يريد التحويل إلى نص عادي أو PDF.
للحصول على معلومات عن كيفية التعامل مع ملفات Google Workspace، يُرجى الاطّلاع على التعامل مع عنوان URL مفتوح لمستندات Google Workspace. للحصول على قائمة بمستندات Google Workspace وتنسيقات الإحالات الناجحة من نوع MIME، يُرجى الاطّلاع على تصدير أنواع MIME لمستندات Google Workspace.
التعامل مع عنوان URL مفتوح للمستندات الخاصة بالتطبيق
كما هو مذكور في إعداد دمج واجهة مستخدم Drive،
يتلقّى تطبيقك متغيرات النماذج مع معلومات عن تطبيقك لفتح الملف. يتلقى تطبيقك مجموعة تلقائية من متغيرات النماذج
ضمن معلمة state
. معلومات state
التلقائية لعنوان URL المفتوح الخاص بتطبيق معيّن هي:
{
"ids": ["ID"],
"resourceKeys":{"RESOURCE_KEYS":"RESOURCE_KEYS"},
"action":"open",
"userId":"USER_ID"
}
يتضمن هذا الناتج القيم التالية:
- ID: رقم تعريف المجلد الرئيسي
- RESOURCE_KEYS: قاموس JSON لمعرّفات الملفات التي تم ربطها بمفاتيح الموارد الخاصة بها
open
: الإجراء الذي يتم تنفيذه تكون القيمةopen
عند استخدام عنوان URL مفتوح.- USER_ID: رقم تعريف الملف الشخصي الذي يعرّف المستخدم بشكلٍ فريد
يجب أن يتعامل تطبيقك مع هذا الطلب من خلال اتّباع الخطوات التالية:
- تأكَّد من أنّ الحقل
action
يحتوي على القيمةopen
وأنّ الحقلids
متوفّر. - استخدِم القيمة
userId
لإنشاء جلسة جديدة للمستخدم. لمزيد من المعلومات عن المستخدمين الذين سجّلوا دخولهم، يُرجى مراجعة المستخدمون والأحداث الجديدة. - استخدِم طريقة
files.get
للتحقّق من الأذونات وجلب البيانات الوصفية للملف وتنزيل محتوى الملف باستخدام قيمID
. - في حال ضبط
resourceKeys
على الطلب، عليك ضبط عنوان الطلبX-Goog-Drive-Resource-Keys
. لمزيد من المعلومات حول مفاتيح الموارد، يُرجى الاطّلاع على الوصول إلى الملفات المشتركة باستخدام روابط باستخدام مفاتيح الموارد.
المعلَمة state
مرمّزة بعنوان URL، لذا يجب على تطبيقك معالجة أحرف الإلغاء وتحليلها بتنسيق JSON.
التعامل مع عنوان URL مفتوح لمستندات Google Workspace
كما هو مذكور في إعداد دمج واجهة مستخدم Drive، يتلقّى تطبيقك مجموعة تلقائية من
متغيّرات النموذج ضمن معلَمة state
. معلومات state
التلقائية
لعنوان URL المفتوح في Google Workspace هي:
{
"exportIds": ["ID"],
"resourceKeys":{"RESOURCE_KEYS":"RESOURCE_KEYS"},
"action":"open",
"userId":"USER_ID"
}
يتضمن هذا الناتج القيم التالية:
- EXPORT_ID: قائمة مفصولة بفواصل لمعرّفات الملفات التي يتم تصديرها (تُستخدم فقط عند فتح مستندات Google المضمّنة).
- RESOURCE_KEYS: قاموس JSON لمعرّفات الملفات التي تم ربطها بمفاتيح الموارد الخاصة بها
open
: الإجراء الذي يتم تنفيذه تكون القيمةopen
عند استخدام عنوان URL مفتوح.- USER_ID: رقم تعريف الملف الشخصي الذي يحدِّد هوية المستخدم
يجب أن يتعامل تطبيقك مع هذا الطلب من خلال اتّباع الخطوات التالية:
تأكَّد من أنّ هذا الطلب هو طلب لفتح ملف، وذلك من خلال رصد كل من القيمة
open
في الحقلstate
وتوفُّر الحقلexportIds
.استخدِم طريقة
files.get
للتحقّق من الأذونات وجلب البيانات الوصفية للملف وتحديد نوع MIME باستخدام قيمEXPORT_ID
.حوِّل محتوى الملف باستخدام طريقة
files.export
. ويوضّح نموذج الرموز التالية كيفية تصدير مستند Google Workspace إلى نوع MIME المطلوب.في حال ضبط
resourceKey
على الطلب، عليك ضبط عنوان الطلبX-Goog-Drive-Resource-Keys
. لمزيد من المعلومات حول مفاتيح الموارد، يُرجى الاطّلاع على الوصول إلى الملفات المشتركة باستخدام روابط باستخدام مفاتيح الموارد.Java
Python
Node.js
PHP
اعرض الملفات المحوَّلة على أنّها للقراءة فقط أو قدِّم مربع حوار يسمح للمستخدم بحفظ الملف كنوع الملف الجديد.
المعلَمة state
مرمّزة بعنوان URL، لذا يجب على تطبيقك معالجة أحرف الإلغاء وتحليلها بتنسيق JSON.
المستخدمون والأحداث الجديدة
من المفترض أن تتعامل تطبيقات Drive مع جميع أحداث "فتح باستخدام" باعتبارها عمليات تسجيل دخول محتملة. قد يمتلك بعض المستخدمين حسابات متعددة، لذلك قد لا يتطابق رقم تعريف المستخدم في
المَعلمة state
مع الجلسة الحالية. إذا كان رقم تعريف المستخدم في المعلَمة state
لا يتطابق مع الجلسة الحالية، عليك إنهاء الجلسة الحالية لتطبيقك وتسجيل الدخول باسم المستخدم المطلوب.
مواضيع ذات صلة
بالإضافة إلى فتح أحد التطبيقات من واجهة مستخدم Google Drive، يمكن أن تعرض التطبيقات أداة اختيار الملفات لاختيار المحتوى من داخل التطبيق. لمزيد من المعلومات، اطّلِع على منتقي Google.