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