تتطلّب "برمجة التطبيقات" الحصول على إذن من المستخدم للوصول إلى البيانات الخاصة من خدمات Google المضمّنة أو خدمات Google المتقدّمة.
منح حقوق الوصول
تحدّد "برمجة التطبيقات" نطاقات الأذونات (مثل الوصول إلى ملفات "جداول بيانات 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 للحصول على التفاصيل.