عرض مربّع حوار المشاركة

للسماح للمستخدمين بمشاركة ملفات Drive مباشرةً من تطبيقك، يمكنك استخدام مربّع حوار المشاركة في Google Drive. يتم استدعاء مربّع الحوار المشروط هذا من تطبيقك للسماح بمشاركة الملفات على Drive. يعرض الشكل 1 زر "المشاركة" في "مستندات Google" ومربّع حوار المشاركة الناتج.

زر المشاركة ومربّع الحوار
الشكل 1. زر ومربّع حوار "المشاركة"

لتفعيل مربّع حوار المشاركة في Drive، أضِف نص مربّع الحوار وزر تشغيل أو آلية تشغيل أخرى إلى واجهة المستخدم.

إضافة نص مربّع الحوار

لإنشاء نموذج من مربّع حوار المشاركة، أضِف النص البرمجي التالي إلى صفحة التشغيل:

<head>
...
<script type="text/javascript" src="https://apis.google.com/js/api.js"></script>
<script type="text/javascript">
    init = function() {
        s = new gapi.drive.share.ShareClient();
        s.setOAuthToken('<OAUTH_TOKEN>');
        s.setItemIds(['<FILE_ID>']);
    }
    window.onload = function() {
        gapi.load('drive-share', init);
    }
</script>
</head>

المكان:

  • يجب استبدال <OAUTH_TOKEN> برمز OAuth2 المميَّز للوصول الخاص بالمستخدم المفوَّض .
  • يجب استبدال <FILE_ID> بمعرّف الملف الذي تريد مشاركته.

إضافة زر تشغيل

في واجهة المستخدم، أضِف سطرًا من التعليمات البرمجية مشابهًا لما يلي:

<button onclick="s.showSettingsDialog()">Share</button>

يستدعي هذا الرمز الدالة showSettingsDialog() عند النقر على الزر "مشاركة".