التفويض لخدمات Google

تتطلّب خدمة Apps Script تفويض المستخدم للوصول إلى البيانات الخاصة من خدمات Google المضمّنة أو خدمات Google المتقدّمة.

منح أذونات الوصول

تحدِّد Apps Script نطاقات التفويض (مثل الوصول إلى ملفاتك في "جداول بيانات Google" أو Gmail) تلقائيًا استنادًا إلى فحص الرمز. سيظل بإمكان الرمز الذي تم هُمْشه إنشاء طلب تفويض. إذا كان النص البرمجي يحتاج إلى تفويض، سيظهر لك أحد مربّعات حوار التفويض المعروضة هنا عند تشغيله.

تطلب النصوص البرمجية التي سبق أن منحت الإذن لها أيضًا الحصول على إذن إضافي في حال إضافة خدمات جديدة من خلال تغيير الرمز. قد لا تطلب النصوص البرمجية الإذن إذا كنت تصل إلى النص البرمجي كتطبيق ويب يتم تشغيله باستخدام هوية مستخدم مالك النص البرمجي.

إبطال أذونات الوصول

لإلغاء إذن وصول نص برمجي إلى بياناتك، اتّبِع الخطوات التالية:

1. انتقِل إلى صفحة الأذونات لحسابك على Google. (للانتقال إلى هذه الصفحة في المستقبل، يُرجى الانتقال إلى Google.com، ثم النقر على صورة حسابك في أعلى يسار الشاشة. بعد ذلك، انقر على حسابي، ثم على التطبيقات والمواقع الإلكترونية المرتبطة ضمن قسم "تسجيل الدخول والأمان"، ثم على إدارة التطبيقات.)
2. انقر على اسم النص البرمجي الذي تريد إلغاء تفويضه، ثم انقر على إزالة على يسار الصفحة، ثم على حسنًا في مربّع الحوار الناتج.

أذونات النصوص البرمجية وأنواعها

تختلف هوية المستخدم التي يتم تنفيذ النص البرمجي بها، وبالتالي البيانات التي يمكنه الوصول إليها، استنادًا إلى السيناريو الذي يتم تنفيذ النص البرمجي فيه، كما هو موضّح في الجدول أدناه.

نطاقات التفويض اليدوي في "جداول بيانات Google" و"مستندات Google" و"العروض التقديمية من Google" و"نماذج Google"

إذا كنت بصدد إنشاء إضافة أو نص برمجي آخر يستخدم خدمة "جداول بيانات Google" أو خدمة "مستندات Google" أو خدمة "العروض التقديمية من Google" أو خدمة "نماذج Google"، يمكنك فرض أن يطلب مربع diálogo الإذن بالوصول فقط إلى الملفات التي يتم استخدام الإضافة أو النص البرمجي فيها، بدلاً من جميع جداول بيانات أو مستندات أو نماذج المستخدم. لإجراء ذلك، أدرِج التعليق التوضيحي التالي JsDoc في تعليق على مستوى الملف:

/**
 * @OnlyCurrentDoc
 */

يتوفّر تعليق توضيحي معارض، @NotOnlyCurrentDoc، إذا كان النص البرمجي يتضمّن مكتبة تحدّد @OnlyCurrentDoc، ولكن النص البرمجي الرئيسي يتطلّب الوصول إلى أكثر من الملف الحالي.

دورة حياة التفويض في الإضافات

الإضافات لكل من "جداول بيانات Google" و"مستندات Google" و"العروض التقديمية من Google" و"نماذج Google" تتبع بشكل عام نموذج التفويض نفسه المستخدَم في النصوص البرمجية التي يتم ربطها بمستند. في بعض الظروف، يتم تشغيل الدوالّ onOpen(e) وonEdit(e) في وضع عدم التفويض الذي يقدّم بعض التعقيدات الإضافية. لمزيد من المعلومات، يمكنك الاطّلاع على دليل دورة حياة تفويض الإضافات.

الحدود القصوى لعدد مستخدمي تطبيق OAuth

تخضع التطبيقات التي تستخدم بروتوكول OAuth للوصول إلى بيانات مستخدمي Google، بما في ذلك مشروعات Apps Script، لحدود التفويض. اطّلِع على الحدود القصوى لعدد مستخدمي تطبيقات OAuth للحصول على التفاصيل.