إدارة المشاريع

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

نظرة عامة على طريقة واجهة برمجة التطبيقات
إنشاء مشاريع	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 من المشروع. يتم استخدامها عندما يتم تنفيذ النص البرمجي كمشغّل أو في أداة تعديل النصوص البرمجية أو في وضع معاينة إضافة Google Workspace أو كتطبيق ويب أو واجهة برمجة تطبيقات "برمجة تطبيقات Google" في وضع التطوير. ملاحظة: لتعديل محتوى مشروع نص برمجي، عليك أولاً إرسال طلب projects.getContent لاسترداد مصفوفة من عناصر File الحالية، وإجراء التغييرات المطلوبة على هذه العناصر، ثم استخدام عناصر File كمدخل لطلب projects.updateContent. تحذير: يحل المحتوى الجديد محل جميع الملفات الحالية في مشروع البرنامج النصي. تتم إزالة الملفات التي لم يتم تعديلها من خلال الطلب.
قراءة مقاييس المشروع	projects.getMetrics النتائج: قراءة مقاييس معيّنة حول مشروع وتشمل هذه المقاييس عدد المستخدمين وإجمالي عدد عمليات التنفيذ وإجمالي عدد أخطاء التنفيذ وتفاصيل أخرى. استخدِم MetricType لتحديد المعلومات التي تطلبها. الخيارات: تقييد النتائج على عمليات نشر معيّنة أو دوال برمجية باستخدام MetricsFilter يمكنك أيضًا تحديد فاصل زمني معيّن للمقاييس باستخدام MetricsIntervalConfig.