مشاريع Google Cloud

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

تتميز المشاريع العادية بالسمات التالية:

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

الوصول إلى مشروع عادي على Cloud

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

    تفعيل Drive API

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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