إدارة المشروعات

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

نظرة عامة على طريقة واجهة برمجة التطبيقات
إنشاء مشاريع	projects.create النتائج: يمكنك إنشاء مشروع أساسي فارغ بدون ملفات مشروع وبيان مشروع تلقائي. الخيارات: يمكنك تقديم عنوان للمشروع. يمكنك أيضًا إنشاء نص برمجي مرتبط من خلال تقديم رقم تعريف Google Drive لملف "مستندات Google" أو "جداول بيانات Google" أو "نماذج Google" أو "العروض التقديمية من Google" ليكون العنصر الرئيسي للنص البرمجي.
قراءة البيانات الوصفية للمشروع	projects.get النتائج: تسترجع عنصر Project ، الذي يمثّل البيانات الوصفية للمشروع. وتشمل هذه البيانات عنوان المشروع ومعرّف النصوص البرمجية والمستخدم الذي أنشأه ووقت الإنشاء وغيرها من التفاصيل.
قراءة محتوى المشروع	projects.getContent النتائج: تعرض صفيفًا من عناصر File ، عنصر واحد لكل رمز وملف HTML في المشروع. تتضمّن القائمة أيضًا بيان المشروع بتنسيق ملف JSON. تحتوي عناصر الملفات على محتوى الملف المصدر (File.source) والبيانات الوصفية الأخرى، مثل قائمة الدوالّ في الملف (File.functionSet). الخيارات: يمكنك تحديد الإصدار من المحتوى الذي تريد استرجاعه باستخدام مَعلمة طلب بحث.
تعديل محتوى المشروع	projects.updateContent النتائج: لتغيير محتوى الملف في مشروع نصي يمكنك تقديم المحتوى الجديد كصفيف من عناصر File. يجب أن يكون أحد عناصر File هذه من النوع JSON وأن يمثّل بيان المشروع الجديد لمشروع النص البرمجي. يتم تخزين المحتوى الجديد كإصدار HEAD للمشروع. ويتم استخدامه عند تنفيذ النص البرمجي كمشغِّل، في أداة تعديل النصوص البرمجية، في وضع معاينة الإضافة، أو كتطبيق ويب أو واجهة برمجة تطبيقات Apps Script في وضع التطوير. ملاحظة: عند تعديل محتوى مشروع النصوص البرمجية، من الشائع أن يتم أولاً إرسال طلب projects.getContent لاسترداد صفيف من File الحالية، وإجراء التغييرات المطلوبة على هذه العناصر، ثم استخدام File كأحد مدخلات طلب projects.updateContent. تحذير: يستبدل المحتوى الجديد كل الملفات الحالية في مشروع النصوص البرمجية. تتم إزالة الملفات التي لم يتم تعديلها من خلال الطلب.
قراءة مقاييس المشروع	projects.getMetrics النتائج: يمكنك الاطّلاع على مقاييس معيّنة عن مشروع معيّن. وتشمل هذه المقاييس عدد المستخدِمين وإجمالي عدد عمليات التنفيذ وإجمالي عدد أخطاء التنفيذ وتفاصيل أخرى. استخدِم MetricType لتحديد المعلومات التي تطلبها. الخيارات: يمكنك حصر النتائج بعمليات نشر معيّنة أو دوال نصوص برمجية باستخدام MetricsFilter. يمكنك أيضًا تحديد فاصل زمني محدّد للمقياس باستخدام MetricsIntervalConfig.