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

project.create

النتائج: يمكنك إنشاء مشروع أساسي فارغ بدون ملفات مشاريع وبيان مشروع تلقائي.

الخيارات: يمكنك تقديم عنوان المشروع. يمكنك أيضًا إنشاء نص برمجي مرتبط من خلال توفير معرّف Google Drive لملف "مستندات Google" أو "جداول بيانات Google" أو "نماذج Google" أو "العروض التقديمية من Google" ليكون مصدر النص البرمجي.

project.get

النتائج: يؤدي هذا الإجراء إلى استرداد عنصر Project الذي يمثّل البيانات الوصفية للمشروع. تتضمن هذه البيانات عنوان المشروع ورقم تعريف النص البرمجي وإنشاء المستخدم ووقت الإنشاء وغيرها من التفاصيل.

project.getContent

النتائج: تعرض صفيفًا من عناصر File، عنصر لكل رمز وملف HTML في المشروع. تتضمّن القائمة أيضًا بيان المشروع على شكل ملف JSON. تحتوي كائنات الملف على المحتوى المصدر للملف (File.source) وبيانات وصفية أخرى، مثل قائمة الدوال في الملف (File.functionSet).

الخيارات: يمكنك تحديد نسخة المحتوى التي تريد استردادها باستخدام مَعلمة طلب بحث.

project.updateContent

النتائج: تغيير محتوى الملف في مشروع نص برمجي يمكنك تقديم المحتوى الجديد كمصفوفة من عناصر File. يجب أن يكون أحد كائنات File هذه من نوع JSON وأن يمثّل بيان المشروع الجديد لمشروع النص البرمجي. ويتم تخزين المحتوى الجديد كإصدار head للمشروع. ويتم استخدامه عند تنفيذ النص البرمجي كمشغّل، أو في أداة تعديل النصوص البرمجية، أو في وضع معاينة الإضافة، أو كتطبيق ويب أو واجهة برمجة التطبيقات لبرمجة التطبيقات في وضع التطوير.

ملاحظة: عند تعديل محتوى مشروع النصوص البرمجية، من الممارسات الشائعة أولاً إصدار طلب project.getContent لاسترداد مصفوفة من Files الحالية، ثم الرغبة في تنفيذ هذه العناصر، ثم استخدام Files كإدخال لطلب project.updateContent.

تحذير: يحل المحتوى الجديد محل جميع الملفات الحالية في مشروع النصوص البرمجية. وتتم إزالة الملفات التي لم يتم تعديلها بناءً على الطلب.

project.getMetrics

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

الخيارات: يمكنك حصر النتائج بعمليات نشر أو وظائف نصوص برمجية محدَّدة باستخدام MetricsFilter. يمكنك أيضًا تحديد فاصل زمني لمقياس محدّد باستخدام MetricsIntervalConfig.