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

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

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

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

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

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

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

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

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

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

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

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

/**
 * @OnlyCurrentDoc
 */

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

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

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

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

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