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