تتطلب "برمجة التطبيقات" تفويض المستخدم للوصول إلى البيانات الخاصة من خدمات Google المضمَّنة أو خدمات Google المتقدِّمة.
منح حقوق الوصول
يحدد "برمجة التطبيقات" نطاقات التفويض (مثل الوصول إلى ملفات "جداول بيانات Google" أو Gmail) تلقائيًا، استنادًا إلى فحص للرمز. لا يزال بإمكان الرمز الذي تم التعليق عليه إنشاء طلب تفويض. إذا كان النص البرمجي يحتاج إلى تفويض، فسيظهر لك أحد مربعات حوار التفويض هنا عند تشغيله.
كما تطلب النصوص البرمجية التي سمحت بها من قبل إذنًا إضافيًا إذا أدى تغيير الشفرة إلى إضافة خدمات جديدة. قد لا تطلب النصوص البرمجية تفويضًا في حالة الدخول إلى النص البرمجي كتطبيق ويب يتم تشغيله ضمن هوية المستخدم لمالك النص البرمجي.
إلغاء حقوق الدخول
لإبطال وصول أحد النصوص البرمجية إلى بياناتك، اتبع الخطوات التالية:
- انتقل إلى صفحة الأذونات لحسابك في Google. (للانتقال إلى هذه الصفحة في المستقبل، انتقل إلى Google.com، ثم انقر على صورة حسابك في الجانب العلوي الأيسر من الشاشة. بعد ذلك، انقر على حسابي، ثم التطبيقات والمواقع المرتبطة ضمن قسم "تسجيل الدخول والأمان"، ثم إدارة التطبيقات.)
- انقر على اسم النص البرمجي الذي تريد إبطال التفويض، ثم انقر على إزالة في الجانب الأيسر، ثم على موافق في مربع الحوار الناتج.
الأذونات وأنواع النصوص البرمجية
تختلف هوية المستخدم التي يعمل معها النص البرمجي - وبالتالي البيانات التي يمكنه الوصول إليها - استنادًا إلى السيناريو الذي يتم تشغيل النص البرمجي فيه، كما هو موضح في الجدول أدناه.
| نوع النص البرمجي | يعمل النص البرمجي كـ... |
|---|---|
| مستقل أو إضافة أو مرتبط بـ "مستندات 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 للحصول على التفاصيل.