توفّر أداة "برمجة التطبيقات" بعض الميزات التي تساعدك أنت والمطوّرين الآخرين في إنشاء النصوص البرمجية والإضافات وتطبيقات الويب معًا وصيانتها.
أساسيات التعاون
للتعاون في مشروع، يجب أن يكون لديك أنت والمتعاونون معك إذن وصول المحرِّر إلى ملف مشروع 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"، سيكون لديك أيضًا إذن بتعديل أي رمز مشروع في Apps Script مرتبط به. يؤدي وضع ملف حاوية مماثل في مساحة تخزين سحابي مشتركة إلى منح المتعاونين في مساحة التخزين السحابي المشتركة إذن الوصول نفسه إلى رمز النص البرمجي الذي لديهم إلى الحاوية نفسها.
- عندما يكون مشروع نص برمجي مضمّنًا في مساحة تخزين سحابي مشتركة، قد يتم حظر الوصول إلى مشروع Cloud Platform (GCP). اطّلِع على قسم دليل مشاريع Google Cloud Platform ومساحات التخزين السحابي المشتركة لمعرفة التفاصيل.
- تتوقف تطبيقات الويب التي تم نشرها في نطاق واحد عن العمل إذا تغيّرت ملكيتها إلى حساب أو ملف شخصي مشترَك في نطاق مختلف. يمكن تصحيح ذلك من خلال نقل النص البرمجي مرة أخرى إلى نطاقه الأصلي.
- وبالمثل، تتوقف مشاريع النصوص البرمجية التي تم نشرها كملف قابل للتنفيذ في Apps Script API عن العمل عندما تطلبها واجهة برمجة التطبيقات في حال نقلها من ملف تخزين مشترَك من نطاق إلى آخر. يمكن تصحيح ذلك من خلال نقل النص البرمجي مرة أخرى إلى نطاقه الأصلي.
التعاون باستخدام مجلد مشترَك
إذا لم تتمكّن من التعاون باستخدام مساحة تخزين سحابي مشتركة، يمكنك استخدام مجلد مشترَك بدلاً من ذلك. عند إنشاء مشروع "برمجة تطبيقات Google" أو نقله إلى مجلّد في Google Drive يمكن للمستخدمين الآخرين الوصول إليه، يكتسبون إذن الوصول نفسه إلى مشروع "برمجة تطبيقات Google" الذي لديهم للمجلد. على سبيل المثال:
- إذا كان لدى أحد المستخدمين إذن الوصول للتعديل في المجلد، يمكنه تعديل مشروع "برمجة تطبيقات Google" أو حذفه وتشغيل النص البرمجي.
- إذا كان لدى مستخدم إذن بالاطّلاع فقط على المجلد، يمكنه الاطّلاع على مشروع "برمجة تطبيقات Google" وتشغيل النص البرمجي.
التعاون من خلال مشاركة المشاريع
يمكنك التعاون في مشروع من خلال مشاركته مباشرةً مع كل المتعاونين. يمكنك مشاركة مشاريع النصوص البرمجية مباشرةً التي تقع في مجلدات عادي Google Drive أو في مساحات التخزين السحابي المشتركة. إذا كنت تستخدِم هذه الطريقة، يُنصح بالتخطيط بعناية لتحديد الجهة التي تملك النص البرمجي وتحافظ عليه بمرور الوقت.
تظهر المشاريع المستقلة في Google Drive كملف، ويمكنك مشاركتها مثل أي ملف آخر. لمزيد من المعلومات، يُرجى الاطّلاع على مقالة مشاركة الملفات والمجلدات.
لا تظهر المشاريع المرتبطة بالحاويات من Google Drive. لمشاركة مشروع مرتبط بحاوية، يمكنك مشاركة ملف الحاوية родительский. على سبيل المثال، إذا كان لديك نص برمجي مرتبط بجدول بيانات في "جداول بيانات Google"، يمكنك منح إذن تعديل النص البرمجي لشخص ما من خلال منحه إذن تعديل جدول البيانات. تكتسِب المشاريع المرتبطة بالحاويات إعدادات الوصول للمشاهد والمحرِّر في ملف الحاوية.
تستخدم جميع النصوص البرمجية المرتبطة بالحاوية قائمة الوصول نفسها للمالك والمُشاهد والداعم المحدّدة لملف الحاوية. يحصل مالك الحاوية على ملكية مشروع نصي جديد بغض النظر عمن أنشأه.
التعاون وموارد المشاريع
الموارد هي كيانات مرتبطة بمشروعك ولكنها مستقلة عن رمزه. يوضّح هذا القسم كيفية تأثير التعاون في مشروع على موارده، وعلى وجه الخصوص: مشروع Cloud Platform وعوامل التفعيل والمكتبات وخصائص المستخدِمين.
التعاون ومشاريع Google Cloud
يرتبط كل مشروع من مشاريع "برمجة التطبيقات" بأحد مشاريع Google Cloud. تحتوي مشاريع Google Cloud على مجموعة من المالكين والمحرِّرين والأدوار الأخرى، التي يمكن أن تكون مختلفة عن مجموعة المستخدمين الذين يمكنهم الوصول إلى مشروع الرمز البرمجي.
إذا كان من المخطّط نشر مشروع النصوص البرمجية كأحد الإضافات، يجب أن يستخدم مشروع Google Cloud عاديًا. عند التعاون في تطبيق يستخدم مشروعًا عاديًا على Google Cloud، ننصحك بضبط أصحاب الأدوار في Google Cloud لضمان حصول جميع المتعاونين على مستويات الوصول المناسبة. يساعد ذلك في تجنُّب الحالات التي تفقد فيها إمكانية الوصول إلى إعدادات المشروع على Cloud لأنّ مالكيه لم يعُد يعملون في مؤسستك. وهذا مهم بشكل خاص للملحقات.
التعاون وعوامل التفعيل
عند التعاون في مشروع، لا تتم مشاركة أي عوامل تشغيل قابلة للتثبيت تنشئها مع المستخدمين الذين يمكنهم الوصول إلى مشروعك. إذا كنت بحاجة إلى إعداد مشغلات متسقة لجميع المتعاونين، يمكنك استخدام خدمة النصوص البرمجية لإنشاء مشغلات برمجيًا في وقت التشغيل. لمزيد من المعلومات، يُرجى الاطّلاع على إدارة عوامل التفعيل آليًا.
التعاون والمكتبات
تكون المكتبات المضمّنة في مشروعك متاحة للمتعاونين في المشروع. ومع ذلك، إذا لم يكن لديه إذن وصول على مستوى القراءة على الأقل إلى مكتبة مضمّنة، لن يتمكّن من استخدام هذه المكتبات، وسيُعرِض النص البرمجي خطأ في هذه الحالة. لمزيد من المعلومات عن المكتبات، يُرجى الاطّلاع على مقالة إدارة المكتبات.
التعاون وخصائص المستخدِمين
خصائص المستخدِمين هي فريدة للمستخدِم الذي أنشأها. وهذا يعني أنّه لا يمكن لمتعاوني المشروع الاطّلاع على خصائص المستخدِمين أو الوصول إليها، ولا يمكنهم الاطّلاع على خصائص المستخدِمين الخاصة بك أو الوصول إليها. استخدِم مواقع النصوص البرمجية إذا كنت تريد مشاركة مواقع خاصة بالمشروع مع المتعاونين. لمزيد من المعلومات، يمكنك الاطّلاع على دليل المواقع.