تهيئة دمج واجهة مستخدم Drive

لعرض تطبيقك في Google Drive عندما ينشئ المستخدم ملفًا أو يفتحه، عليك اتّباع الخطوات التالية: يجب أولاً إعداد دمج واجهة مستخدم Drive يجب ضبط الإعدادات أيضًا لإدراج تطبيقك في Google Workspace Marketplace

تفعيل Drive API

قبل استخدام Google APIs، يجب تفعيلها في Google Cloud. مشروعك. يمكنك تفعيل واجهة برمجة تطبيقات واحدة أو أكثر في واجهة واحدة على Google Cloud. مشروعك.

لبدء الدمج مع واجهة مستخدم Google Drive، يجب تفعيل واجهة برمجة تطبيقات Drive. يتيح لك ذلك الوصول إلى واجهة برمجة التطبيقات ودمج واجهة المستخدم. الجديدة.

• في وحدة تحكُّم Google Cloud، فعِّل Google Drive API.

  تفعيل واجهة برمجة التطبيقات

إعداد دمج واجهة مستخدم Drive

1. في وحدة التحكم في واجهة Google API، انتقِل إلى القائمة menu. > واجهات برمجة التطبيقات الخدمات > واجهات برمجة التطبيقات التي تم تفعيلها Google.

   انتقِل إلى "واجهات برمجة التطبيقات المفعّلة" و الخدمات

2. في الجزء السفلي من واجهات برمجة التطبيقات لوحة بيانات الخدمات، انقر على Google Drive API. تشير رسالة الأشكال البيانية ستظهر لك صفحة إعداد Google Drive API.
3. اختَر علامة التبويب دمج واجهة مستخدم Drive.
4. (اختياري) أدخِل اسمًا في حقل اسم التطبيق. التطبيق يظهر الاسم للمستخدمين في علامة التبويب "إدارة التطبيقات" في Drive. الإعدادات.
5. (اختياري) أدخِل وصفًا قصيرًا مكوَّنًا من سطر واحد في الوصف الموجز. . يظهر الوصف الموجز للمستخدمين في علامة التبويب "إدارة التطبيقات" في إعدادات Drive.
6. (اختياري) أدخِل وصفًا كاملاً في الحقل وصف طويل.

7. يمكنك تحميل رمز تطبيق واحد أو أكثر من رموز التطبيق لعرضها في قائمة المستخدم. تطبيقات Drive المرتبطة وفي القسم "فتح باستخدام" قائمة السياقات. يجب أن تكون الأيقونات بتنسيق PNG مع خلفية شفافة. يمكن أن تأخذ الرموز لمدة تصل إلى 24 ساعة لتظهر في Drive.

8. لاستخدام "فتح باستخدام" في واجهة مستخدم Drive القائمة العنصر، أدخِل عنوان URL الذي يؤدي إلى تطبيقك في فتح عنوان URL يُستخدم عنوان URL هذا من خلال "فتح باستخدام" قائمة السياقات.

   • يجب أن يحتوي عنوان URL هذا على اسم مجال مؤهل بالكامل؛ إجراء localhost لا عملك.
   • يجب أن يتمكّن المستخدمون المعنيّون لتطبيقك من الوصول إلى عنوان URL هذا. إذا كان لديك إصدارات متعددة للتطبيق، مثل إصدار متاح للجميع وإصدارًا للإصدار المحدود المتاحين لمستخدمين محدّدين، سيتم تطبيق كل إصدار على يجب أن يستخدم عنوان URL فريدًا. يمكنك بعد ذلك إنشاء تطبيق مختلف من التهيئات لكل إصدار.
   • يجب إثبات ملكية عنوان URL هذا قبل أن تتمكّن من إدراج تطبيقك في Google Workspace Marketplace
   • بشكل تلقائي، يتم إلحاق معلَمة طلب البحث state بعنوان URL هذا لتمرير البيانات من واجهة مستخدم Drive إلى تطبيقك. للحصول على معلومات عن لمحتوى مَعلمة state، راجِع صفحة state. .

9. (اختياري) أدخِل أنواع MIME التلقائية وامتدادات الملفات في حقول أنواع MIME التلقائية وامتدادات الملفات التلقائية بروتوكول MIME التلقائي أنواعها وامتداداتها التي تمثل الملفات التي تم إنشاء تطبيقك فيها بشكل فريد مفتوحة. على سبيل المثال، قد يفتح تطبيقك تنسيقًا مدمجًا لوضع الطبقات وتعديل الصور. تضمين الوسائط العادية فقط الأنواع والتأكد من خلوها من الأخطاء المطبعية والأخطاء الإملائية. في حال فتح التطبيق فقط اختصارات جهات خارجية، يمكنك ترك نوع MIME فارغًا.

10. (اختياري) أدخِل أنواع MIME الثانوية وامتدادات الملفات في الحقل الثانوي أنواع MIME وامتدادات الملفات الثانوية. أنواع MIME الثانوية وامتدادات الملفات هي الملفات التي يمكن للتطبيق فتحها، ولكنها إلى تطبيقك. على سبيل المثال، قد يكون تطبيقك تطبيقًا لتعديل الصور يفتح. صور PNG وJPG. تضمين الوسائط العادية فقط الأنواع والتأكد من خلوها من الأخطاء المطبعية والأخطاء الإملائية. في حال فتح التطبيق فقط اختصارات جهات خارجية، يمكنك ترك نوع MIME فارغًا.

11. لاستخدام الإصدار "جديد" من واجهة مستخدم Drive واطلب من المستخدمين إنشاء ملف يحتوي على لتطبيقك، ضَع علامة في المربّع إنشاء ملفات. عنوان URL الجديد والاختياري تظهر حقول اسم المستند.

    • يجب أن يحتوي عنوان URL هذا على اسم مجال مؤهل بالكامل؛ إجراء localhost لا عملك.
    • يجب إثبات ملكية هذا العنصر عنوان URL قبل أن تتمكّن من إدراج تطبيقك في Google Workspace Marketplace
    • بشكل تلقائي، يتم إلحاق معلَمة طلب البحث state بعنوان URL هذا لتمرير البيانات من واجهة مستخدم Drive إلى تطبيقك. للحصول على معلومات عن لمحتوى مَعلمة state، راجِع صفحة state. .

12. أدخِل عنوان URL في الحقل عنوان URL جديد. يُستخدم عنوان URL هذا من خلال قسم "جديد" زر إعادة توجيه المستخدم إلى تطبيقك.

13. (اختياري) إذا أردت أن يفتح تطبيقك الملفات المتوافقة مع Google Workspace، ضَع علامة في المربّع استيراد.

14. (اختياري) إذا كان على تطبيقك إدارة الملفات في مساحات التخزين السحابي المشتركة، تحقَّق من دعم مساحات التخزين السحابي المشتركة. لمزيد من المعلومات حول كيفية تقديم الدعم مساحات التخزين السحابي المشتركة في تطبيقك، يُرجى الاطّلاع على المقالة تنفيذ مساحة التخزين السحابي المشتركة. والدعم

15. انقر على إرسال.

طلب النطاق drive.install

للسماح للتطبيقات بالظهور كخيار في القائمة "فتح باستخدام" أو "جديد" الْقَائِمَة طلب دمج نطاق https://www.googleapis.com/auth/drive.install من خلال واجهة مستخدم Drive. عند طلب هذا النطاق، يتلقى المستخدمون مربع حوار مشابه لما يلي:

لمزيد من المعلومات عن النطاقات التي يمكنك طلبها لتطبيقات Drive: وكيفية طلبها، راجِع المصادقة والمصادقة الخاصة بواجهة برمجة التطبيقات. المعلومات.

المَعلمة state

يتم تلقائيًا إلحاق مَعلمة state بكل من عنوان URL المفتوح وعنوان URL الجديد. لتمرير البيانات من واجهة مستخدم Drive إلى تطبيقك. هذه المعلمة يحتوي على سلسلة مرمّزة بتنسيق JSON تضم متغيرات النموذج وبيانات حول طلبك إلى تطبيقك. تعتمد المتغيرات المتضمّنة على نوع عنوان URL المُستخدَم (مفتوح) عنوان URL أو عنوان URL جديد):

متغيّر النموذج	الوصف	تطبيق عنوان URL
{ids}	قائمة بمعرِّفات الملفات التي يتم فتحها مفصولة بفواصل.	فتح عنوان URL
{exportIds}	قائمة مفصولة بفواصل لمعرّفات الملفات التي يتم تصديرها (تُستخدم فقط عند فتح مستندات Google المضمنة).	فتح عنوان URL
{resourceKeys}	قاموس JSON لمعرّفات الملفات التي تم ربطها بالمورد المعني المفاتيح.	فتح عنوان URL
{folderId}	رقم تعريف المجلد الرئيسي.	عنوان URL جديد
{folderResourceKey}	مفتاح المصدر للمجلد الرئيسي.	عنوان URL جديد
{userId}	رقم تعريف الملف الشخصي الذي يعرّف عن المستخدم	عنوان URL مفتوح وعنوان URL جديد
{action}	الإجراء الذي يتم تنفيذه. القيمة هي open عند استخدام عنوان URL مفتوح أو create عند استخدام عنوان URL جديد.	عنوان URL مفتوح وعنوان URL جديد

والمَعلمة state هي عنوان URL مرمّز، لذا يجب أن يتعامل تطبيقك مع مفتاح الإلغاء. وتحليله على هيئة JSON. يمكن للتطبيقات اكتشاف قيمة create في معلَمة state للتحقّق من طلب إنشاء ملف.

مثال على معلومات حالة بتنسيق JSON لعنوان URL جديد

في ما يلي معلومات عن state لعنوان URL الجديد:

{
  "action":"create",
  "folderId":"FOLDER_ID",
  "folderResourceKey":"FOLDER_RESOURCE_KEY",
  "userId":"USER_ID"
}

مثال على معلومات حالة بتنسيق JSON لعنوان URL مفتوح

معلومات state لعنوان URL المفتوح هي:

{
  "ids": ["ID"],
  "resourceKeys":{"RESOURCE_KEYS":"RESOURCE_KEYS"},
  "action":"open",
  "userId":"USER_ID"
}

تُستخدَم أرقام التعريف ومفاتيح الموارد لاسترجاع البيانات الوصفية للملفات وتنزيل الملف. المحتوى. بعد حصول تطبيقك على رقم تعريف الملف ورمز الدخول، يمكن للتطبيق التحقّق من الأذونات واسترجاع البيانات الوصفية للملف وتنزيل محتوى الملف على النحو الموضَّح. في طريقة files.get.

مواضيع ذات صلة

يجب أن يكون التطبيق المثبّت قادرًا على إنشاء وإدارة وفتح إجراءات يتم تشغيلها من واجهة مستخدم Drive. لمزيد من المعلومات، يُرجى الاطّلاع على الدمج مع "جديد" في واجهة مستخدم Drive الزر أو الدمج مع ميزة "فتح باستخدام" في واجهة مستخدم Drive السياق القائمة