لعرض تطبيقك في Google Drive عندما ينشئ المستخدم ملفًا أو يفتحه، عليك اتّباع الخطوات التالية: يجب أولاً إعداد دمج واجهة مستخدم Drive يجب ضبط الإعدادات أيضًا لإدراج تطبيقك في Google Workspace Marketplace
تفعيل Drive API
قبل استخدام Google APIs، يجب تفعيلها في Google Cloud. مشروعك. يمكنك تفعيل واجهة برمجة تطبيقات واحدة أو أكثر في واجهة واحدة على Google Cloud. مشروعك.
لبدء الدمج مع واجهة مستخدم Google Drive، يجب تفعيل واجهة برمجة تطبيقات Drive. يتيح لك ذلك الوصول إلى واجهة برمجة التطبيقات ودمج واجهة المستخدم. الجديدة.
في وحدة تحكُّم Google Cloud، فعِّل Google Drive API.
إعداد دمج واجهة مستخدم Drive
- في وحدة التحكم في واجهة Google API، انتقِل إلى القائمة > واجهات برمجة التطبيقات الخدمات > واجهات برمجة التطبيقات التي تم تفعيلها Google. .
- في الجزء السفلي من واجهات برمجة التطبيقات لوحة بيانات الخدمات، انقر على Google Drive API. تشير رسالة الأشكال البيانية ستظهر لك صفحة إعداد Google Drive API.
- اختَر علامة التبويب دمج واجهة مستخدم Drive.
- (اختياري) أدخِل اسمًا في حقل اسم التطبيق. التطبيق يظهر الاسم للمستخدمين في علامة التبويب "إدارة التطبيقات" في Drive. الإعدادات.
- (اختياري) أدخِل وصفًا قصيرًا مكوَّنًا من سطر واحد في الوصف الموجز. . يظهر الوصف الموجز للمستخدمين في علامة التبويب "إدارة التطبيقات" في إعدادات Drive.
- (اختياري) أدخِل وصفًا كاملاً في الحقل وصف طويل.
يمكنك تحميل رمز تطبيق واحد أو أكثر من رموز التطبيق لعرضها في قائمة المستخدم. تطبيقات Drive المرتبطة وفي القسم "فتح باستخدام" قائمة السياقات. يجب أن تكون الأيقونات بتنسيق PNG مع خلفية شفافة. يمكن أن تأخذ الرموز لمدة تصل إلى 24 ساعة لتظهر في Drive.
لاستخدام "فتح باستخدام" في واجهة مستخدم Drive القائمة العنصر، أدخِل عنوان URL الذي يؤدي إلى تطبيقك في فتح عنوان URL يُستخدم عنوان URL هذا من خلال "فتح باستخدام" قائمة السياقات.
- يجب أن يحتوي عنوان URL هذا على اسم مجال مؤهل بالكامل؛ إجراء
localhost
لا عملك. - يجب أن يتمكّن المستخدمون المعنيّون لتطبيقك من الوصول إلى عنوان URL هذا. إذا كان لديك إصدارات متعددة للتطبيق، مثل إصدار متاح للجميع وإصدارًا للإصدار المحدود المتاحين لمستخدمين محدّدين، سيتم تطبيق كل إصدار على يجب أن يستخدم عنوان URL فريدًا. يمكنك بعد ذلك إنشاء تطبيق مختلف من التهيئات لكل إصدار.
- يجب إثبات ملكية عنوان URL هذا قبل أن تتمكّن من إدراج تطبيقك في Google Workspace Marketplace
- بشكل تلقائي، يتم إلحاق معلَمة طلب البحث
state
بعنوان URL هذا لتمرير البيانات من واجهة مستخدم Drive إلى تطبيقك. للحصول على معلومات عن لمحتوى مَعلمةstate
، راجِع صفحةstate
. .
- يجب أن يحتوي عنوان URL هذا على اسم مجال مؤهل بالكامل؛ إجراء
(اختياري) أدخِل أنواع MIME التلقائية وامتدادات الملفات في حقول أنواع MIME التلقائية وامتدادات الملفات التلقائية بروتوكول MIME التلقائي أنواعها وامتداداتها التي تمثل الملفات التي تم إنشاء تطبيقك فيها بشكل فريد مفتوحة. على سبيل المثال، قد يفتح تطبيقك تنسيقًا مدمجًا لوضع الطبقات وتعديل الصور. تضمين الوسائط العادية فقط الأنواع والتأكد من خلوها من الأخطاء المطبعية والأخطاء الإملائية. في حال فتح التطبيق فقط اختصارات جهات خارجية، يمكنك ترك نوع MIME فارغًا.
(اختياري) أدخِل أنواع MIME الثانوية وامتدادات الملفات في الحقل الثانوي أنواع MIME وامتدادات الملفات الثانوية. أنواع MIME الثانوية وامتدادات الملفات هي الملفات التي يمكن للتطبيق فتحها، ولكنها إلى تطبيقك. على سبيل المثال، قد يكون تطبيقك تطبيقًا لتعديل الصور يفتح. صور PNG وJPG. تضمين الوسائط العادية فقط الأنواع والتأكد من خلوها من الأخطاء المطبعية والأخطاء الإملائية. في حال فتح التطبيق فقط اختصارات جهات خارجية، يمكنك ترك نوع MIME فارغًا.
لاستخدام الإصدار "جديد" من واجهة مستخدم Drive واطلب من المستخدمين إنشاء ملف يحتوي على لتطبيقك، ضَع علامة في المربّع إنشاء ملفات. عنوان URL الجديد والاختياري تظهر حقول اسم المستند.
- يجب أن يحتوي عنوان URL هذا على اسم مجال مؤهل بالكامل؛ إجراء
localhost
لا عملك. - يجب إثبات ملكية هذا العنصر عنوان URL قبل أن تتمكّن من إدراج تطبيقك في Google Workspace Marketplace
- بشكل تلقائي، يتم إلحاق معلَمة طلب البحث
state
بعنوان URL هذا لتمرير البيانات من واجهة مستخدم Drive إلى تطبيقك. للحصول على معلومات عن لمحتوى مَعلمةstate
، راجِع صفحةstate
. .
- يجب أن يحتوي عنوان URL هذا على اسم مجال مؤهل بالكامل؛ إجراء
أدخِل عنوان URL في الحقل عنوان URL جديد. يُستخدم عنوان URL هذا من خلال قسم "جديد" زر إعادة توجيه المستخدم إلى تطبيقك.
(اختياري) إذا أردت أن يفتح تطبيقك الملفات المتوافقة مع Google Workspace، ضَع علامة في المربّع استيراد.
(اختياري) إذا كان على تطبيقك إدارة الملفات في مساحات التخزين السحابي المشتركة، تحقَّق من دعم مساحات التخزين السحابي المشتركة. لمزيد من المعلومات حول كيفية تقديم الدعم مساحات التخزين السحابي المشتركة في تطبيقك، يُرجى الاطّلاع على المقالة تنفيذ مساحة التخزين السحابي المشتركة. والدعم
انقر على إرسال.
طلب النطاق drive.install
للسماح للتطبيقات بالظهور كخيار في القائمة "فتح باستخدام" أو "جديد" الْقَائِمَة
طلب دمج نطاق https://www.googleapis.com/auth/drive.install
من خلال واجهة مستخدم Drive. عند طلب هذا النطاق، يتلقى المستخدمون
مربع حوار مشابه لما يلي:
![مربّع حوار تثبيت واجهة مستخدم Google Drive](https://developers.google.cn/static/drive/images/install-scope.png?authuser=0000&hl=ar)
لمزيد من المعلومات عن النطاقات التي يمكنك طلبها لتطبيقات 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 السياق القائمة