مشاريع Google Cloud

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

خصائص مشروع Google Cloud العادية

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

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

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

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

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

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

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

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

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

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

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

تحديد رقم التعريف (amp) ورقم مشروع Google Cloud العادي

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

الحصول على قائمة بمشاريع "برمجة التطبيقات" في Google Cloud

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

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

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

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

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

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

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