مشاريع Google Cloud

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

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

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

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

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

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

عرض المشاريع التلقائية على السحابة الإلكترونية أو تعديلها

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

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

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

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

إذا لم تكن مشرفًا، لا يمكنك حذف المشاريع التلقائية. ومع ذلك، تحذف "برمجة التطبيقات" المشاريع التلقائية في السيناريوهات التالية:

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

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

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

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

عندما تتطلب "برمجة التطبيقات" مشاريع Cloud عادية

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

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

تتضمّن المشاريع العادية السمات التالية:

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

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

للوصول إلى المشروع القياسي المرتبط بمشروع النص البرمجي، قم بما يلي:

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

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

تفعيل واجهة برمجة تطبيقات في مشروع عادي على Cloud

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

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

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

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

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

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

لتحديد رقم تعريف ورقم مشروعك القياسي، قم بما يلي:

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

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

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

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

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

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

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

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

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

لإنشاء مُعرّف العميل وسر العميل لمشروع النص البرمجي، قم بما يلي:

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

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

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

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

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

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

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

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

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

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

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

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

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

    تفعيل Drive API

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

لمزيد من المعلومات حول حذف المشاريع على السحابة الإلكترونية، يُرجى الاطّلاع على إيقاف تشغيل (حذف) المشاريع.