تتطلّب Apps Script API أنواعًا مختلفة من الأذونات استنادًا إلى هدفك:
- استخدِم Apps Script API في تطبيقك.
- السماح للتطبيقات الأخرى بإدارة بيانات مشروع النصوص البرمجية أو عمليات النشر
إذا كنت بحاجة إلى استخدام Apps Script API في تطبيقك، عليك تفعيل واجهة برمجة التطبيقات في مشروع Google Cloud الخاص بالتطبيق. يتيح لك ذلك إنشاء بيانات اعتماد OAuth ليتمكّن مستخدمو التطبيق من تفويضها.
إذا أردت السماح للتطبيقات التابعة لجهات خارجية بإدارة المحتوى أو عملية النشر لمشاريع النصوص البرمجية، عليك منح إذن الوصول إلى مشاريع النصوص البرمجية.
استخدام Apps Script API في تطبيقك
إذا كنت تريد استخدام واجهة برمجة التطبيقات Apps Script API داخل تطبيقك، عليك تفعيل واجهة برمجة التطبيقات Apps Script API في مشروع تطبيقك على Google Cloud Platform. بعد تفعيل Apps Script API، يمكنك إنشاء بيانات اعتماد OAuth وتنزيل معرّف العميل وسرّه لتضمينهما في تطبيقك. يمكنك أيضًا مراقبة استخدام واجهة برمجة التطبيقات في وحدة تحكّم Google Cloud.
يمكنك استخدام هذا المعالج لإنشاء مشروع على Google Cloud أو اختياره في وحدة تحكّم واجهة برمجة التطبيقات وتفعيل واجهة برمجة التطبيقات تلقائيًا. بدلاً من ذلك، يمكنك فتح صفحة إدارة الموارد في وحدة التحكّم، واختيار مشروع، ثم البحث عن Apps Script API وإضافتها يدويًا باستخدام لوحة بيانات واجهات برمجة التطبيقات والخدمات للمشروع. بعد تفعيل واجهة برمجة التطبيقات، يمكنك إنشاء بيانات اعتماد OAuth ومعرّفات العملاء وأسرار العملاء لتطبيقاتك في لوحة واجهات برمجة التطبيقات والخدمات > بيانات الاعتماد.
تقدّم عمليات البدء السريع لواجهة برمجة التطبيقات لتطبيقات Google Script نظرة تفصيلية على العملية الكاملة لتفعيل واجهة برمجة التطبيقات وإعداد التفويض لتطبيق معيّن.
منح التطبيقات التابعة لجهات خارجية إذن الوصول إلى مشاريع النصوص البرمجية
يمكن أن تسمح واجهة برمجة التطبيقات لـ Apps Script للتطبيقات بإنشاء النصوص البرمجية وعمليات نشرها وتعديلها. يمكن أن يؤدي ذلك إلى وضع سيئ إذا فوّضْت تطبيقًا ضارًا تابعًا لجهة خارجية والذي يواصل بعد ذلك إنشاء المزيد من النصوص البرمجية الضارة أو تعديل سلوك النصوص البرمجية التي لديك.
للمساعدة في الحد من هذه المخاطرة، لا يمكن لواجهة برمجة التطبيقات Apps Script API الوصول إلى مشاريع ملفّات برمجة التطبيقات تلقائيًا. يجب منح واجهة برمجة التطبيقات إذن الوصول بشكل صريح قبل أن تتمكّن من استخدام أي تطبيق ينشئ نصوصًا برمجية أو عمليات نشر أو يعدّلها. بعد منح واجهة برمجة التطبيقات إذن الوصول إلى نصوصك البرمجية، يمكن للتطبيقات التي تمنحها الإذن استخدام واجهة برمجة التطبيقات لإدارة مشاريع النصوص البرمجية.
سيحدث خطأ إذا حاولت تشغيل تطبيق متأثر بدون منح إذن الوصول إلى واجهة برمجة التطبيقات أولاً. يحدث هذا الخطأ بعد تفويض التطبيق.
يمكنك منح واجهة برمجة التطبيقات "لبرمجة التطبيقات" إذن الوصول إلى مشاريع النصوص البرمجية باستخدام لوحة بيانات برمجة التطبيقات. يمكنك أيضًا استخدام لوحة البيانات لإبطال إذن الوصول هذا في أي وقت. عند منح الإذن بالوصول إلى واجهة برمجة التطبيقات، يعني ذلك أنّك تمنح الإذن لجميع التطبيقات. ومع ذلك، يجب منح الإذن للتطبيقات الفردية.
قبل منح الإذن بالوصول، تأكَّد من أنّك تدرك أنّ هناك مخاطر متعلّقة بالسماح للتطبيقات بتعديل نصوصك البرمجية. لا تمنح الإذن لأي تطبيق تعتقد أنّه ضار.