إثبات ملكية النطاق الحسّاس

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

يعتمد تطبيق هذا الشرط على تطبيقك في الغالب على عاملَين:

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

عند استخدام OAuth 2.0 للحصول على إذن من حساب Google للوصول إلى بياناته، يمكنك استخدام سلاسل تُسمى النطاقات لتحديد نوع البيانات التي تريد الوصول إليها نيابةً عنه. إذا كان تطبيقك يطلب نطاقات مصنّفة على أنّها حسّاسة أو محظورة، قد تحتاج إلى إكمال عملية التحقّق من المعلنين ما لم يكن استخدام تطبيقك مؤهلاً للحصول على استثناء.

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

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

احرص على تخصيص الوقت اللازم لإكمال عملية التحقّق في خطة إطلاق تطبيقك أو أي ميزات جديدة تتطلّب نطاقًا جديدًا. قد تستغرق عملية التحقّق من النطاقات الحسّاسة مدة تصل إلى 10 أيام. يُرجى العِلم أنّ تطبيقك قد يكون مؤهلاً لإكمال عملية التحقّق من العلامة التجارية كجزء من طلب التحقّق من النطاق الحسّاس.

---

فهم النطاقات الحسّاسة

تتطلّب النطاقات الحسّاسة مراجعة من Google قبل أن يتمكّن أي حساب على Google من منح إذن الوصول. قد يحظر مشرفو مؤسسات Google Workspace الوصول إلى النطاقات الحسّاسة لمنع وصول معرّفات عملاء OAuth التي لا تصنّفها المؤسسة صراحةً على أنّها موثوقة.

فهم استخدامك للنطاقات

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

الشكل 1: مثال على نطاق حسّاس يظهر في صفحة نطاقات إعدادات شاشة طلب الموافقة المتعلّقة ببروتوكول OAuth.

---

خطوات الاستعداد لعملية التحقّق

على جميع التطبيقات التي تستخدم Google APIs لطلب الوصول إلى البيانات تنفيذ الخطوات التالية لإكمال عملية التحقّق من العلامة التجارية:

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

متطلبات الصفحة الرئيسية للتطبيق

يجب أن تستوفي صفحتك الرئيسية المتطلبات التالية:

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

متطلبات رابط سياسة الخصوصية للتطبيق

يجب التأكّد من أنّ سياسة الخصوصية في تطبيقك تستوفي المتطلبات التالية:

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

كيفية إرسال تطبيقك لإثبات ملكية العلامة التجارية

ينظّم مشروع Google Cloud Console جميع موارد Cloud Console. يتألف المشروع من مجموعة من حسابات Google المرتبطة التي لديها الإذن بتنفيذ عمليات المشروع، ومجموعة من واجهات برمجة التطبيقات المفعَّلة، وإعدادات الفوترة والمصادقة والمراقبة لواجهات برمجة التطبيقات هذه. على سبيل المثال، يمكن أن يحتوي المشروع على عميل OAuth واحد أو أكثر، ويمكن ضبط واجهات برمجة التطبيقات لاستخدامها من قِبل هؤلاء العملاء، وضبط شاشة طلب الموافقة على OAuth التي تظهر للمستخدمين قبل أن يمنحوا الإذن بالوصول إلى تطبيقك.

إذا لم يكن أي من عملاء OAuth جاهزًا للإنتاج، ننصحك بحذفه من المشروع الذي يطلب التحقّق. ويمكنك إجراء ذلك في صفحة "العملاء".

لإرسال طلب إثبات الهوية، يُرجى اتّباع الخطوات التالية:

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

5. في مربّع الحوار الاختيار من الذي يظهر، اختَر مشروعك. إذا لم تتمكّن من العثور على مشروعك ولكنك تعرف رقم تعريف المشروع، يمكنك إنشاء عنوان URL في المتصفّح بالتنسيق التالي:

   https://console.developers.google.com/auth/branding?project=[PROJECT_ID]
   

   استبدِل [PROJECT_ID] برقم تعريف المشروع الذي تريد استخدامه.

6. في صفحة الهوية البصرية للعلامة التجارية، قدِّم معلومات الهوية البصرية للعلامة التجارية الخاصة بتطبيقك، بما في ذلك اسم التطبيق وشعاره ومعلومات الاتصال بالمطوّر والروابط ذات الصلة. يتم حفظ أي تغييرات تجريها كـ مسودة هوية بصرية.

7. انقر على الزر التحقّق من الهوية البصرية للعلامة التجارية لبدء عملية التقييم. تكتمل المراجعة المبرمَجة عادةً في غضون بضع دقائق.

   ملاحظة: لا يُسمح بإجراء تعديلات على الهوية البصرية للعلامة التجارية أثناء عملية التحقّق. لإجراء تغييرات على الهوية البصرية للعلامة التجارية، عليك أولاً إلغاء أي عملية تحقق جارية من خلال النقر على الزر إلغاء.

8. بعد اكتمال التقييم، راجِع الحالة. في حال نجاح العملية، تتغيّر الحالة إلى جاهز للنشر. إذا تعذّر إكمال عملية التحقّق التلقائية، يمكنك الاطّلاع على المشاكل التي تم رصدها وحلّها أو طلب إجراء مراجعة يدوية.

9. انقر على الزر نشر الهوية البصرية لنشر الهوية البصرية الجديدة.

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

10. إذا كان تطبيقك يتطلّب أيضًا التحقّق من النطاقات الحساسة أو المحظورة، انتقِل إلى مركز التحقّق من OAuth لتتبُّع حالة الوصول إلى البيانات وتقديم أي معلومات إضافية مطلوبة، مثل فيديو توضيحي. يُرجى العِلم أنّه يجب أن تكون حالة الهوية البصرية للعلامة التجارية منشورة قبل أن تتمكّن من طلب التحقّق من الوصول إلى البيانات.

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

12. يُرجى تقديم ما يصل إلى ثلاثة روابط تؤدي إلى أي مستندات ذات صلة بالميزات المرتبطة في تطبيقك.

13. قدِّم أي معلومات إضافية مطلوبة عن تطبيقك في الخطوات اللاحقة.

    1. يجب إعداد مبرّر مفصّل لكل نطاق حسّاس مطلوب، بالإضافة إلى شرح لسبب عدم كفاية النطاق الأضيق. على سبيل المثال: "سيستخدم تطبيقي https://www.googleapis.com/auth/calendar لعرض بيانات تقويم Google الخاص بالمستخدم على شاشة الجدولة في تطبيقي. يتيح ذلك للمستخدمين إدارة جداولهم الزمنية من خلال تطبيقي ومزامنة التغييرات مع تقويم Google الخاص بهم".
    2. يُرجى إعداد فيديو يوضّح بالكامل كيفية بدء المستخدم لمنح إذن الوصول إلى النطاقات المطلوبة، ويعرض بالتفصيل كيفية استخدام النطاقات الحسّاسة والمحظورة التي تم منحها في التطبيق. يُرجى تحميل الفيديو إلى "استوديو YouTube" وضبط مستوى عرضه على غير مُدرَج. يجب تقديم رابط يؤدي إلى الفيديو التوضيحي في حقل رابط YouTube.
       1. اعرض عملية منح الإذن باستخدام OAuth التي سيراها المستخدمون، باللغة الإنجليزية. ويشمل ذلك مسار الموافقة ومسار تسجيل الدخول إذا كنت تستخدم ميزة "تسجيل الدخول باستخدام حساب Google".
       2. أظهِر أنّ شاشة طلب الموافقة المتعلّقة ببروتوكول OAuth تعرض اسم التطبيق بشكل صحيح.
       3. يجب إظهار أنّ شريط عناوين المتصفّح في شاشة طلب الموافقة عبر OAuth يتضمّن معرّف عميل OAuth الخاص بتطبيقك بشكل صحيح.
       4. لتوضيح كيفية استخدام البيانات، اعرض الوظائف التي يتم تفعيلها من خلال كل نطاق حسّاس تطلبه.

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

استثناءات من متطلبات التحقّق

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

الاستخدام الشخصي

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

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

المشاريع المستخدَمة في مستويات التطوير أو الاختبار أو الإعداد

للالتزام بسياسات Google OAuth 2.0، ننصحك بإنشاء مشاريع مختلفة لبيئات الاختبار وبيئة التشغيل الفعلي. ننصحك بإرسال تطبيقك للتحقّق منه فقط إذا أردت إتاحته لأي مستخدم لديه حساب Google. لذلك، إذا كان تطبيقك في مرحلة التطوير أو الاختبار أو الإعداد، لن يكون التحقّق مطلوبًا.

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

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

الشكل 2 شاشة تحذير المختبِر

البيانات التي تملكها الخدمة فقط

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

لفهم المقصود بحسابات الخدمة، يُرجى الاطّلاع على حسابات الخدمة في مستندات Google Cloud. للحصول على تعليمات حول كيفية استخدام حساب خدمة، يُرجى الاطّلاع على استخدام OAuth 2.0 لتطبيقات الخادم إلى الخادم.

الاستخدام الداخلي فقط

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

• مزيد من المعلومات حول التطبيقات العامة والداخلية
• يمكنك التعرّف على كيفية وضع علامة على تطبيقك بأنّه داخلي في قسم الأسئلة الشائعة كيف يمكنني وضع علامة على تطبيقي بأنّه داخلي فقط؟

التثبيت على مستوى النطاق

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

تعرَّف على كيفية جعل تطبيقك متاحًا للتثبيت على مستوى النطاق في قسم الأسئلة الشائعة يضم تطبيقي مستخدمين لديهم حسابات عمل من نطاق Google Workspace آخر.