تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
يوفّر هذا القسم نظرة عامة على طرق Apps Script API
التي يمكنك استخدامها لإنشاء مشاريع Apps Script وقراءتها وتعديلها
ومراقبتها. تعرض صفحة نماذج
إدارة المشاريع
أمثلة على طلبات إدارة واجهة برمجة التطبيقات. تقدّم مستندات المراجع
الخاصة بكل طريقة تفاصيل التنفيذ.
النتائج: يمكنك إنشاء مشروع أساسي فارغ بدون ملفات
مشروع وبيان مشروع تلقائي.
الخيارات: يمكنك تقديم عنوان للمشروع. يمكنك أيضًا
إنشاء نص برمجي مرتبط من خلال
تقديم رقم تعريف Google Drive لملف "مستندات Google" أو "جداول بيانات Google" أو "نماذج Google" أو "العروض التقديمية من Google"
ليكون العنصر الرئيسي للنص البرمجي.
النتائج: تسترجع عنصر
Project
، الذي يمثّل البيانات الوصفية للمشروع. وتشمل هذه البيانات
عنوان المشروع ومعرّف النصوص البرمجية والمستخدم الذي أنشأه ووقت الإنشاء وغيرها من
التفاصيل.
النتائج: تعرض صفيفًا من عناصر
File
، عنصر واحد لكل رمز وملف HTML في المشروع. تتضمّن القائمة أيضًا
بيان المشروع
بتنسيق ملف JSON. تحتوي عناصر الملفات على محتوى الملف المصدر
(File.source) والبيانات الوصفية الأخرى، مثل قائمة الدوالّ
في الملف (File.functionSet).
الخيارات: يمكنك تحديد
الإصدار من المحتوى الذي تريد
استرجاعه باستخدام مَعلمة طلب بحث.
النتائج: لتغيير محتوى الملف في مشروع نصي
يمكنك تقديم المحتوى الجديد كصفيف من عناصر
File. يجب أن يكون أحد عناصر File هذه من النوع JSON
وأن يمثّل
بيان المشروع الجديد لمشروع النص البرمجي. يتم تخزين المحتوى الجديد
كإصدار HEAD للمشروع. ويتم استخدامه عند
تنفيذ النص البرمجي كمشغِّل، في أداة تعديل النصوص البرمجية، في وضع معاينة
الإضافة، أو كتطبيق ويب أو واجهة برمجة تطبيقات Apps Script في وضع التطوير.
ملاحظة: عند تعديل محتوى مشروع النصوص البرمجية، من الشائع
أن يتم أولاً إرسال طلب
projects.getContent
لاسترداد صفيف من File الحالية،
وإجراء التغييرات المطلوبة على هذه العناصر، ثم استخدام File كأحد
مدخلات طلب
projects.updateContent.
تحذير: يستبدل المحتوى الجديد كل
الملفات الحالية في مشروع النصوص البرمجية. تتم إزالة الملفات التي لم يتم تعديلها من خلال الطلب.
النتائج: يمكنك الاطّلاع على مقاييس معيّنة عن مشروع معيّن.
وتشمل هذه المقاييس عدد المستخدِمين وإجمالي عدد
عمليات التنفيذ وإجمالي عدد أخطاء التنفيذ وتفاصيل أخرى.
استخدِم
MetricType
لتحديد المعلومات التي تطلبها.
الخيارات: يمكنك حصر النتائج بعمليات نشر معيّنة
أو دوال نصوص برمجية باستخدام
MetricsFilter.
يمكنك أيضًا تحديد فاصل زمني محدّد للمقياس باستخدام
MetricsIntervalConfig.
تاريخ التعديل الأخير: 2025-05-08 (حسب التوقيت العالمي المتفَّق عليه)
[[["يسهُل فهم المحتوى.","easyToUnderstand","thumb-up"],["ساعَدني المحتوى في حلّ مشكلتي.","solvedMyProblem","thumb-up"],["غير ذلك","otherUp","thumb-up"]],[["لا يحتوي على المعلومات التي أحتاج إليها.","missingTheInformationINeed","thumb-down"],["الخطوات معقدة للغاية / كثيرة جدًا.","tooComplicatedTooManySteps","thumb-down"],["المحتوى قديم.","outOfDate","thumb-down"],["ثمة مشكلة في الترجمة.","translationIssue","thumb-down"],["مشكلة في العيّنات / التعليمات البرمجية","samplesCodeIssue","thumb-down"],["غير ذلك","otherDown","thumb-down"]],["تاريخ التعديل الأخير: 2025-05-08 (حسب التوقيت العالمي المتفَّق عليه)"],[[["This section outlines Apps Script API methods for managing Apps Script projects, including creating, reading, updating, and monitoring."],["You can create new projects, retrieve project metadata and content, and update project files using these methods."],["The API allows you to access project metrics like user count, executions, and errors for analysis."],["Refer to the provided links for detailed documentation and code samples on project management requests."]]],[]]
