مشاريع Google Cloud

تنظيم صفحاتك في مجموعات يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.

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

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

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

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

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

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

لا يمكن لمعظم المستخدمين تحديد موقع المشاريع التلقائية أو عرضها أو تعديلها في Google Cloud Console. يمكن للمشرفين ومستخدمي النطاق الذين لديهم الإذن resourcemanager.projects.list في مجلد Google Cloud الرئيسي عرض المشاريع التلقائية وضبطها.

  • بالنسبة إلى عملاء Google Workspace، تقع المشاريع التلقائية ضمن المجلد Organization root > system-gsuite > apps-script في التدرج الهرمي لموارد Google Cloud. لا تحذف هذه المجلدات. إذا فعلت ذلك، لن تستطيع النصوص البرمجية إنشاء مشاريع تلقائية ولن يتم تنفيذها بشكل صحيح.
  • بالنسبة إلى العملاء الذين لا يستخدمون Google Workspace، تكون المشاريع التلقائية غير مدرَجة في العرض الهرمي للموارد.

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

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

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

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

مشاريع Cloud Standard

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

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

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

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

المواقع العادية لمشروع Google Cloud

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

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

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

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

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

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

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

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

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

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

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

تحديد رقم التعريف &ورقم مشروع Google Cloud العادي

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

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

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

عرض سجلات Google Cloud وسجلّات الأخطاء في وحدة تحكم Google Cloud

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

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

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

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

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

إنشاء بيانات اعتماد بروتوكول OAuth

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

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

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

إضافة مالكين آخرين إلى مشروع عادي في Google Cloud

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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