إدارة المشروعات
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
يقدّم هذا القسم نظرة عامة على طرق 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.
|
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-08-31 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-08-31 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eThis section outlines Apps Script API methods for managing Apps Script projects, including creating, reading, updating, and monitoring.\u003c/p\u003e\n"],["\u003cp\u003eYou can create new projects, retrieve project metadata and content, and update project files using these methods.\u003c/p\u003e\n"],["\u003cp\u003eThe API allows you to access project metrics like user count, executions, and errors for analysis.\u003c/p\u003e\n"],["\u003cp\u003eRefer to the provided links for detailed documentation and code samples on project management requests.\u003c/p\u003e\n"]]],[],null,["# Managing Projects\n\nThis section provides an overview of the Apps Script API methods\nyou can use to create, read, modify,\nand monitor your Apps Script projects. The\n[Project Management](/apps-script/api/samples/manage)\nsamples page shows examples of API management requests. The reference\ndocumentation for each method provides implementation details.\n\n| **API method overview** ||\n|----------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| **Create projects** | [projects.create](/apps-script/api/reference/rest/v1/projects/create) **Results** : Create a basic, empty project with no project files and a default [project manifest](/apps-script/concepts/manifests). **Options** : You can provide a project title. You can also create a [bound script](/apps-script/guides/bound) by providing the Google Drive ID of a Google Docs, Google Sheets, Google Forms, or Slides file to act as the script's parent. |\n| **Read project metadata** | [projects.get](/apps-script/api/reference/rest/v1/projects/get) **Results** : Retrieves a [`Project`](/apps-script/api/reference/rest/v1/projects#Project) object, which represents project metadata. This data includes the project title, script ID, creating user, creation time, and other details. |\n| **Read project content** | [projects.getContent](/apps-script/api/reference/rest/v1/projects/getContent) **Results** : Returns an array of [`File`](/apps-script/api/reference/rest/v1/File) objects, one for each code and HTML file in the project. The list also includes the [project manifest](/apps-script/concepts/manifests) as a JSON file. File objects contain the source content of the file (`File.source`) and other metadata, such a list of functions in the file (`File.functionSet`). **Options** : You can specify which [version](/apps-script/guides/versions) of the content to retrieve with a query parameter. |\n| **Update project content** | [projects.updateContent](/apps-script/api/reference/rest/v1/projects/updateContent) **Results** : Changes the file content in a script project. You provide the new content as an array of [`File`](/apps-script/api/reference/rest/v1/File) objects. One of these `File` objects must have JSON type and represent the script project's new [project manifest](/apps-script/concepts/manifests). The new content is stored as the HEAD version of the project. It is used when the script executes as a trigger, in the script editor, in add-on preview mode, or as a web app or Apps Script API in development mode. **Note** : When updating script project content, common practice is to first issue a [projects.getContent](/apps-script/api/reference/rest/v1/projects/getContent) request to retrieve an array of the existing `File`s, make the desire to those objects, then use the `File`s as input for a [projects.updateContent](/apps-script/api/reference/rest/v1/projects/updateContent) request. **Warning:** The new content replaces all existing files in the script project. Files not updated by the request are removed. |\n| **Read project metrics** | [projects.getMetrics](/apps-script/api/reference/rest/v1/projects/getMetrics) **Results** : Read certain metrics about a project. These metrics include the number of users, the total number of executions, the total number of execution errors, and other details. Use a [MetricType](/apps-script/api/reference/rest/v1/projects/getMetrics#metrictype) to specify the information you are requesting. **Options** : Restrict the results to specific deployments or script functions using a [MetricsFilter](/apps-script/api/reference/rest/v1/projects/getMetrics#MetricsFilter). You can also define a specific metric interval using a [MetricsIntervalConfig](/api/reference/rest/v1/projects/getMetrics#metricsintervalconfig). |"]]
