مشاريع Google Cloud

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

  في مشروعك العادي على Cloud، فعِّل واجهة برمجة التطبيقات Drive API:

  تفعيل واجهة برمجة التطبيقات Drive API

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

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

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

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

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

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

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

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

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

الحصول على قائمة بمشاريع Apps Script على Cloud

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

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

حذف مشاريع Apps Script في Cloud

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

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

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

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