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

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

نظرة عامة على طريقة واجهة برمجة التطبيقات
إنشاء مشاريع

projects.create

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

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

قراءة البيانات الوصفية للمشروع

projects.get

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

قراءة محتوى المشروع

projects.getContent

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

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

تعديل محتوى المشروع

projects.updateContent

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

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

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

قراءة مقاييس المشروع

projects.getMetrics

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

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