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

تتطلّب "برمجة التطبيقات" الحصول على إذن من المستخدم للوصول إلى البيانات الخاصة من خدمات Google المدمجة أو خدمات Google المتقدّمة.

منح حقوق الوصول

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

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

إبطال حقوق الوصول

لإبطال وصول أحد النصوص البرمجية إلى بياناتك، اتبع الخطوات التالية:

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

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

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

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

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

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

/**
 * @OnlyCurrentDoc
 */

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

مراحل نشاط التفويض للإضافات

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

حدود مستخدمي تطبيقات OAuth

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