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