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

يقدّم هذا القسم نظرة عامة على طرق 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.