قدّمت Earth Engine فئات حصص غير تجارية لحماية موارد الحوسبة المشتركة وضمان أداء موثوق للجميع. تستخدم المشاريع غير التجارية "فئة المجتمع" تلقائيًا، ولكن يمكنك تغيير فئة المشروع في أي وقت.

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

التحكّم في الوصول إلى الموارد

يمكنك مشاركة مواد العرض أو حصة الحوسبة في مشروعك المفعَّل على Earth Engine مع مستخدمي Earth Engine الآخرين على مستوى المشروع. يمكن مشاركة مواد عرض Earth Engine أو عمليات الحوسبة مع مستخدم آخر أو مجموعة من المستخدمين. إذا أردت المشاركة مع مجموعة من المستخدمين، يمكنك إنشاء مجموعة Google جديدة وتدوين عنوان بريدها الإلكتروني (المتاح من رابط "لمحة" في صفحة المجموعة). توضّح هذه الصفحة كيفية منح إذن الوصول إلى الموارد، سواء لفرد أو مجموعة، والأدوار والأذونات المطلوبة للأنشطة المختلفة.

ضبط استخدام خدمة Earth Engine

لاستخدام واجهة برمجة تطبيقات Earth Engine في مشروع على السحابة الإلكترونية، يجب تفعيل واجهة برمجة التطبيقات في المشروع، ويجب أن يمتلك المستخدم على الأقل الأذونات في دور عارض موارد Earth Engine (مزيد من المعلومات حول أدوار إدارة الهوية وإمكانية الوصول المحدّدة مسبقًا في Earth Engine). بالإضافة إلى ذلك، يجب أن يكون لدى المستخدم إذن serviceusage.services.use على الأقل في المشروع. يمكن منح هذا الإذن من خلال دور المالك أو المحرِّر في المشروع، أو من خلال دور مستهلك استخدام الخدمة المحدّد. سيظهر خطأ إذا لم يكن لدى المستخدم أذونات Earth Engine وأذونات استخدام الخدمة المطلوبة في المشروع المحدّد.

ضبط أذونات مواد العرض

ضبط الأذونات على مستوى مادة العرض

تتوفّر عدّة خيارات لتعديل الأذونات على مستوى مادة العرض.

استخدِم "مدير مواد العرض" في "أداة تعديل الرموز".
استخدام سطر أوامر Earth Engine
استخدِم مكتبة عملاء، مثل ee.data.setAssetAcl().
أو يمكنك استدعاء REST API مباشرةً.

ضبط أذونات مواد العرض على مستوى المشروع

تؤدي المشاركة على مستوى المشروع إلى ضبط الأذونات على جميع مواد العرض في مشروعك على السحابة الإلكترونية المفعَّل فيه Earth Engine دفعة واحدة.

يمكنك مشاركة مواد العرض على مستوى المشروع من خلال منح دور إدارة الهوية وإمكانية الوصول (IAM) المناسب في صفحة مشرف "إدارة الهوية وإمكانية الوصول" في مشروعك. تتوفّر أدوار محدّدة مسبقًا في "إدارة الهوية وإمكانية الوصول" في Earth Engine لمشاركة مواد عرض وموارد Earth Engine. يُرجى الاطّلاع على فهم الأدوار للحصول على نظرة عامة أكثر شمولاً حول أدوار "إدارة الهوية وإمكانية الوصول".

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

ضبط الأذونات على مستوى المشروع

لضبط الأذونات على مستوى المشروع، يمكنك إسناد دور "إدارة الهوية وإمكانية الوصول" (IAM) في المشروع إلى مستخدم أو مجموعة من المستخدمين:

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

عناصر التحكّم في خدمة سحابة VPC

يتوافق Earth Engine مع عناصر التحكّم في خدمة سحابة VPC، وهي ميزة أمان في Google Cloud تساعد المستخدمين في تأمين مواردهم والحدّ من مخاطر استخراج البيانات. تتيح إضافة الموارد إلى محيط خدمة VPC مزيدًا من التحكم في عمليات قراءة البيانات وكتابتها.

مزيد من المعلومات حول ميزات VPC-SC وإعداداتها

القيود

يؤدي تفعيل عناصر التحكّم في خدمة سحابة VPC لمواردك إلى فرض بعض القيود، وقد قدّمنا أمثلة على الحلول البديلة لها:

القيود	مثال على بديل
أداة تعديل الرموز غير متوافقة، ولن تسمح عناصر التحكّم في خدمة VPC باستخدامها مع الموارد والعملاء داخل محيط الخدمة.	استخدِم واجهة برمجة التطبيقات Python API في Earth Engine مع مكتبة `geemap`.
مواد العرض القديمة غير محمية من خلال عناصر التحكّم في خدمة VPC.	استخدِم مواد العرض المخزَّنة في المشاريع على السحابة الإلكترونية.
لا تتوافق ميزة "التصدير إلى Google Drive" مع "عناصر تحكّم VPC في الخدمة".	استخدِم وجهات التصدير الأخرى المتاحة، مثل Google Cloud Storage وBigQuery. يمكنك حفظ مواردك في Earth Engine من خلال تصدير بيانات النقطية أو الجدولية إلى مواد العرض.
تطبيقات Earth Engine غير متاحة للموارد والعملاء داخل محيط الخدمة.	ما مِن حلّ بديل.

لا يتوفّر استخدام Earth Engine مع الموارد داخل محيط خدمة سحابة VPC آمن إلا في خطط الأسعار الاحترافية والمميزة. ستؤدي محاولة استخدام واجهة برمجة تطبيقات Earth Engine مع مشروع آمن في VPC-SC مرتبط بخطة أسعار أساسية إلى حدوث خطأ. لمزيد من المعلومات حول أسعار Earth Engine، يُرجى الاطّلاع على المستندات الرسمية.

يمكنك العثور على مزيد من المعلومات حول "عناصر التحكّم في خدمة سحابة VPC" والقيود المفروضة عليها في المنتجات المتوافقة والقيود.

الأدوار والأذونات

توضّح الأقسام التالية الأذونات والأدوار المطلوبة لتنفيذ الأنشطة والوصول إلى موارد Earth Engine. يمكنك الاطّلاع على مستندات Google Cloud لمزيد من المعلومات حول أذونات وأدوار المشاريع على السحابة الإلكترونية.

أدوار "إدارة الهوية وإمكانية الوصول" المحدّدة مسبقًا في Earth Engine

يوفّر Earth Engine أدوارًا محدّدة مسبقًا تتيح درجات متفاوتة من التحكّم في موارد Earth Engine ضمن مشروع معيّن. هذه الأدوار هي:

الدور	العنوان	الوصف
`roles/earthengine.viewer`	عارض موارد Earth Engine	يمنح هذا الدور الإذن بعرض مواد العرض والمهام وإدراجها.
`roles/earthengine.writer`	كاتب موارد Earth Engine	يمنح هذا النطاق الإذن بقراءة مواد العرض وإنشائها وتعديلها وحذفها، واستيراد الصور والجداول، وقراءة المهام وتعديلها، وإجراء العمليات الحسابية التفاعلية، وإنشاء مهام تصدير طويلة الأمد.
`roles/earthengine.admin`	مشرف Earth Engine	يمنح هذا الدور الإذن بالوصول إلى جميع موارد Earth Engine، بما في ذلك تغيير عناصر التحكّم في الوصول إلى مواد عرض Earth Engine.
`roles/earthengine.appsPublisher`	ناشر تطبيقات Earth Engine	يمنح هذا الدور الإذن بإنشاء حساب خدمة لاستخدامه مع تطبيق Earth Engine، كما يمنح الإذن بتعديل وحذف التطبيقات المملوكة للمشروع ضمن مشروع على السحابة الإلكترونية.

يُرجى العِلم أنّه يمكنك ضبط دور بدائي أو مخصّص إذا كانت أدوار Earth Engine المحدّدة مسبقًا لا تلبي احتياجاتك. يمكنك الاطّلاع على حزمة الأذونات المرتبطة بكل دور من صفحة "أدوار إدارة الهوية وإمكانية الوصول" من خلال الفلترة حسب دور معيّن والنقر عليه.

تفعيل Earth Engine API

لتفعيل واجهة برمجة التطبيقات Earth Engine API في مشروع على السحابة الإلكترونية، يحتاج المستخدم إلى دور مشرف استخدام الخدمة (roles/serviceusage.serviceUsageAdmin) أو دور آخر يتضمّن إذن serviceusage.services.enable (مثل مالك المشروع أو المحرِّر).

الأذونات المطلوبة	`serviceusage.services.enable` `serviceusage.services.get`
الأدوار المقترَحة	مشرف استخدام الخدمة (`roles/serviceusage.serviceUsageAdmin`) أو المالك (`roles/owner`) أو محرِّر (`roles/editor`)

الوصول الكامل إلى واجهة برمجة تطبيقات Earth Engine

لمنح المستخدمين إمكانية الوصول الكامل إلى خدمة Earth Engine، سواء من خلال REST API مباشرةً أو من خلال "أداة تعديل الرموز" أو من خلال مكتبة برامج، سيحتاج المستخدمون إلى إذن لتنفيذ عمليات مثل:

تنفيذ تعبيرات Earth Engine
تنفيذ العمليات الحسابية المجمّعة (عمليات التصدير)
الحصول على نتائج تفاعلية (خرائط على الإنترنت وصور مصغّرة ورسوم بيانية وما إلى ذلك)
إنشاء/حذف مواد عرض Earth Engine
استخدام مصادقة OAuth من خلال مكتبة برمجية للعميل للاتصال بمنصة Earth Engine

الأذونات المطلوبة	`clientauthconfig.clients.listWithSecrets` `earthengine.assets.get` `earthengine.assets.getIamPolicy` `earthengine.assets.list` `earthengine.computations.create` `earthengine.operations.get` `earthengine.operations.list` `monitoring.timeSeries.list` `resourcemanager.projects.get` `resourcemanager.projects.list` `serviceusage.operations.get` `serviceusage.operations.list` `serviceusage.quotas.get` `serviceusage.services.get` `serviceusage.services.list` `serviceusage.services.use`
الأدوار المقترَحة	مستهلك استخدام الخدمة (`roles/serviceusage.serviceUsageConsumer`) وأحد الأدوار التالية: Earth Engine Resource Viewer (`roles/earthengine.viewer`) أو كاتب موارد Earth Engine (`roles/earthengine.writer`) أو مشرف موارد Earth Engine (`roles/earthengine.admin`) محرِّر إعدادات OAuth (`roles/oauthconfig.editor`) مطلوب أيضًا للمستخدمين الذين يصلون إلى Earth Engine من خلال بيئة دفتر ملاحظات ويستخدمون "مصادقة دفتر الملاحظات". يُرجى الاطّلاع على مصادقة دفتر ملاحظات Colab أو JupyterLab لمزيد من التفاصيل.
ملاحظات	يتطلّب Google Cloud دور مستهلك استخدام الخدمة لاستخدام المشروع كمشروع نشط عند طلب واجهات برمجة التطبيقات، وسيتعذّر تنفيذ `ee.Initialize(project=X)` بدون هذا الإذن في المشروع X. بالإضافة إلى ذلك، يمكنك اختيار هذا المشروع في Cloud Console لعرض استخدامك للموارد.

مشاركة مواد العرض فقط

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

إدارة مشاريع إنشاء الطرق

إدراج المشاريع المتاحة وعرضها

يحدث ذلك عند استخدام "أداة تعديل الرموز" لتصفُّح المشاريع المتاحة.

الأذونات المطلوبة	`resourcemanager.projects.get` `resourcemanager.folders.list` `resourcemanager.folders.get` ‫`resourcemanager.organizations.get` (غير شائع)
الأدوار المقترَحة	مُشاهد (`roles/viewer`) أو مُشاهد موارد Earth Engine (`roles/earthengine.viewer`) في المشاريع ذات الصلة أو متصفّح (`roles/browser`، يُنصح به لحالات المؤسسات المتقدّمة) مشاهد المجلد (`roles/resourcemanager.folderViewer`) في المجلدات ذات الصلة

اختيار مشروع لاستخدامه في "أداة تعديل الرموز"

الأذونات المطلوبة

resourcemanager.projects.get
serviceusage.services.get

إذا لم يسبق إعداد المشروع

عند اختيار مشروع لأول مرة من خلال "أداة تعديل الرموز"، تتم تهيئة المشروع لاستخدامه مع Earth Engine. إذا لم يسبق لك إجراء ذلك، ستحتاج إلى هذه الأدوار لإكمال عملية الإعداد بنجاح.

resourcemanager.projects.update و
serviceusage.services.enable

الأدوار المقترَحة

مُشاهد (roles/viewer) أو
عارض موارد Earth Engine (roles/earthengine.viewer) و
مستهلك استخدام الخدمة (roles/serviceusage.serviceUsageConsumer)

الأدوار الإضافية (إذا لم يسبق إعداد المشروع)

محرِّر (roles/editor) أو
ناقل المشروع (roles/resourcemanager.projectMover) و
مشرف إدارة الهوية وإمكانية الوصول للمشروع (roles/resourcemanager.projectIamAdmin) و
مشرف استخدام الخدمة (roles/serviceusage.serviceUsageAdmin)

إنشاء مشروع من خلال "أداة تعديل الرموز"

الأذونات المطلوبة	`resourcemanager.projects.get` `resourcemanager.projects.create` `resourcemanager.projects.update` `serviceusage.services.get` `serviceusage.services.enable`
الأدوار المقترَحة	محرِّر (`roles/editor`) أو ناقل المشروع (`roles/resourcemanager.projectMover`) و منشئ المشروع (`roles/resourcemanager.projectCreator`) و مشرف استخدام الخدمة (`roles/serviceusage.serviceUsageAdmin`)
ملاحظات	قد لا تمنحك مؤسستك دور المحرِّر، لذا قد تحتاج إلى الأدوار الأكثر دقة. يجب استخدام Project Mover لتغطية إذن `projects.update`.

اختيار المستوى غير التجاري

تتعلّق الأذونات والأدوار المقترَحة التالية بإعدادات الفئة غير التجارية.

اختيار المستوى

الأذونات المطلوبة	`earthengine.config.update`
الأدوار المقترَحة	Earth Engine Resource Writer (`roles/earthengine.writer`)

ربط حساب فوترة بمشروع

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

الأذونات المطلوبة
حساب الفوترة	`billing.resourceAssociations.create`
مشروع على السحابة الإلكترونية	`resourcemanager.projects.createBillingAssignment`
الأدوار المقترَحة
حساب الفوترة	مستخدم حساب الفوترة (`roles/billing.user`)
مشروع على السحابة الإلكترونية	مدير فوترة المشروع (`roles/billing.projectManager`)

تسجيل مشروع تجاري

تتعلّق الأذونات التالية بتسجيل المشاريع للاستخدام المدفوع.

الأذونات المطلوبة
حساب الفوترة	`billing.accounts.get` `billing.subscriptions.list` بالإضافة إلى ذلك: ‫`billing.subscriptions.create` (لإنشاء خطة "أساسية" أو "احترافية" جديدة)
مشروع على السحابة الإلكترونية	`earthengine.config.update` `serviceusage.services.get` `serviceusage.services.enable`
الأدوار المقترَحة
حساب الفوترة	مُشاهد حساب الفوترة (`roles/billing.viewer`)، لإنشاء خطة محدودة جديدة مشرف حساب الفوترة (`roles/billing.admin`)، لإنشاء خطة "أساسية" أو "احترافية" جديدة
مشروع على السحابة الإلكترونية	Earth Engine Resource Writer (`roles/earthengine.writer`) مشرف استخدام الخدمة (`roles/serviceusage.serviceUsageAdmin`)

إدارة خطة Earth Engine التجارية

تتعلّق الأذونات التالية بإدارة خطط أسعار Earth Engine.

الأذونات المطلوبة
في حساب الفوترة

billing.accounts.get
billing.subscriptions.list

بالإضافة إلى ذلك:

‫billing.subscriptions.create (للترقية من خطة محدودة إلى خطة أساسية أو احترافية)
‫billing.subscriptions.update (للتبديل بين خطتَي Basic وProfessional، أو الرجوع من خطة Basic أو Professional إلى Limited)

الأدوار المقترَحة
في حساب الفوترة

مُشاهد حساب الفوترة (roles/billing.viewer)، للاطّلاع على خطة Earth Engine الحالية
مشرف حساب الفوترة (roles/billing.admin)، لتغيير خطة Earth Engine

إدارة المهام المجمّعة

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

عرض حدود المهام المجمّعة على مستوى المشروع

الأذونات المطلوبة
في حساب Cloud earthengine.config.get

ضبط حدود المهام المجمّعة على مستوى المشروع

الأذونات المطلوبة في حساب Cloud	`earthengine.config.update` ملاحظة: يشمل هذا الإذن أيضًا الاطّلاع على الحدود القصوى على مستوى الخطة التي تم ضبطها في حساب الفوترة.
الأذونات المطلوبة في حساب الفوترة	`billing.subscriptions.list`

إدارة التطبيقات

عرض معلومات التطبيق

الأذونات المطلوبة	`iam.serviceAccounts.get` ‫`iam.serviceAccounts.getIamPolicy`، إذا كان التطبيق محظورًا (أقل شيوعًا)
الأدوار المقترَحة	مشاهد (`roles/viewer`) أو ناشر تطبيقات Earth Engine (`roles/earthengine.appsPublisher`)

نشر التطبيق أو تحديثه

الأذونات المطلوبة	`iam.serviceAccounts.get` `iam.serviceAccounts.create` `iam.serviceAccounts.enable` `iam.serviceAccounts.getIamPolicy` `iam.serviceAccounts.setIamPolicy` ‫`iam.serviceAccounts.disable`، إذا تم نقل التطبيق من مشروع إلى آخر (غير شائع)
الأدوار المقترَحة	ناشر تطبيقات Earth Engine (`roles/earthengine.appsPublisher`) أو مشرف حساب الخدمة (`roles/iam.serviceAccountAdmin`)
ملاحظات	بالإضافة إلى ذلك، تعرّف حسابات خدمة تطبيق Earth Engine عن نفسها لخوادم Earth Engine من خلال تقديم رمز الدخول OAuth. لذلك، تتم إضافة هويات معيّنة أثناء إنشاء التطبيق كـ منشئ الرمز المميّز لحساب الخدمة (`roles/iam.serviceAccountTokenCreator`) في حسابات الخدمة. في حال استخدام تطبيق Earth Engine متاح للجميع، تكون الهوية التي تم منحها هذا الدور هي `earth-engine-public-apps@appspot.gserviceaccount.com`، وفي حال استخدام تطبيقات محظورة، تكون الهوية هي مجموعة Google التي تم ضبطها من قِبل منشئ التطبيق لفرض قيود على الوصول.

حذف تطبيق

الأذونات المطلوبة	`iam.serviceAccounts.disable`
الأدوار المقترَحة	ناشر تطبيقات Earth Engine (`roles/earthengine.appsPublisher`) أو مشرف حساب الخدمة (`roles/iam.serviceAccountAdmin`)