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

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