تتيح لك واجهة برمجة التطبيقات "برمجة تطبيقات Google" تنفيذ عمليات إنشاء النصوص البرمجية وإدارتها وتنفيذها آليًا في "برمجة تطبيقات Google". يمكنك إنشاء مشاريع "برمجة تطبيقات Google" وتعديلها ونشرها آليًا، وتنفيذ وظائف "برمجة تطبيقات Google" عن بُعد، وهي إجراءات تتطلّب عادةً استخدام محرّر "برمجة تطبيقات Google" أو واجهة المستخدم الخاصة به.
تُستخدَم واجهة برمجة التطبيقات هذه غالبًا لإجراء ما يلي:
- إنشاء مشاريع وعمليات نشر في "برمجة تطبيقات Google" وإدارتها
- إضافة دوال أو تعديلها في مشاريع البرامج النصية
- تنفيذ دوال برمجة تطبيقات من تطبيقات أخرى
- مراقبة سجلّات تنفيذ النصوص البرمجية وحالاتها
تستبدل واجهة برمجة التطبيقات Apps Script API واجهة برمجة التطبيقات Apps Script Execution API وتوسّع نطاقها. يمكنك استخدام Apps Script API لتنفيذ دوال Apps Script عن بُعد، تمامًا كما كان بإمكانك إجراء ذلك باستخدام Execution API.
لاستخدام واجهة برمجة التطبيقات هذه في تطبيقاتك، يجب تفعيلها.
للسماح للتطبيقات الأخرى بإدارة نصوصك البرمجية، عليك منحها إذن الوصول.
نظرة عامة على واجهة برمجة التطبيقات
تنقسم واجهة برمجة التطبيقات Apps Script إلى عدة موارد، لكل منها غرض محدّد ومجموعة من الطلبات التي يمكنك إرسالها. وفي ما يلي هذه المراجع:
-
projects: تمثّل هذه السمة مشروع نص برمجي. توفّر واجهة برمجة التطبيقات طرقًا لإنشاء المشاريع وقراءتها ومراقبتها وتعديلها. استخدِم هذا المرجع لإدارة ملفات النصوص البرمجية والبيانات الوصفية الخاصة بمشروعك. projects.deploymentsتمثّل هذه السمة عملية نشر نص برمجي. توفّر واجهة برمجة التطبيقات طرقًا لإنشاء عمليات نشر مشاريع البرامج النصية وإدراجها وتعديلها وحذفها. استخدِم عمليات النشر لإتاحة النص البرمجي كتطبيق ويب أو إضافة أو ملف تنفيذي.projects.versions— تمثيل لإصدار مشروع نص برمجي. توفّر واجهة برمجة التطبيقات طرقًا لإنشاء إصدارات المشاريع وقراءتها. استخدِم الإصدارات لتتبُّع التكرارات المختلفة لمشروع النص البرمجي.-
processes: تمثّل عملية تنفيذ دالة نصية برمجية. توفّر واجهة برمجة التطبيقات طرقًا لعرض العمليات الحالية وجمع معلومات عنها، مثل النوع والحالة الحالية. استخدِم هذا المرجع لمراقبة عمليات تنفيذ النصوص البرمجية التي تم بدؤها باستخدام الطريقةscripts.run. scripts: نقطة النهاية التي توفّر طرقًا لتنفيذ دوال "برمجة تطبيقات Google" عن بُعد. استخدِم هذا المرجع لتشغيل الدوال في مشروع النص البرمجي من تطبيقك.