مشاريع Google Cloud

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

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

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

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

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

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

عرض مشاريع السحاب التلقائية أو تحديثها

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

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

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

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

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

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

مشاريع Cloud Standard

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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