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