مشاريع Google Cloud

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

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

مشاريع Google Cloud التلقائية

عند إنشاء مشروع "برمجة تطبيقات Google"، يتم إنشاء مشروع على السحابة الإلكترونية تلقائي يعمل في الخلفية.

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

بشكلٍ تلقائي، تحتوي مشاريع Cloud على سياسة "إدارة الهوية وإمكانية الوصول" (IAM) تتضمّن إدخالاً واحدًا، وهو حساب خدمة Google يعمل كمالك للمشروع التلقائي. حساب خدمة Google هو appsdev-apps-dev-script-auth@system.gserviceaccount.com.

عرض مشاريع Cloud التلقائية أو تعديلها

لا يمكن لمعظم المستخدمين تحديد موقع المشاريع التلقائية أو عرضها أو تعديلها مباشرةً في Google Cloud Console. إذا كنت مشرفًا، يُرجى الرجوع إلى عرض مشاريع Google Cloud التلقائية.

إذا أنشأت مشروع البرنامج النصي قبل 8 أبريل 2019، قد تستخدم مشروعًا تلقائيًا يمكنك الوصول إليه في Google Cloud Console. للوصول إلى المشروع التلقائي، انتقِل إلى إعدادات مشروع النص البرمجي وانقر على رقم المشروع.

حذف مشاريع Google Cloud التلقائية

إذا كنت مشرفًا، يمكنك حذف مشاريع Cloud التلقائية كما تحذف مشاريع Cloud العادية. يُرجى الاطّلاع على عرض مشاريع Cloud التلقائية أو تعديلها.

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

مشاريع Cloud العادية

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

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

الحالات التي تتطلّب فيها "برمجة التطبيقات" مشاريع Cloud عادية

يجب استخدام مشروع عادي في الحالات التالية:

• لنشر مشروع البرنامج النصي كـ إضافة Google Workspace في Google Workspace Marketplace
• لإثبات ملكية عميل OAuth الخاص بمشروع البرنامج النصي، اتّبِع الخطوات التالية:
• عندما يكون لديك تطبيق يحتاج إلى تنفيذ دوال في مشروع برمجة تطبيقات Google باستخدام طريقة scripts.run في Google Apps Script API
• لعرض سجلّات مشروع البرنامج النصي في Google Cloud في وحدة تحكّم Google Cloud توفّر وحدة تحكّم Google Cloud المزيد من الأدوات لفلترة السجلات وعرضها، وقد تكون أكثر فائدة من العرض المبسّط الذي توفّره لوحة بيانات "برمجة تطبيقات Google".
• لعرض تقارير الأخطاء الخاصة بمشروع البرنامج النصي باستخدام Error Reporting، اتّبِع الخطوات التالية:
• لإنشاء مربّع حوار لفتح الملف، اتّبِع الخطوات التالية:
• عندما تحتاج إلى التحكّم يدويًا في إعدادات Google Cloud الخاصة بالمشروع

خصائص مشاريع Cloud العادية

تتضمّن المشاريع العادية الخصائص التالية:

• يمكنك الوصول إلى جميع إعدادات Google Cloud الخاصة بالمشروع مباشرةً من وحدة تحكّم Google Cloud. يتيح لك ذلك تفعيل واجهات برمجة التطبيقات وتعديل بيانات اعتماد التفويض وضبط التفاصيل الأخرى.
• عند حذف مشروع نص برمجي أو التبديل إلى مشروع عادي آخر، يظل المشروع العادي الأصلي متاحًا ويمكن إعادة استخدامه.
• عند تفعيل خدمة متقدمة في مشروع نص برمجي، يجب تفعيل واجهة برمجة التطبيقات المقابلة يدويًا في المشروع العادي.
• يمكن أن تشترك مشاريع نصوص برمجية متعددة وتطبيقات أخرى في المشروع العادي نفسه. إذا كنت تنوي نشر مشروع نص برمجي على Marketplace كإضافة، يجب أن يكون لديه مشروع عادي خاص به. لا يمكن للتطبيقات المنشورة مشاركة مشاريع Cloud مع تطبيقات أخرى.
• إذا أردت تنفيذ دوال في مشروع نص برمجي من تطبيق آخر باستخدام طريقة scripts.run في واجهة برمجة التطبيقات Apps Script API، يجب أن يتشارك مشروع النص البرمجي والتطبيق الذي يستدعي الطريقة في المشروع العادي نفسه.
• عندما تطلب "برمجة التطبيقات" من المستخدم منح الإذن لنص برمجي يستخدم مشروعًا عاديًا، يتم استخدام اسم مشروع على السحابة الإلكترونية لتحديد النص البرمجي (وليس اسم مشروع النص البرمجي). لهذا السبب، احرص على ضبط اسم مناسب لمشروع على السحابة الإلكترونية.

الوصول إلى مشروع على السحابة الإلكترونية عادي

للوصول إلى المشروع العادي المرتبط بمشروع النص البرمجي، اتّبِع الخطوات التالية:

1. افتح مشروع برمجة تطبيقات.
2. على يمين الصفحة، انقر على إعدادات المشروع settings.
3. ضمن مشروع Google Cloud، انقر على رقم المشروع.

ابحث عن مشروع عادي مباشرةً في صفحة إدارة المواردفيوحدة تحكّم Google Cloud.

تفعيل واجهة برمجة تطبيقات في مشروع عادي على السحابة الإلكترونية

لمنح تطبيق برمجة تطبيقات إذن الوصول إلى واجهة Google APIs أخرى، فعِّل واجهة برمجة التطبيقات في مشروع على السحابة الإلكترونية ذي الصلة باتّباع الخطوات التالية:

1. افتح مشروع على السحابة الإلكترونية.
2. انقر على "القائمة" menu > واجهات برمجة التطبيقات والخدمات.
3. انقر على تفعيل واجهات برمجة التطبيقات والخدمات.
4. في مربّع البحث، أدخِل اسم واجهة برمجة التطبيقات التي تريد تفعيلها واضغط على Enter.
5. انقر على واجهة برمجة التطبيقات من نتائج البحث، ثم انقر على تفعيل.

قد يُطلب منك قبول بنود الخدمة الخاصة بواجهات برمجة التطبيقات من Google أو Google Cloud. يُرجى مراجعة بنود الخدمة بعناية قبل قبولها.

استنادًا إلى التطبيق، قد تحتاج إلى ضبط إعدادات واجهة برمجة التطبيقات من خلال اختيارها في لوحة بيانات واجهات برمجة التطبيقات والخدمات.

تحديد رقم تعريف ورقم مشروع على السحابة الإلكترونية عادي

تحتوي جميع مشاريع Cloud على اسم ورقم تعريف ورقم. قد تحتاج إلى هذه المعرّفات لإعداد الخدمات أو إكمال مهام أخرى.

لتحديد رقم تعريف مشروعك العادي ورقمه، اتّبِع الخطوات التالية:

1. افتح مشروع على السحابة الإلكترونية.
2. في أعلى يسار الصفحة، انقر على "المزيد" more_vert > إعدادات المشروع.
3. اطّلِع على اسم المشروع ورقم تعريف المشروع ورقم المشروع في لوحة الإعدادات الناتجة. يتكوّن رقم المشروع من أرقام، بينما يتكوّن رقم تعريف المشروع من أحرف أبجدية رقمية. عدِّل اسم المشروع الذي يظهر للمستخدمين أثناء طلبات التفويض.

عرض سجلّات Google Cloud وتقارير الأخطاء في Google Cloud Console

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

1. افتح مشروع على السحابة الإلكترونية.
2. انقر على رمز القائمة menu.
3. في قسم العمليات، انقر على التسجيل > مستكشف السجلات.
4. لعرض تقارير الأخطاء، انقر على إعداد تقارير الأخطاء في قسم العمليات. إذا طُلب منك إعداد ميزة إعداد التقارير عن الأخطاء، هذا يعني أنّ مشروع البرنامج النصي لم يسجّل أي استثناءات حتى الآن.

إكمال شاشة طلب الموافقة المتعلّقة ببروتوكول OAuth

عند استخدام الخدمات التي تتطلّب OAuth، تطلب Google من المستخدمين منح الإذن لهذه الخدمات. تحدّد إعدادات شاشة طلب الموافقة المتعلّقة ببروتوكول OAuth المعلومات التي تعرضها Google للمستخدمين، مثل اسم التطبيق وعنوان URL الخاص ببنود الخدمة.

تنشئ مشاريع Cloud التلقائية شاشة طلب الموافقة تلقائيًا من تفاصيل مشروع برمجة تطبيقات، ولا يمكنك تعديل هذه الإعدادات. تتيح لك مشاريع Cloud العادية تخصيص هذه المعلومات. لإعداد شاشة طلب الموافقة الخاصة بالنص البرمجي، اتّبِع الخطوات التالية:

1. افتح مشروع على السحابة الإلكترونية.
2. انقر على "القائمة" menu > واجهات برمجة التطبيقات والخدمات > بيانات الاعتماد.
3. انقر على إعداد شاشة طلب الموافقة.
4. املأ كل قسم من أقسام سير عمل شاشة طلب الموافقة.
5. لتسجيل التغييرات في كل مرحلة، انقر على حفظ ومتابعة.

إنشاء بيانات اعتماد OAuth

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

لإنشاء معرّف عميل وسر عميل لمشروع البرنامج النصي، اتّبِع الخطوات التالية:

1. افتح مشروع على السحابة الإلكترونية.
2. انقر على "القائمة" menu > واجهات برمجة التطبيقات والخدمات > بيانات الاعتماد.
3. انقر على إنشاء بيانات اعتماد > معرِّف عميل OAuth.
4. ضمن نوع التطبيق، اختَر نوع التطبيق واملأ النموذج. عند الانتهاء، انقر على إنشاء.
5. في مربّع الحوار، انقر على تنزيل JSON. استخدِم هذا الملف لضبط بروتوكول OAuth.

إضافة مالكين إضافيين إلى مشروع Cloud عادي

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

لإضافة مالكين إضافيين أو أدوار أخرى إلى مشروع عادي (يتطلّب أذونات التعديل):

1. تحديد المتعاونين ننصح باستخدام مجموعة Google. حدِّد النطاقات التي تريد تضمين جميع المستخدمين فيها.
2. افتح مشروع على السحابة الإلكترونية الخاص بالنص البرمجي.
3. انقر على "القائمة" menu > إدارة الهوية وإمكانية الوصول والمشرف > إدارة الهوية وإمكانية الوصول.
4. في أعلى الصفحة، انقر على إضافة.
5. اتّبِع التعليمات الظاهرة على الشاشة لإضافة أعضاء جدد وأدوارهم. أضِف رسائل إلكترونية فردية أو مجموعات Google أو نطاقات.
6. انقر على حفظ.

تجميع عدّة نصوص برمجية في مشروع واحد على السحابة الإلكترونية

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

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

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

تبديل مشروع نص برمجي لاستخدام مشروع على السحابة الإلكترونية عادي مختلف إذا كان النص البرمجي يتطلب إعدادًا يدويًا لمشروع على السحابة الإلكترونية، عليك التبديل من مشروع تلقائي إلى مشروع عادي. لمزيد من المعلومات، يُرجى الرجوع إلى مشاريع Cloud العادية.

تأثيرات التبديل إلى مشروع على السحابة الإلكترونية عادي مختلف

إذا بدّلت النص البرمجي من مشروع تلقائي أو إلى مشروع عادي مختلف، سيؤدي ذلك إلى حدوث ما يلي:

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

  في مشروعك العادي على السحابة الإلكترونية، فعِّل Drive API باتّباع الخطوات التالية:

  تفعيل Drive API

• على جميع المستخدمين الذين سبق لهم منح الإذن للبرنامج النصي إعادة منحه. في معظم الحالات، يجب أن يعيد جميع المستخدمين الذين سبق لهم تفويض التطبيقات المرتبطة بالمشروع الجديد تفويضها.
• إذا كان النص البرمجي مرتبطًا ببطاقة بيانات تطبيق على Google Workspace Marketplace، لن يتم نقل بطاقة بيانات تطبيقك والمستخدمين والمراجعات إلى المشروع الجديد. يجب إنشاء بطاقة بيانات التطبيق ضِمن المشروع الجديد، كما يجب أن يعيد المستخدمون تثبيت تطبيقك. للحصول على معلومات حول إنشاء بطاقة بيانات تطبيق جديدة، يُرجى الرجوع إلى نشر تطبيق.
• لا يمكنك إعادة النص البرمجي إلى مشروع تلقائي. تحذف "برمجة التطبيقات" المشاريع التلقائية بعد ضبط النص البرمجي لاستخدام مشروع عادي.

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

لتبديل مشروع Cloud الحالي الخاص بنص برمجي إلى مشروع Cloud آخر، اتّبِع الخطوات التالية:

1. إذا لم يكن لديك مشروع على السحابة الإلكترونية مناسب، أنشئ مشروعًا باتّباع تعليمات إنشاء مشروع. اضبط اسمًا يسهل تذكُّره للمشروع لتحديد موقعه في صفحة إدارة الموارد بوحدة تحكّم Google Cloud. تستخدم "برمجة التطبيقات" هذا الاسم عندما تطلب من المستخدمين منح الإذن للنص البرمجي.
2. إذا كنت تريد استخدام مشروع حالي، افتح صفحة إدارة الموارد Manage Resources في Google Cloud Console وابحث عن مشروع حالي لاستخدامه. يجب أن يكون لديك دورا "متصفّح المشاريع" و"محرّر إعدادات OAuth"، أو أدوار تتضمّن الأذونات المكافئة للمشروع. لا يمكنك استخدام مشروع تم إنشاؤه تلقائيًا بواسطة "برمجة تطبيقات Google".
3. حدِّد رقم المشروع لمشروعك على السحابة الإلكترونية.
4. افتح النص البرمجي الذي تريد استبدال مشروع على السحابة الإلكترونية به.
5. على يمين الصفحة، انقر على إعدادات المشروع settings.
6. ضمن مشروع Google Cloud، انقر على تغيير المشروع.
7. أدخِل رقم المشروع الجديد وانقر على ضبط المشروع.

المشاريع على السحابة الإلكترونية ومساحات Drive المشتركة

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

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

توضّح القائمة التالية كيفية تفاعل مشاريع Cloud مع المساحات المشتركة:

• إذا كان مشروع النص البرمجي يستخدم مشروعًا عاديًا، لن تكون هناك أي قيود إضافية عندما يكون مشروع النص البرمجي في مساحة تخزين سحابي مشتركة.
• إذا كان مشروع النص البرمجي يستخدم مشروعًا تلقائيًا تم إنشاؤه في 8 أبريل 2019 أو بعده، لن يتم فرض أي قيود إضافية عندما يكون مشروع النص البرمجي في مساحة تخزين سحابي مشتركة.
• إذا كان مشروع النص البرمجي يستخدم مشروعًا تلقائيًا تم إنشاؤه قبل 8 نيسان (أبريل) 2019، ستنطبق القيود التالية أثناء إقامة مشروع النص البرمجي في مساحة تخزين سحابي مشتركة:
  1. لا يمكنك الوصول إلى المشروع التلقائي باستخدام واجهة مستخدم برمجة تطبيقات أو وحدة تحكّم Google Cloud. يمنعك هذا القيد من اتّخاذ إجراءات تتطلّب الوصول المباشر إلى المشروع.
  2. لا يمكنك تفعيل الخدمات المتقدّمة. لتفعيل الخدمات المتقدّمة، عليك التبديل إلى مشروع عادي.
  3. عند نقل مشروع حالي في "برمجة تطبيقات Google" إلى مساحة تخزين سحابي مشتركة، تقيّد Google إمكانية الوصول إلى مشروع على السحابة الإلكترونية التلقائي. سيظل بإمكانك الوصول إلى المشروع التلقائي إذا كان لديك إذن بالوصول إليه قبل عملية النقل. على سبيل المثال، إذا أنشأت نصًا برمجيًا في مجلد "ملفاتي" ثم نقلته إلى مساحة تخزين سحابي مشتركة، سيظل بإمكانك الوصول إلى مشروع على السحابة الإلكترونية الخاص بالنص البرمجي. قد لا يتمكّن المتعاونون في مساحة التخزين السحابي المشتركة من ذلك.
  4. يحتفظ النص البرمجي باسم مشروع على السحابة الإلكترونية الذي كان لديه قبل نقله إلى مساحة تخزين سحابي مشتركة. حتى إذا غيّرت اسم المشروع في مساحة التخزين السحابي المشتركة، سيظل يظهر الاسم القديم في مربّعات الحوار الخاصة بمنح الإذن للمستخدمين الذين يمنحون الإذن للبرنامج النصي.

لتجنُّب هذه القيود في النصوص البرمجية القديمة، بدِّل إلى مشروع عادي.

الحصول على قائمة بمشاريع "برمجة التطبيقات" في Cloud

إذا كان لديك إذن resourcemanager.projects.list لمجلد مشروع "برمجة التطبيقات" الخاص بمؤسستك، يمكنك الاطّلاع على جميع مشاريع "برمجة التطبيقات" العادية وتلك التلقائية في السحابة الإلكترونية ضمن المجلد.

1. افتح صفحة إدارة الموارد في وحدة تحكّم Google Cloud.
2. بجانب مجلد برمجة تطبيقات، انسخ رقم التعريف.
3. انقر على فلتر > رقم تعريف المجلد الرئيسي والصِق رقم تعريف مجلد برمجة تطبيقات.

gcloud projects list --filter='parent.id=APPS_SCRIPT_FOLDER_ID'
gcloud projects delete PROJECT_ID