مشاريع Google Cloud

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

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

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

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

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

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

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

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

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

  1. افتح مشروع Apps Script.
  2. على يمين الصفحة، انقر على إعدادات المشروع .
  3. ضمن مشروع Google Cloud Platform (GCP)، انقر على رقم المشروع.

يمكنك أيضًا العثور على مشروع عادي مباشرةً في صفحة إدارة الموارد في Google Cloud Console.

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

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

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

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

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

تحديد رقم تعريف ورقم مشروع Cloud العادي

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

يمكنك إضافة مالكين آخرين أو أدوار أخرى إلى مشروع عادي باتّباع الخطوات التالية. يجب أن تتوفّر لديك أذونات تعديل للمشروع لإجراء أي من التغييرات التالية:

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

تجميع عدّة نصوص برمجية في مشروع Cloud واحد

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

استخدام مشروع مختلف على Google Cloud

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

تأثيرات التبديل إلى مشروع Cloud عادي مختلف

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

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

    في مشروعك العادي على Google Cloud، فعِّل Drive API:

    تفعيل Drive API

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

التبديل إلى مشروع Google Cloud عادي مختلف

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

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

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

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

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

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

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

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

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

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

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

لحذف مشروع Cloud في "برمجة التطبيقات"، اتّبِع الخطوات الواردة في الحصول على قائمة بمشاريع Cloud في "برمجة التطبيقات"، واختَر المشروع الذي تريد حذفه، ثم انقر على حذف.

لحذف مشروع "برمجة تطبيقات Google" باستخدام gcloud، استخدِم الأوامر التالية.

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

لمزيد من المعلومات حول حذف مشاريع Cloud، يُرجى الاطّلاع على إيقاف المشاريع (حذفها).