التعاون مع المطوّرين الآخرين

توفّر خدمة "برمجة تطبيقات Google" ميزات تساعد الفِرق في إنشاء البرامج النصية وإضافات Google Workspace وتطبيقات الويب معًا والحفاظ عليها. يتناول هذا الدليل التعاون النشط في مشروع من قِبل عدة مطوّرين. إذا كنت تريد مشاركة الرمز البرمجي مع الآخرين لتضمينه في مشاريعهم، راجِع دليل المكتبات بدلاً من ذلك.

أساسيات التعاون

للتعاون في مشروع، يجب أن يكون لديك أنت والمتعاونون معك إذن وصول بصفة محرّر إلى ملف مشروع برمجة تطبيقات (والحاوية الخاصة به، إذا كان نصًا برمجيًا مرتبطًا). يتيح ذلك لجميع أعضاء فريقك الاطّلاع على رمز برمجة تطبيقات وإجراء تغييرات عليه. يمكن للمحرّرين أيضًا إنشاء نُسخ جديدة من الرموز البرمجية ونشر الإضافات وتفعيل النصوص البرمجية كتطبيقات ويب أو كملفات تنفيذية لواجهة برمجة تطبيقات Apps Script.

خطِّط مسبقًا لكيفية التعامل مع التعديل والمراجعة وإصدار النسخ، وكذلك النشر والتوزيع (إذا كان ذلك منطبقًا) لمشروعك أو تطبيقك الإضافي أو تطبيقك على الويب. وعادةً ما تكون المشاريع المستقلة هي الأسهل في التعاون، لأنّها تظهر مباشرةً في Google Drive وهي نوع المشروع المقترَح لتطوير التطبيقات الإضافية وتطبيقات الويب.

تحدث مشكلة شائعة في التعاون عندما يغادر مالك مشروع نص برمجي الفريق بدون نقل ملكية المشروع إلى شخص آخر في الفريق. وقد يؤدي ذلك إلى عدم قدرتك على صيانة المشروع أو تعديله. يؤدي وضع مشروع البرنامج النصي في مساحة تخزين سحابي مشتركة إلى تجنُّب هذه المشكلة، لأنّ الملفات في مساحة التخزين السحابي المشتركة لا يكون لها مالكون محدّدون.

مشاركة ملكية مشاريع النصوص البرمجية دائمًا: إذا غادر مستخدم مؤسستك وتمت إزالة حسابه، سيتعذّر الوصول إلى البرامج النصية التي لا يملكها سوى هذا المستخدم. شارِك النص في Drive أو انقله إلى مساحة تخزين سحابي مشتركة.

التعاون باستخدام أداة سطر الأوامر clasp

تتيح لك أداة clasp مزامنة المشاريع بين script.google.com ونظام الملفات المحلي. يتيح لك ذلك تبسيط عملية تطوير التعليمات البرمجية وأتمتتها إذا كنت أنت والمتعاونون معك تستخدمون برنامجًا لإدارة عملية التحكّم في المصدر، مثل git.

لمزيد من التفاصيل، يُرجى الاطّلاع على دليل استخدام واجهة سطر الأوامر clasp.

التعاون باستخدام مساحات التخزين السحابي المشتركة

لا تتوفّر مساحات التخزين المشتركة إلا لعملاء Google Workspace Business وGoogle Workspace Enterprise.

توفّر مساحات Drive المشتركة مساحة مشتركة في Drive يمكن لمجموعات من مستخدمي Drive التعاون فيها بفعالية أكبر. الملفات الموضوعة في مساحة تخزين سحابي مشتركة مملوكة للمجموعة ككل، وليس للأفراد. يعني ذلك أنّه عندما يغادر أحد المتعاونين المجموعة، لن يحتفظ بملكية الملف والتحكّم فيه.

تتيح لك مساحات التخزين السحابي المشتركة أيضًا نقل الملفات بين النطاقات، إذ يمكن أن تضم مساحة تخزين سحابي مشتركة في أحد النطاقات متعاونين من نطاق آخر يمكنهم نقل الملفات من ذلك النطاق إلى مساحة التخزين السحابي المشتركة. ويوفّر ذلك وسيلة لفريق لتطوير إضافات أو تطبيقات ويب أو رموز أخرى للعملاء في نطاقات مختلفة.

عند استخدام مساحات التخزين السحابي المشتركة للتعاون في مشاريع برمجة تطبيقات، يجب مراعاة ما يلي:

1. يمكن للمتعاونين الذين لديهم إذن وصول بصفة محرّر إلى مساحة تخزين سحابي مشتركة إنشاء ملفات جديدة أو نقلها إلى مساحة التخزين السحابي المشتركة. بصفتهم محرِّري نصوص برمجية، يمكنهم عرض مشاريع النصوص البرمجية وتعديلها، وتنفيذ رموز النصوص البرمجية، وإنشاء إصدارات جديدة من النصوص البرمجية، ونشر الإضافات.
2. لنشر النصوص البرمجية كتطبيقات ويب أو ملفات تنفيذية لواجهة Apps Script API، يجب أن يكون الحساب الذي ينشئ عملية النشر تابعًا للنطاق نفسه الذي تتبعه مساحة التخزين السحابي المشتركة التي يتضمّن النص البرمجي.
3. تتيح لك مساحات التخزين السحابي المشتركة مشاركة ملفات معيّنة داخل مساحة التخزين السحابي المشتركة مع مستخدمين آخرين خارج المجموعة، وتعديل أذونات التعديل والاطّلاع على هذه الملفات كما هو الحال مع أي ملف آخر على Drive. ومع ذلك، إذا كان المستخدم جزءًا من الفريق الذي تنتمي إليه مساحة التخزين السحابي المشتركة، لا يمكنك تقليل مستوى وصوله إلى ملفات معيّنة. على سبيل المثال، إذا كان لدى مستخدم إذن تعديل في مساحة تخزين سحابي مشتركة، لا يمكنك تغيير هذا الإذن إلى إذن بالاطّلاع فقط على ملف معيّن داخل مساحة التخزين السحابي المشتركة.
4. يمكن للمتعاونين الذين لديهم إذن وصول كامل إلى مساحة تخزين سحابي مشتركة حذف الملفات ومشاريع برمجة تطبيقات ونقل الملفات خارج مساحة التخزين السحابي المشتركة.
5. تستخدم جميع البرامج النصية المرتبطة بالحاوية قوائم أذونات الوصول نفسها الخاصة بالمشاهدين والمحرّرين والمحدّدة لملف الحاوية. على سبيل المثال، إذا كان لديك إذن بالتعديل على "جدول بيانات Google"، سيكون لديك أيضًا إذن بالتعديل على أي رمز مشروع في "برمجة تطبيقات Google" مرفق به. يؤدي وضع ملف حاوية من هذا النوع في مساحة تخزين سحابي مشتركة إلى منح المتعاونين في مساحة التخزين السحابي المشتركة إذن الوصول نفسه إلى رمز البرنامج النصي كما هو الحال مع الحاوية نفسها.
6. عندما يكون مشروع نص برمجي في مساحة تخزين سحابي مشتركة، قد يتم تقييد الوصول إلى مشروع Google Cloud. راجِع قسم دليل مشاريع Google Cloud ومساحات التخزين السحابي المشتركة للاطّلاع على التفاصيل.
7. تطبيقات الويب التي يتم تفعيلها في نطاق واحد تتوقف عن العمل إذا تم تغيير مالكها إلى مساحة تخزين سحابي مشتركة أو حساب في نطاق مختلف. يمكنك تصحيح ذلك من خلال نقل النص البرمجي إلى النطاق الأصلي.
8. وبالمثل، تتوقف مشاريع النصوص البرمجية التي تم تفعيلها كملف تنفيذي لواجهة برمجة التطبيقات في "برمجة تطبيقات Google" عن العمل عند استدعائها من خلال واجهة برمجة التطبيقات إذا تم نقلها عبر مساحة تخزين سحابي مشتركة من نطاق إلى آخر. يمكنك تصحيح ذلك من خلال نقل النص البرمجي إلى نطاقه الأصلي.

التعاون باستخدام مجلد مشترك

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

إذا لم تتمكّن من التعاون في مساحة تخزين سحابي مشتركة، استخدِم مجلدًا مشتركًا بدلاً من ذلك. عند إنشاء مشروع برمجة تطبيقات أو نقله إلى مجلد في Drive يمكن للمستخدمين الآخرين الوصول إليه، سيحصلون على إذن الوصول نفسه إلى مشروع برمجة تطبيقات الذي لديهم للمجلد. على سبيل المثال:

• إذا كان لدى مستخدم إذن بتعديل المجلد، يمكنه تعديل مشروع "برمجة تطبيقات Google" أو حذفه وتشغيل البرنامج النصي.
• إذا كان بإمكان مستخدم الوصول إلى المجلد بالإذن بالاطّلاع فقط، يمكنه الاطّلاع على مشروع "برمجة تطبيقات Google" وتشغيل البرنامج النصي.

التعاون من خلال مشاركة المشاريع

التعاون في مشروع من خلال مشاركته مباشرةً مع جميع المتعاونين مشاركة مشاريع البرامج النصية مباشرةً إذا كانت مخزّنة في مجلدات Drive عادية أو في مساحات تخزين سحابي مشتركة خطِّط بعناية لتحديد الجهة التي ستملك النص البرمجي وتتولّى صيانته بمرور الوقت.

تظهر المشاريع المستقلة في Drive كملف، ويمكنك مشاركتها مثل أي ملف آخر. لمزيد من المعلومات، يُرجى الاطّلاع على مشاركة الملفات والمجلدات.

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

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

التعاون وموارد المشاريع

الموارد هي عناصر مرتبطة بمشروعك ولكنها مستقلة عن رمزه. يوضّح هذا القسم كيف يؤثّر التعاون في مشروع على موارده، لا سيما مشروع Google Cloud والمشغّلات والمكتبات وخصائص المستخدمين.

التعاون ومشاريع Google Cloud

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

التعاون والمشغّلات

عند التعاون في العمل على مشروع، لن تتم مشاركة أي مشغّلات قابلة للتثبيت تنشئها مع المستخدمين الذين يمكنهم الوصول إلى مشروعك. إذا كنت بحاجة إلى إعداد مشغّل متسق لجميع المتعاونين، استخدِم خدمة "البرنامج النصي" لإنشاء المشغّلات آليًا في وقت التشغيل. لمزيد من المعلومات، يُرجى الاطّلاع على إدارة المشغّلات آليًا.

المتعاونون

التعاون والمكتبات

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

التعاون وخصائص المستخدم

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