يستخدم كل مشروع من مشاريع "برمجة التطبيقات" Google Cloud لإدارة التفويض والخدمات المتقدّمة وتفاصيل أخرى. لضبط هذه الإعدادات وإدارتها، يحتوي كل مشروع لبرمجة التطبيقات على مشروع Google Cloud مرتبط به. يمكن أن يستخدم مشروع النص البرمجي مشروعًا تلقائيًا تنشئه "برمجة التطبيقات" تلقائيًا، أو مشروعًا عاديًا تنشئه بنفسك. بشكل عام، تعد المشروعات الافتراضية جيدة للنصوص البرمجية اليومية أو البسيطة، ولكن يجب عليك استخدام مشروع قياسي لأي تطبيق معقد أو ذي جودة تجارية أو تنوي نشره.
يمكنك التبديل من مشروع تلقائي إلى مشروع عادي في أي وقت، ولكن لا يمكنك العودة لاستخدام مشروع تلقائي. من الأفضل تحديد المشروع على السحابة الإلكترونية الذي يستخدمه النص البرمجي في مرحلة مبكرة من عملية التطوير. قد يؤدي التبديل لاحقًا إلى مضاعفات، مثل مطالبة المستخدمين بإعادة التفويض.
المشاريع التلقائية على السحابة الإلكترونية
عند إنشاء مشروع لبرمجة التطبيقات، تنشئ "برمجة التطبيقات" مشروعًا تلقائيًا على السحابة الإلكترونية يعمل في الخلفية.
- بالنسبة إلى معظم النصوص البرمجية، لن تحتاج أبدًا إلى الاطّلاع على هذا المشروع التلقائي أو تعديله. يعالج برمجة تطبيقات التطبيقات التفاعلات الضرورية مع Google Cloud. على سبيل المثال، في حال تفعيل خدمة متقدّمة في محرِّر "برمجة تطبيقات Google"، ستفعِّل "برمجة التطبيقات" الخدمة المتقدّمة في المشروع التلقائي على السحابة الإلكترونية عند حفظ مشروع النصوص البرمجية.
- بالنسبة إلى بعض النصوص البرمجية، عليك التفاعل مع وحدة تحكُّم Google Cloud. في هذه الحالات، يجب أن يستخدم النص البرمجي مشروعًا عاديًا على السحابة الإلكترونية بدلاً من ذلك. على سبيل المثال، لعرض سجلات Google Cloud في Google Cloud Console، يجب أن يستخدم النص البرمجي مشروعًا عاديًا.
تتضمّن المشاريع في السحابة الإلكترونية تلقائيًا سياسة "إدارة الهوية والوصول"
(IAM) مع إدخال واحد، وحساب خدمة Google يعمل كمالك
للمشروع التلقائي. حساب خدمة Google هو
appsdev-apps-dev-script-auth@system.gserviceaccount.com
.
عرض المشاريع التلقائية على السحابة الإلكترونية أو تعديلها
لا يمكن لمعظم المستخدمين تحديد موقع المشاريع التلقائية أو عرضها أو تعديلها مباشرةً في Google Cloud Console. إذا كنت مشرفًا، يُرجى الرجوع إلى عرض مشاريع Google Cloud التلقائية.
إذا أنشأت مشروع النصوص البرمجية قبل 8 نيسان (أبريل) 2019، يمكنك استخدام مشروع تلقائي يمكنك الوصول إليه في Google Cloud Console. للوصول إلى المشروع التلقائي، انتقِل إلى إعدادات المشروع النصي وانقر على رقم المشروع.
حذف المشاريع التلقائية على السحابة الإلكترونية
إذا كنت مشرفًا، يمكنك حذف مشاريع السحابة الإلكترونية التلقائية مثل المشاريع العادية على السحابة الإلكترونية. يُرجى الاطّلاع على حذف مشاريع "برمجة التطبيقات" على السحابة الإلكترونية.
إذا لم تكن مشرفًا، لا يمكنك حذف المشاريع التلقائية. ومع ذلك، تحذف "برمجة التطبيقات" المشاريع التلقائية في السيناريوهات التالية:
- في حال حذف مشروع النص البرمجي أو تبديله لاستخدام مشروع عادي، يحذف برمجة التطبيقات المشروع التلقائي المرفق بالنص البرمجي مع أي إعدادات أو معلومات يحتوي عليها.
- إذا لم يتم تشغيل نص برمجي لمدة 180 يومًا أو أكثر، ستحذف "برمجة التطبيقات" المشروع التلقائي المرتبط بها. في حال تشغيل النص البرمجي بعد حذف "برمجة التطبيقات" لمشروعه التلقائي، تُنشئ "برمجة التطبيقات" مشروعًا للنص البرمجي.
المشاريع العادية على Cloud
المشاريع التلقائية على السحابة الإلكترونية هي الخيار الأفضل لمعظم مشاريع النصوص البرمجية، إلا إذا كنت بحاجة إلى ضبط المشروع يدويًا. في هذه الحالات، عليك تبديل مشروع النص البرمجي لاستخدام مشروع عادي.
توضّح الأقسام التالية الحالات التي تتطلّب فيها "برمجة التطبيقات" مشروعًا عاديًا، وخصائص هذه المشاريع، والمهام الشائعة التي يتم تنفيذها معها. يمكنك تنفيذ المهام التالية فقط باستخدام المشروعات القياسية.
عندما تتطلّب "برمجة التطبيقات" مشاريع Cloud عادية
يجب استخدام مشروع عادي في الحالات التالية:
- لنشر مشروع النص البرمجي كإضافة في Google Workspace Marketplace
- للتحقّق من عميل OAuth لمشروع النص البرمجي
- عندما يكون لديك تطبيق يحتاج إلى تنفيذ الدوال في مشروع
النصوص البرمجية باستخدام
طريقة
scripts.run
لواجهة برمجة التطبيقات لبرمجة التطبيقات. - للاطّلاع على سجلات Google Cloud لمشروع النص البرمجي في Google Cloud Console. توفّر وحدة التحكّم في Google Cloud المزيد من الأدوات لفلترة السجلّات وعرضها، ويمكن أن تكون أكثر فائدة من العرض المبسَّط الذي توفّره لوحة بيانات "برمجة التطبيقات".
- للاطّلاع على تقارير أخطاء مشروع النص البرمجي باستخدام الإبلاغ عن الأخطاء.
- لإنشاء مربع حوار فتح الملف.
- عندما تحتاج إلى التحكّم اليدوي في إعدادات Google Cloud الخاصة بالمشروع
خصائص المشروع العادية على Cloud
تتضمّن المشاريع العادية السمات التالية:
- يمكنك الوصول إلى جميع إعدادات Google Cloud للمشروع مباشرةً من Google Cloud Console. يتيح لك هذا تفعيل واجهات برمجة التطبيقات وضبط بيانات اعتماد التفويض وتهيئة التفاصيل الأخرى.
- عند حذف مشروع نص برمجي أو تبديله لاستخدام مشروع عادي آخر، يبقى المشروع العادي الأصلي متوفرًا ويمكن إعادة استخدامه.
- عند تفعيل خدمة متقدّمة في مشروع نص برمجي، يجب تفعيل واجهة برمجة التطبيقات المقابلة يدويًا في المشروع العادي.
- يمكن لعدة مشروعات نصية وتطبيقات أخرى مشاركة نفس المشروع القياسي. إذا كنت تنوي نشر مشروع نص برمجي على Google Workspace Marketplace كإضافة، يجب أن يكون له مشروع عادي خاص به. لا يمكن للتطبيقات المنشورة مشاركة المشاريع السحابية مع التطبيقات الأخرى.
- إذا كنت تريد تنفيذ الدوال في مشروع نص برمجي من تطبيق آخر باستخدام طريقة
scripts.run
لواجهة برمجة التطبيقات لبرمجة التطبيقات، يجب أن يشترك مشروع النص البرمجي وتطبيق الاستدعاء في المشروع العادي نفسه. - عندما تطلب "برمجة التطبيقات" من المستخدم تفويض نص برمجي يستخدم مشروعًا عاديًا، يتم استخدام اسم المشروع على Google Cloud لتحديد النص البرمجي (وليس اسم مشروع النصوص البرمجية). لهذا السبب، احرص على تحديد اسم مناسب للمشروع على السحابة الإلكترونية.
الوصول إلى مشروع عادي على السحابة الإلكترونية
للوصول إلى المشروع القياسي المرتبط بمشروع النص المكتوب، قم بما يلي:
- افتح مشروع "برمجة تطبيقات Google".
- على يمين الصفحة، انقر على إعدادات المشروع .
- ضمن مشروع Google Cloud Platform (GCP)، انقر على رقم المشروع.
يمكنك أيضًا العثور على مشروع عادي مباشرةً في صفحة إدارة الموارد في Google Cloud Console.
تفعيل واجهة برمجة تطبيقات في مشروع عادي على السحابة الإلكترونية
غالبًا ما يحتاج تطبيق "برمجة تطبيقات Google" إلى الوصول إلى واجهة برمجة تطبيقات أخرى من Google API. للقيام بذلك، يجب عليك تنشيط واجهة برمجة التطبيقات في المشروع المقابل على السحابة. يمكنك تفعيل واجهة برمجة التطبيقات من خلال تنفيذ ما يلي:
- افتح المشروع على Google Cloud.
- انقر على رمز القائمة > واجهات برمجة التطبيقات والخدمات.
- انقر على تفعيل واجهات برمجة التطبيقات والخدمات.
- في مربع البحث، أدخِل واجهة برمجة التطبيقات التي تريد تفعيلها واضغط على Enter.
- يمكنك النقر على واجهة برمجة التطبيقات من نتائج البحث، ثم النقر على تفعيل لتفعيل واجهة برمجة التطبيقات لهذا المشروع على السحابة الإلكترونية.
قد يُطلب منك قبول بنود الخدمة لـ Google APIs أو Google Cloud. راجع بنود الخدمة بعناية قبل قبولها.
استنادًا إلى التطبيق، قد تحتاج أيضًا إلى ضبط واجهة برمجة التطبيقات من خلال اختيارها في لوحة بيانات واجهات برمجة التطبيقات والخدمات.
تحديد رقم تعريف ورقم مشروع عادي على السحابة الإلكترونية
تتضمّن جميع المشاريع على السحابة الإلكترونية اسم مشروع ورقم تعريف مشروع ورقم مشروع. في بعض الأحيان، يجب أن يكون لديك هذه المعرّفات لتكوين الخدمات أو إكمال مهام أخرى.
لتحديد رقم تعريف المشروع القياسي ورقمه، قم بما يلي:
- افتح المشروع على Google Cloud.
- في أعلى يسار الصفحة، انقر على رمز المزيد > إعدادات المشروع.
- اطّلِع على اسم المشروع ورقم تعريف المشروع ورقم المشروع في لوحة الإعدادات الناتجة. يتكون رقم المشروع من أرقام فقط، بينما يتكون رقم تعريف المشروع من أحرف أبجدية رقمية. يمكنك تعديل اسم المشروع الذي يظهر للمستخدمين أثناء طلبات الحصول على الإذن.
الاطّلاع على سجلّات Google Cloud وتقارير الأخطاء في Google Cloud Console
إذا كنت تستخدم تسجيل Google Cloud أو الإبلاغ عن الأخطاء لمشروع النص البرمجي، يمكنك عرض هذه السجلّات والتقارير في Google Cloud Console من خلال تنفيذ ما يلي:
- افتح المشروع على Google Cloud.
- انقر على رمز القائمة .
- مرّر لأسفل إلى قسم العمليات وانقر على تسجيل الدخول > مستكشف السجلات.
- لعرض تقارير الأخطاء، انتقِل للأسفل إلى قسم العمليات وانقر على الإبلاغ عن الأخطاء. إذا تمت مطالبتك بإعداد تقارير الأخطاء، فهذا يعني أن مشروع النص البرمجي لم يسجل أي استثناءات حتى الآن.
إكمال شاشة طلب الموافقة المتعلّقة ببروتوكول OAuth
عند استخدام خدمات تتطلب بروتوكول OAuth، تطلب Google من المستخدمين منح الإذن لتلك الخدمات. تتيح لك إعدادات شاشة طلب الموافقة المتعلّقة ببروتوكول OAuth ضبط بعض المعلومات التي تقدّمها Google للمستخدمين، مثل اسم التطبيق وعنوان URL لبنود الخدمة.
تنشئ المشاريع التلقائية على السحابة الإلكترونية شاشة موافقة تلقائيًا من تفاصيل مشروع "برمجة التطبيقات"، ولا يمكنك تعديل هذه الإعدادات. تتيح لك مشاريع Cloud العادية تخصيص هذه المعلومات. يمكنك ضبط شاشة طلب الموافقة الخاصة بالنص البرمجي عن طريق اتّباع الخطوات التالية:
- افتح المشروع على Google Cloud.
- انقر على رمز القائمة > واجهات برمجة التطبيقات والخدمات > بيانات الاعتماد.
- انقر على ضبط شاشة الموافقة.
- املأ كل قسم من سير عمل شاشة الموافقة.
- لتسجيل التغييرات في كل مرحلة من مراحل سير العمل، انقر على حفظ ومتابعة.
إنشاء بيانات اعتماد OAuth
تعمل "برمجة التطبيقات" عادةً على إعداد بروتوكول OAuth للخدمات التي يستخدمها النص البرمجي. بالنسبة إلى بعض التطبيقات، يجب إنشاء بيانات اعتماد إضافية من OAuth (معرّفات العميل وأسرار العملاء). يمكنك القيام بذلك فقط باستخدام المشروعات القياسية.
لإنشاء معرِّف عميل وسر عميل لمشروع النص البرمجي، عليك اتّباع الخطوات التالية:
- افتح المشروع على Google Cloud.
- انقر على رمز القائمة > واجهات برمجة التطبيقات والخدمات > بيانات الاعتماد.
- انقر على إنشاء بيانات اعتماد > معرِّف عميل OAuth.
- ضمن نوع التطبيق، اختَر نوع الطلب واملأ النموذج الناتج إذا لزم الأمر. عند الانتهاء، انقر على إنشاء.
- في مربّع الحوار الذي يظهر، انقر على تنزيل JSON. يمكنك استخدام هذا الملف لضبط بروتوكول OAuth.
إضافة مالكين آخرين إلى مشروع عادي على السحابة الإلكترونية
يمكنك إضافة مالكين آخرين أو أدوار أخرى إلى مشروع عادي. إذا كنت تتعاون في مشروع، يساعد ذلك في ضمان وصول مستخدم في فريقك دائمًا إلى إعدادات Google Cloud لمشروع النص البرمجي.
يمكنك إضافة مالكين أو أدوار أخرى إلى مشروع عادي عن طريق تنفيذ ما يلي. يجب أن يكون لديك أذونات تعديل للمشروع لإجراء أي من هذه التغييرات:
- حدِّد المتعاونين الذين يجب أن يتعاونوا معك. وننصحك بإنشاء مجموعة حالية من "مجموعات Google" أو استخدامها. يمكنك أيضًا تحديد النطاقات في قائمة المتعاونين لتضمين جميع المستخدمين في هذا النطاق.
- افتح المشروع على السحابة الإلكترونية للنص البرمجي.
- انقر على رمز القائمة > إدارة الهوية وإمكانية الوصول والمشرف > إدارة الهوية وإمكانية الوصول.
- في أعلى الصفحة، انقر على إضافة.
- اتّبِع التعليمات الظاهرة على الشاشة لإضافة عضو واحد أو أكثر جديد وأدواره إلى المشروع على السحابة الإلكترونية. يمكنك إضافة رسائل إلكترونية فردية أو مجموعات Google أو نطاقات كأعضاء جدد.
- انقر على حفظ.
تجميع نصوص برمجية متعددة باستخدام مشروع واحد على السحابة الإلكترونية
يمكن أن تكون لديك عدة مشاريع لبرمجة التطبيقات تتشارك المشروع نفسه العادي على السحابة الإلكترونية. لتنفيذ ذلك، أنشِئ مشروعًا عاديًا ثم بدِّل كل مشروع نص برمجي لاستخدامه. ولا يمكنك تنفيذ ذلك باستخدام المشاريع التلقائية.
استخدام مشروع عادي مختلف على السحابة الإلكترونية
يمكنك تبديل مشروع نص برمجي بحيث يستخدم مشروع Cloud عاديًا مختلفًا. إذا كان النص البرمجي يتطلب ضبطًا يدويًا للمشروع على السحابة الإلكترونية، عليك التبديل من مشروع تلقائي إلى مشروع عادي. لمعرفة المزيد من المعلومات حول الحالات التي تحتاج فيها إلى استخدام مشروع عادي، يمكنك الرجوع إلى المشاريع العادية على Cloud.
تأثيرات التبديل إلى مشروع عادي مختلف على السحابة الإلكترونية
في حال تبديل النص البرمجي من مشروع تلقائي أو إلى مشروع عادي مختلف، سيحدث ما يلي:
- إذا فعّلت الخدمات المتقدمة للنص البرمجي، يجب تفعيل واجهات برمجة التطبيقات المتجاوبة في المشروع الجديد على السحابة الإلكترونية. ستفقد أي بيانات مرتبطة بالخدمات المتقدّمة في المشروع السابق على السحابة الإلكترونية. للاطّلاع على كيفية تفعيل واجهات برمجة التطبيقات في مشروعك على السحابة الإلكترونية، يُرجى الرجوع إلى مقالة تفعيل واجهات برمجة التطبيقات في Google Workspace.
- إذا كان النص البرمجي يستخدم خدمة Google Drive المدمجة، يجب تفعيل واجهة برمجة التطبيقات Drive API في المشاريع العادية على السحابة الإلكترونية.
في مشروعك العادي على السحابة الإلكترونية، فعِّل Drive API:
- على جميع المستخدمين الذين سبق لهم تفويض النص البرمجي إعادة التفويض. في معظم الحالات، على جميع المستخدمين الذين سبق لهم منح الإذن للتطبيقات المرتبطة بالمشروع الجديد إعادة التفويض.
- في حال كان النص البرمجي مرتبطًا ببطاقة بيانات تطبيق على Google Workspace Marketplace، لن يتم نقل بطاقة بيانات تطبيقك والمستخدمين والمراجعات إلى المشروع الجديد. يجب إنشاء بطاقة بيانات تطبيق داخل المشروع الجديد ويجب على المستخدمين إعادة تثبيت تطبيقك. وللحصول على معلومات حول إنشاء بطاقة بيانات تطبيق جديدة، راجع نشر تطبيق.
- لا يمكنك إعادة تبديل نص برمجي إلى مشروع تلقائي. تحذف "برمجة التطبيقات" المشاريع التلقائية بعد إعداد النص البرمجي لاستخدام مشروع عادي.
التبديل إلى مشروع عادي مختلف على السحابة الإلكترونية
لتبديل المشروع الحالي على السحابة الإلكترونية للنص البرمجي إلى مشروع آخر على السحابة الإلكترونية، اتّبِع الخطوات التالية:
- إذا لم يكن لديك مشروع مناسب على السحابة الإلكترونية، يمكنك إنشاء مشروع باتّباع تعليمات إنشاء مشروع. اضبط اسم مشروع يسهل تذكّره حتى تتمكن من العثور عليه في صفحة إدارة الموارد في Google Cloud Console. تستخدم "برمجة التطبيقات" هذا الاسم عندما تطلب من المستخدمين السماح بالنص البرمجي.
- إذا كنت تريد استخدام مشروع حالي، افتح صفحة إدارة الموارد في Google Cloud Console وحدِّد موقع مشروع حالي لاستخدامه. يجب أن يكون لديك أدوار "متصفّح المشروع" و"محرّر تهيئة OAuth" أو الأدوار التي لها أذونات مكافئة للمشروع. لا يمكنك استخدام مشروع تم إنشاؤه تلقائيًا بواسطة "برمجة التطبيقات".
- حدِّد رقم المشروع لمشروعك على Google Cloud.
- افتح النص البرمجي الذي تريد استبدال مشروعه على السحابة الإلكترونية.
- على يمين الصفحة، انقر على إعدادات المشروع .
- ضمن مشروع Google Cloud Platform (GCP)، انقر على تغيير المشروع.
- أدخِل رقم المشروع الجديد وانقر على ضبط المشروع.
المشاريع على السحابة الإلكترونية ومساحات التخزين السحابي المشتركة
توفّر مساحات التخزين السحابي المشتركة (المعروفة سابقًا باسم مساحات التخزين السحابي المشتركة) مساحات مشتركة حيث يمكن لمجموعات مستخدمي Drive التعاون في مشاريع برمجة التطبيقات ومستندات Drive. تُعتبر مساحات التخزين السحابي المشتركة قيّمة عند تطوير النصوص البرمجية والإضافات وتطبيقات الويب مع فريق، لكنها تضع بعض القيود على ما يمكنك فعله باستخدام مشاريع السحابة الإلكترونية التلقائية القديمة.
توضّح قائمة القيود التالية كيفية تفاعل المشاريع على السحابة مع مساحات التخزين السحابي المشتركة:
- إذا كان مشروع النص البرمجي يستخدم مشروعًا عاديًا، لن تكون هناك أي قيود إضافية عند توفُّر مشروع النص البرمجي في مساحة تخزين سحابي مشتركة.
- إذا كان مشروع النص البرمجي يستخدم مشروعًا تلقائيًا تم إنشاؤه في 8 نيسان (أبريل) 2019 أو بعده، لن تُفرَض أي قيود إضافية عند توفُّر مشروع النص البرمجي في مساحة تخزين سحابي مشتركة.
- إذا كان مشروع النص البرمجي يستخدم مشروعًا تلقائيًا تم إنشاؤه قبل
8 نيسان (أبريل) 2019، ستسري القيود التالية أثناء توفُّر
مشروع النص البرمجي على مساحة تخزين سحابي مشتركة:
- لا يمكنك الوصول إلى المشروع التلقائي باستخدام واجهة مستخدم "برمجة التطبيقات" أو Google Cloud Console. يمنعك هذا الشرط من اتخاذ الإجراءات التي تتطلب الوصول المباشر إلى المشروع.
- لا يمكنك تفعيل الخدمات المتقدّمة. لتفعيل الخدمات المتقدمة، قم بالتبديل إلى مشروع قياسي.
- عند نقل مشروع حالي لبرمجة التطبيقات إلى مساحة تخزين سحابي مشتركة، تحظر Google الوصول إلى المشروع التلقائي على السحابة الإلكترونية. لا يزال بإمكانك الوصول إلى المشروع الافتراضي إذا كان لديك حق الوصول قبل النقل. على سبيل المثال، إذا أنشأت نصًا برمجيًا في مجلد "ملفاتي" ثم نقلته إلى مساحة تخزين سحابي مشتركة، سيظل بإمكانك الوصول إلى مشروع السحابة الإلكترونية لهذا النص البرمجي. قد لا يتمكّن المتعاونون في مساحة التخزين السحابي المشتركة من إجراء ذلك.
- يحتفظ النص البرمجي باسم المشروع على السحابة الإلكترونية الذي كان عليه قبل نقله إلى مساحة تخزين سحابي مشتركة. حتى في حال تغيير اسم المشروع في مساحة التخزين السحابي المشتركة، سيظلّ الاسم القديم ظاهرًا للمستخدمين الذين يسمحون بالنص البرمجي في مربعات حوار التفويض.
لتجنُّب القيود المذكورة أعلاه للنصوص البرمجية الأقدم، يمكنك التبديل إلى مشروع عادي.
الحصول على قائمة مشاريع "برمجة التطبيقات" في السحابة الإلكترونية
إذا كان لديك الإذن resourcemanager.projects.list
لمجلد مشروع "برمجة التطبيقات" في مؤسستك، يمكنك عرض جميع مشاريع "برمجة التطبيقات" العادية والتلقائية ضمن المجلد.
- افتَح صفحة إدارة الموارد في Google Cloud Console.
- بجانب مجلد برمجة التطبيقات، انسخ رقم التعريف.
- انقر على فلتر > رقم تعريف رئيسي والصِق رقم تعريف مجلد "برمجة التطبيقات".
حذف مشاريع "برمجة التطبيقات" على السحابة الإلكترونية
لحذف مشروع على السحابة الإلكترونية لبرمجة التطبيقات، اتّبِع الخطوات الواردة ضمن الحصول على قائمة بمشاريع السحابة الإلكترونية لبرمجة التطبيقات، واختَر المشروع الذي تريد حذفه وانقر على حذف.
لحذف مشروع لبرمجة تطبيقات Google باستخدام gcloud
، استخدِم الطلبات التالية.
gcloud projects list --filter='parent.id=APPS_SCRIPT_FOLDER_ID'
gcloud projects delete PROJECT_ID
لمزيد من المعلومات حول حذف المشاريع على السحابة الإلكترونية، يُرجى الاطّلاع على إيقاف (حذف) المشاريع.