توفّر "برمجة التطبيقات" بعض الميزات التي تساعدك أنت والمطوّرين الآخرين في إنشاء النصوص البرمجية والإضافات وتطبيقات الويب معًا وصيانتها.
أساسيات التعاون
للتعاون في مشروع، يجب أن يكون لديك أنت والمتعاونون معك إذن الوصول كمحرّرين إلى ملف مشروع Apps Script (والحاوية الخاصة به، إذا كان نصًا برمجيًا مرتبطًا). يتيح ذلك لجميع أعضاء فريقك الاطّلاع على رمز Apps Script وإجراء تغييرات عليه. يمكن للمحرّرين أيضًا إنشاء إصدارات جديدة من الرموز البرمجية ونشر الإضافات وتفعيل النصوص البرمجية كتطبيقات ويب أو كملفات تنفيذية لواجهة برمجة التطبيقات Apps Script API.
يمكنك مساعدة فريقك من خلال التخطيط مسبقًا لكيفية التعامل مع التعديل والمراجعة وإدارة الإصدارات والنشر (إذا كان ذلك منطبقًا) لمشروعك أو إضافتك أو تطبيقك على الويب. عادةً ما تكون المشاريع المستقلة هي الأسهل في التعاون، لأنّها تظهر مباشرةً في Google Drive وهي نوع المشاريع المقترَح لتطوير الإضافات وتطبيقات الويب.
تحدث مشكلة شائعة في التعاون عندما يغادر مالك مشروع نص برمجي الفريق بدون نقل ملكية المشروع إلى شخص آخر في الفريق. وقد يؤدي ذلك إلى عدم قدرتك على صيانة المشروع أو تعديله. يؤدي وضع مشروع البرنامج النصي في مساحة تخزين سحابي مشتركة إلى تجنُّب هذه المشكلة، لأنّ الملفات في مساحة التخزين السحابي المشتركة لا يكون لها مالكون محدَّدون.
التعاون باستخدام أداة سطر الأوامر clasp
تتيح لك clasp مزامنة المشاريع بين script.google.com ونظام الملفات المحلي. يتيح لك ذلك تبسيط عملية تطوير التعليمات البرمجية وتنفيذها تلقائيًا إذا كنت أنت والمتعاونون معك تستخدمون برنامجًا لإدارة التحكم في رموز المصدر، مثل git.
لمزيد من التفاصيل، يُرجى الاطّلاع على دليل استخدام واجهة سطر الأوامر clasp.
التعاون باستخدام مساحات التخزين السحابي المشتركة
توفّر مساحات التخزين السحابي المشتركة (المعروفة سابقًا باسم "مساحات Drive للفريق") مساحة مشتركة في Google Drive يمكن لمجموعات من مستخدمي Drive التعاون فيها بفعالية أكبر. الملفات التي يتم وضعها في مساحة تخزين سحابي مشتركة مملوكة للمجموعة ككل، وليس للأفراد. وهذا يعني أنّه عندما يغادر أحد المتعاونين المجموعة، لن يحتفظ بملكية الملفات والتحكّم فيها.
تتيح لك مساحات التخزين السحابي المشتركة أيضًا نقل الملفات بين النطاقات، إذ يمكن أن تضم مساحة تخزين سحابي مشتركة في أحد النطاقات متعاونين من نطاق آخر يمكنهم نقل الملفات من ذلك النطاق إلى مساحة التخزين السحابي المشتركة. ويمكن أن يكون ذلك مفيدًا جدًا لمطوّري Apps Script، لأنّه يوفّر وسيلة لفريق لتطوير إضافات أو تطبيقات ويب أو رموز برمجية أخرى للعملاء في نطاقات مختلفة.
عند استخدام مساحات التخزين السحابي المشتركة للتعاون في مشاريع Apps Script، يُرجى مراعاة ما يلي:
- يمكن للمتعاونين الذين لديهم إذن وصول المحرّر إلى مساحة تخزين سحابي مشتركة إنشاء ملفات جديدة أو نقلها إلى مساحة التخزين السحابي المشتركة. بصفتهم محرِّري نصوص برمجية، يمكنهم عرض مشاريع النصوص البرمجية وتعديلها، وتشغيل رموز النصوص البرمجية، وإنشاء إصدارات جديدة من النصوص البرمجية، ونشر الإضافات.
- لنشر النصوص البرمجية كتطبيقات ويب أو ملفات تنفيذية لواجهة برمجة التطبيقات Apps Script API، يجب أن ينتمي الحساب الذي ينشئ عملية النشر إلى النطاق نفسه الذي ينتمي إليه الفريق المشارك الذي يتم تخزين النص البرمجي فيه.
- تتيح لك مساحات التخزين السحابي المشتركة مشاركة ملفات معيّنة داخل مساحة التخزين السحابي المشتركة مع مستخدمين آخرين خارج المجموعة، وتعديل أذونات التعديل والعرض لهذه الملفات كما تفعل مع أي ملف آخر في Drive. ومع ذلك، إذا كان المستخدم جزءًا من الفريق الذي تتبعه مساحة التخزين السحابي المشتركة، لا يمكنك تقليل مستوى وصوله إلى ملفات معيّنة. على سبيل المثال، إذا كان لدى مستخدم إذن تعديل في مساحة تخزين سحابي مشتركة، لا يمكنك تغيير هذا الإذن إلى إذن بالاطّلاع فقط على ملف معيّن داخل مساحة التخزين السحابي المشتركة.
- يمكن للمتعاونين الذين لديهم إذن وصول كامل إلى مساحة تخزين سحابي مشتركة حذف الملفات ومشاريع Apps Script ونقل الملفات خارج مساحة التخزين السحابي المشتركة.
- تستخدم جميع البرامج النصية المرتبطة بالحاوية قوائم أذونات الوصول نفسها الخاصة بالمشاهدين والمحرّرين والمحدّدة لملف الحاوية. على سبيل المثال، إذا كان لديك إذن بالتعديل على جدول بيانات Google، سيكون لديك أيضًا إذن بالتعديل على أي رمز مشروع في "برمجة تطبيقات Google" مرفق به. يؤدي وضع ملف حاوية من هذا النوع في مساحة تخزين سحابي مشتركة إلى منح المتعاونين في مساحة التخزين السحابي المشتركة إذن الوصول نفسه إلى رمز البرنامج النصي كما هو الحال بالنسبة إلى الحاوية نفسها.
- عندما يكون مشروع نص برمجي في مساحة تخزين سحابي مشتركة، قد يتم حظر الوصول إلى مشروع Cloud Platform (GCP). راجِع قسم دليل مشاريع Google Cloud Platform ومساحات التخزين السحابي المشتركة للحصول على التفاصيل.
- تتوقف تطبيقات الويب التي تم نشرها في نطاق واحد عن العمل إذا تم تغيير مالكها إلى مساحة تخزين مشتركة أو حساب في نطاق مختلف. يمكن تصحيح ذلك من خلال نقل النص البرمجي إلى نطاقه الأصلي.
- وبالمثل، تتوقف مشاريع النصوص البرمجية التي تم نشرها كملف تنفيذي لواجهة برمجة التطبيقات في "برمجة تطبيقات Google" عن العمل عند استدعائها من خلال واجهة برمجة التطبيقات إذا تم نقلها عبر Drive المشترك من نطاق إلى آخر. يمكن تصحيح ذلك من خلال إعادة النص البرمجي إلى نطاقه الأصلي.
التعاون باستخدام مجلد مشترك
إذا لم تتمكّن من التعاون في مساحة تخزين سحابي مشتركة، يمكنك استخدام مجلد مشترك بدلاً من ذلك. عند إنشاء مشروع "برمجة تطبيقات Google" أو نقله إلى مجلد في Google Drive يمكن للمستخدمين الآخرين الوصول إليه، سيحصلون على إذن الوصول نفسه إلى مشروع "برمجة تطبيقات Google" الذي لديهم للمجلد. على سبيل المثال:
- إذا كان لدى مستخدم الإذن بتعديل المجلد، يمكنه تعديل مشروع Apps Script أو حذفه وتشغيل النص البرمجي.
- إذا كان لدى المستخدم إذن بالاطّلاع فقط على المجلد، يمكنه الاطّلاع على مشروع "برمجة تطبيقات Google" وتشغيل البرنامج النصي.
التعاون من خلال مشاركة المشاريع
يمكنك التعاون في مشروع من خلال مشاركته مباشرةً مع جميع المتعاونين. يمكنك مشاركة مشاريع البرامج النصية مباشرةً إذا كانت موجودة في مجلدات Google Drive العادية أو في مساحات التخزين السحابي المشتركة. في حال استخدام هذه الطريقة، ننصحك بالتخطيط بعناية لتحديد الجهة المسؤولة عن ملكية النص البرمجي وصيانته بمرور الوقت.
تظهر المشاريع المستقلة في Google Drive كملف ويمكنك مشاركتها مثل أي ملف آخر. لمزيد من المعلومات، يُرجى الاطّلاع على مشاركة الملفات والمجلدات.
لا تظهر المشاريع المرتبطة بحاوية في Google Drive. لمشاركة مشروع مرتبط بحاوية، شارِك ملف الحاوية الأصل. على سبيل المثال، إذا كان لديك نص برمجي مرتبط بجدول بيانات في "جداول بيانات Google"، يمكنك منح شخص إذن التعديل على النص البرمجي من خلال منحه إذن التعديل على جدول البيانات. ترث المشاريع المرتبطة بالحاوية إعدادات أذونات الوصول إلى العارضين والمحررين الخاصة بملف الحاوية.
تستخدم جميع النصوص البرمجية المرتبطة بالحاوية قائمة الوصول نفسها الخاصة بالمالك والمشاهد والمحرّر المحدّدة لملف الحاوية. يصبح مالك الحاوية مالكًا لمشروع نص برمجي جديد بغض النظر عن الجهة التي أنشأته.
التعاون وموارد المشروع
الموارد هي كيانات مرتبطة بمشروعك ولكنها مستقلة عن رمزه. يوضّح هذا القسم كيف يؤثّر التعاون في مشروع على موارده، لا سيما مشروع Cloud Platform والمشغّلات والمكتبات وخصائص المستخدمين.
التعاون والمشاريع على Google Cloud
يتضمّن كل مشروع في "برمجة التطبيقات" مشروعًا مرتبطًا في Google Cloud. تتضمّن مشاريع Google Cloud مجموعة خاصة من المالكين والمحرّرين والأدوار الأخرى، والتي يمكن أن تختلف عن مجموعة المستخدمين الذين يمكنهم الوصول إلى مشروع النص البرمجي.
إذا كان من المفترض نشر مشروع النص البرمجي كـ إضافة، يجب أن يستخدم مشروعًا عاديًا على Google Cloud. عند التعاون في تطبيق يستخدم مشروعًا عاديًا على Google Cloud، ننصحك بضبط مالكي وأدوار Google Cloud للتأكّد من أنّ جميع المتعاونين معك لديهم مستويات الوصول المناسبة. يساعد ذلك في تجنُّب الحالات التي تفقد فيها إذن الوصول إلى إعدادات المشروع على السحابة الإلكترونية لأنّ مالكيه لم يعودوا يعملون في مؤسستك. ويكون ذلك مهمًا بشكل خاص بالنسبة إلى الإضافات.
التعاون والمشغّلات
عند التعاون في العمل على مشروع، لن تتم مشاركة أي مشغّلات قابلة للتثبيت تنشئها مع المستخدمين الذين يمكنهم الوصول إلى مشروعك. إذا كنت بحاجة إلى إعداد مشغّل متسق لجميع المتعاونين، يمكنك استخدام خدمة النصوص البرمجية لإنشاء مشغّلات آليًا في وقت التشغيل. لمزيد من المعلومات، يُرجى الاطّلاع على إدارة المشغّلات آليًا.
التعاون والمكتبات
تتوفّر المكتبات المضمّنة في مشروعك للمتعاونين في المشروع. ومع ذلك، إذا لم يكن لديهم إذن وصول على مستوى القراءة على الأقل إلى مكتبة مضمّنة، لن يتمكّنوا من استخدام هذه المكتبات، وسيعرض النص البرمجي رسالة خطأ في هذه الحالة. لمزيد من المعلومات حول المكتبات، يُرجى الاطّلاع على إدارة المكتبات.
التعاون وخصائص المستخدم
خصائص المستخدِم تكون فريدة للمستخدِم الذي أنشأها. وهذا يعني أنّ المتعاونين في المشروع لا يمكنهم الاطّلاع على خصائص المستخدمين أو الوصول إليها، ولا يمكنك الاطّلاع على خصائصهم أو الوصول إليها. استخدِم مواقع النصوص البرمجية إذا كنت تريد مشاركة مواقع خاصة بالمشروع مع المتعاونين. لمزيد من المعلومات، اطّلِع على دليل السمات.