تفعيل تفويض النص البرمجي والوصول إليه

تتطلّب واجهة برمجة التطبيقات لبرمجة التطبيقات أنواعًا مختلفة من التفويضات بناءً على هدفك:

  • يمكنك استخدام واجهة برمجة التطبيقات لبرمجة التطبيقات في تطبيقك.
  • يمكنك السماح للتطبيقات الأخرى بإدارة بيانات مشروع النصوص البرمجية أو عمليات النشر.

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

إذا كنت تريد السماح للتطبيقات التابعة لجهات خارجية بإدارة محتوى مشاريع النصوص البرمجية أو نشرها، عليك منح إمكانية الوصول إلى مشاريع النصوص البرمجية.

استخدام واجهة برمجة التطبيقات لبرمجة التطبيقات في تطبيقك

إذا أردت استخدام واجهة برمجة التطبيقات لبرمجة التطبيقات داخل تطبيقك، عليك تفعيل واجهة برمجة التطبيقات لبرمجة التطبيقات في مشروع Google Cloud Platform لتطبيقك. بعد تفعيل واجهة برمجة التطبيقات لبرمجة التطبيقات، يمكنك إنشاء بيانات اعتماد OAuth وتنزيل معرِّف العميل والمفتاح السرّي لتضمينهما في تطبيقك. يمكنك أيضًا مراقبة استخدام واجهة برمجة التطبيقات في Google Cloud Console.

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

توفر البدءات السريعة لواجهة برمجة التطبيقات لبرمجة التطبيقات نظرة تفصيلية على كامل عملية تفعيل واجهة برمجة التطبيقات وإعداد التفويض لأحد التطبيقات.

منح التطبيقات التابعة لجهات خارجية إذن الوصول إلى مشاريع النصوص البرمجية

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

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

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

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

قبل منح إذن الوصول، تأكَّد من أنّك تدرك أنّ السماح للتطبيقات بتعديل نصوصك البرمجية قد يتضمّن مخاطر. لا تفوِّض أي تطبيق تشك في أنه ضارّ