مشاريع Google Cloud

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

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

المشاريع التلقائية على Google 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. للوصول إلى الافتراضي، انتقل إلى إعدادات مشروع النص البرمجي وانقر فوق المشروع الصف.

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

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

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

  • في حال حذف مشروع النص البرمجي أو تبديله لاستخدام مشروع عادي، يحذف النص البرمجي المشروع التلقائي المرفق بالنص البرمجي مع أي الإعدادات أو المعلومات التي تحتوي عليها.
  • إذا لم يتم تشغيل نص برمجي لمدة 180 يومًا أو أكثر، يمكن استخدام "برمجة تطبيقات 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 Cloud.

قد يُطلب منك قبول بنود الخدمة 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 لبنود الخدمة.

تنشئ المشاريع التلقائية على 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" أو والمجالات كأعضاء جدد.
  6. انقر على حفظ.

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

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

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

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

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

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

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

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

    تفعيل Drive API

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

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

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

  1. إذا لم يكن لديك مشروع مناسب على Cloud، أنشئ واحدًا من خلال اتّباع خطوات إنشاء مشروع على التعليمات قم بتعيين اسم مشروع يسهُل تذكّره حتى تتمكن من يمكنك العثور عليه في صفحة إدارة الموارد في Google Cloud Console. تستخدم "برمجة تطبيقات Google" هذا الاسم عندما يطلب من المستخدمين السماح بالنص البرمجي.
  2. إذا أردت استخدام مشروع حالي، افتح صفحة إدارة الموارد في Google Cloud Console. وتحديد موقع مشروع حالي لاستخدامه. يجب أن يتوفّر لديك أدوار "محرِّر المشروع" و"محرِّر إعدادات OAuth" أو الأدوار ذات ما يعادلها الأذونات الخاصة بـ مشروعك. لا يمكنك استخدام مشروع تم إنشاؤه تلقائيًا بواسطة التطبيقات. النص البرمجي.
  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. عند نقل مشروع حالي لبرمجة التطبيقات إلى مساحة تخزين سحابي مشتركة، تفرض قيودًا على الوصول إلى المشروع التلقائي على السحابة الإلكترونية. لا يزال بإمكانك الوصول إلى المشروع الافتراضي إذا كان لديك حق الوصول إليه قبل النقل. بالنسبة مثال، إذا أنشأت نصًا برمجيًا في مجلد "ملفاتي" ثم نقلت إلى مساحة تخزين سحابي مشتركة، إلا أنه سيظل بإمكانك الوصول إلى ملف النص البرمجي المشروع على السحابة الإلكترونية. قد لا يتمكن المتعاونون في مساحة التخزين السحابي المشتركة من إجراء ذلك.
    4. يحتفظ النص البرمجي باسم المشروع على السحابة الإلكترونية الذي كان عليه قبل أن يتم تم النقل إلى مساحة تخزين سحابي مشتركة. حتى في حال تغيير اسم المشروع على مساحة التخزين السحابي المشتركة، لا يزال بإمكان المستخدمين الذين فوّضوا النص البرمجي رؤية الاسم القديم في التفويض ومربعات الحوار.

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

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

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

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

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

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

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

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

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