تتطلب برمجة التطبيقات تفويض المستخدم للوصول إلى البيانات الخاصة من خدمات Google المضمَّنة خدمات Google المتقدّمة.
منح حقوق الوصول
![](https://developers.google.cn/static/apps-script/images/new-auth-1.png?authuser=19&hl=ar)
![](https://developers.google.cn/static/apps-script/images/new-auth-2.png?authuser=19&hl=ar)
تحدّد "برمجة التطبيقات" نطاقات الأذونات (مثل الوصول إلى "جداول بيانات Google" أو Gmail) تلقائيًا، بناءً على مسح الرمز ضوئيًا. التعليمة البرمجية التي التي تم التعليق عليها من إنشاء طلب تفويض. إذا كان النص البرمجي يحتاج سيظهر لك أحد مربعات حوار التفويض التي تظهر هنا عندما الجري.
إنّ النصوص البرمجية التي سمحت لها في السابق تطلب أيضًا المزيد من التفويض إذا أدى تغيير الرمز إلى إضافة خدمات جديدة. قد لا تطلب النصوص البرمجية إذا قمت بالوصول إلى النص البرمجي كتطبيق ويب يعمل ضمن هوية المستخدم لمالك النص البرمجي.
إبطال حقوق الوصول
لإبطال وصول نص برمجي إلى بياناتك، اتبع الخطوات التالية:
- انتقل إلى الأذونات لحسابك على Google. (للانتقال إلى هذه الصفحة في المستقبل، انتقِل إلى Google.com، ثم انقر على صورة الحساب في أعلى يسار الشاشة. بعد ذلك، انقر على حسابي، ثم التطبيقات المرتبطة المواقع ضمن "تسجيل الدخول الأمان" ، ثم إدارة التطبيقات).
- انقر على اسم النص البرمجي الذي تريد إبطال تفويضه، ثم انقر على إزالة على اليسار، ثم على حسنًا في مربّع الحوار الناتج.
الأذونات وأنواع النصوص البرمجية
هوية المستخدم التي يعمل بها النص البرمجي - وبالتالي البيانات التي يمكنه الوصول إليها - بناءً على السيناريو الذي يتم فيه تشغيل النص البرمجي، كما هو موضح في الجدول أدناه.
نوع النص البرمجي | يتم تشغيل النص البرمجي باسم... |
---|---|
مستقلة ميزة إضافية مرتبط بـ "مستندات Google" أو "جداول بيانات Google" أو "العروض التقديمية من Google" أو "نماذج Google" | مستخدم على لوحة المفاتيح |
دالة مخصّصة في جدول بيانات | مستخدم مجهول: ومع ذلك، تفرض حدود الحصص العد مقابل المستخدم في لوحة المفاتيح |
تطبيق الويب أو أداة "مواقع Google" | يعتمد المستخدم في لوحة المفاتيح أو مالك النص البرمجي على الخيارات المحدّدة عند نشر التطبيق |
مشغِّل قابل للتثبيت | المستخدم الذي أنشأ المشغّل |
نطاقات التفويض اليدوي في "جداول بيانات Google" و"مستندات Google" و"العروض التقديمية من Google" و"نماذج Google"
إذا كنت تنشئ إضافة أو نص برمجي آخر خدمة جداول البيانات، خدمة المستندات، خدمة "العروض التقديمية من Google" خدمة "نماذج Google"، يمكنك فرض التفويض. لطلب الوصول إلى الملفات التي تستخدم فيها الوظيفة الإضافية أو البرنامج النصي فقط، بدلاً من كل جداول البيانات أو المستندات أو النماذج الخاصة بالمستخدم. للقيام بذلك، قم بتضمين التعليق التوضيحي التالي JsDoc في تعليق على مستوى الملف:
/**
* @OnlyCurrentDoc
*/
يتوفّر التعليق التوضيحي المتناقض "@NotOnlyCurrentDoc
" إذا كان النص البرمجي الخاص بك متوفرًا.
يتضمن مكتبة توضح
@OnlyCurrentDoc
، لكن النص البرمجي الرئيسي يتطلب في الواقع الوصول إلى أكثر من
الملف الحالي.
دورة حياة التفويض للإضافات
إضافات "جداول بيانات Google" و"مستندات Google" و"العروض التقديمية من Google" و"نماذج Google"
عادةً ما تتبع نموذج التفويض نفسه الذي تتبعه النصوص البرمجية التي
ربط بمستند. إلى حد ما
في المقابل، يتم تشغيل الدالتين onOpen(e)
وonEdit(e)
في
بدون تفويض يعرض بعض الإضافات الإضافية. لمزيد من المعلومات،
المعلومات، فراجع
إلى دورة حياة تفويض الإضافات.
حدود مستخدم تطبيق OAuth
التطبيقات التي تستخدم OAuth للوصول إلى بيانات مستخدم Google، بما في ذلك التطبيقات تخضع مشاريع النصوص البرمجية لحدود الأذونات. عرض حدود مستخدم تطبيق OAuth لمزيد من التفاصيل.