يجب أن تتحقّق جميع التطبيقات التي تصل إلى Google APIs من أنّها تمثّل هويتها والغرض منها بدقة كما هو محدّد في سياسة بيانات المستخدمين الخاصة بخدمات واجهة برمجة التطبيقات من Google. لحمايتك وحماية المستخدمين المشتركين في Google وتطبيقك، قد تحتاج شاشة طلب الموافقة والتطبيق إلى التحقّق من Google.
يجب التحقّق من تطبيقك إذا كان يستوفي جميع المعايير التالية:
- في Google API Console، يتم ضبط إعدادات تطبيقك على نوع مستخدم خارجي وحالة نشر منشور. يعني ذلك أنّ تطبيقك في مرحلة الإصدار العلني ومتاح لأي مستخدم لديه حساب على Google.
- إذا أردت أن يعرض تطبيقك شعارًا أو اسمًا معروضًا على شاشة طلب الموافقة على OAuth
إذا أثبتّ صحة معلومات العلامة التجارية لتطبيقك، يمكنك زيادة احتمالية تعرُّف المستخدم على علامتك التجارية وقراره بمنح الإذن بالوصول إلى تطبيقك. يمكن أن يؤدي إثبات صحة معلومات العلامة التجارية أيضًا إلى تقليل عمليات الإبطال لاحقًا عندما يراجع المستخدم أو مشرف Google Workspace التطبيقات والخدمات التابعة لجهات خارجية التي يمكنها الوصول إلى الحساب. تستغرق عملية التحقّق التلقائي من العلامة التجارية عادةً بضع دقائق بعد النقر على الزر التحقّق من العلامة التجارية. في بعض الحالات، عندما يتعذّر تحديد النتيجة تلقائيًا، قد يخضع تطبيقك لعملية مراجعة يدوية تستغرق عادةً من يومَين إلى 3 أيام عمل.
إذا لم يتم التحقّق من معلومات العلامة التجارية لتطبيقك، قد يؤدي ذلك إلى انخفاض ثقة المستخدمين في طلبك للحصول على بياناتهم، ما قد يؤدي إلى تقليل تفويضات المستخدمين وزيادة عمليات الإبطال لاحقًا.
شاشة طلب الموافقة المتعلّقة ببروتوكول OAuth
تُعلم شاشة طلب الموافقة المستخدمين بالجهة التي تطلب الوصول إلى بياناتهم ونوع البيانات التي يحتاج تطبيقك إلى الوصول إليها نيابةً عنهم، كما هو موضّح في المربّع 2 من الشكل 1.
عندما يخضع تطبيقك لعملية التحقّق من العلامة التجارية ويحصل على الموافقة، من المرجّح أن يفهم الحساب الذي يمنح الإذن هوية تطبيقك وسياسات بيانات المستخدمين بشكل واضح. يساعد هذا الفهم الواضح في زيادة احتمال موافقة صاحب الحساب على طلباتك ومواصلة منحك إذن الوصول إلى حسابه عند مراجعة عمليات الإبطال المحتملة في صفحة حساب Google. يتم ملء المكوّنات التالية بالمحتوى الذي تضبطه في صفحة الهوية البصرية للعلامة التجارية في OAuth ضمن Cloud Console:
- اسم تطبيقك وشعاره (كما هو موضّح في المربّع 1 من الشكل 1)
- عنوان البريد الإلكتروني المخصّص لدعم المستخدمين، والذي يظهر بعد اختيار اسم تطبيقك (المربّع 2 في الشكل 1)
- روابط تؤدي إلى سياسة الخصوصية وبنود الخدمة (المربّع 3 في الشكل 1)
النطاقات المسموح بها
كجزء من عملية التحقّق من العلامة التجارية، تطلب Google التحقّق من جميع النطاقات المرتبطة بشاشة طلب الموافقة عبر OAuth وبيانات الاعتماد الخاصة بالتطبيق. نطلب منك إثبات ملكية مكوّن النطاق المتاح للتسجيل في لاحقة علنية: "النطاق الخاص الأعلى مستوى". على سبيل المثال، تطلب شاشة طلب الموافقة عبر OAuth التي تم ضبطها باستخدام الصفحة الرئيسية للتطبيق https://sub.example.com/product من صاحب الحساب إثبات ملكية النطاق example.com.
يجب أن يحتوي قسم النطاقات المصرَّح بها في محرِّر شاشة طلب الموافقة على OAuth على النطاقات الخاصة من المستوى الأعلى المستخدَمة في معرّفات الموارد المنتظمة (URI) في قسم نطاق التطبيق. وتشمل هذه النطاقات الصفحة الرئيسية للتطبيق وسياسة الخصوصية وبنود الخدمة. يجب أن يتضمّن قسم النطاقات المسموح بها أيضًا معرّفات الموارد المنتظمة (URI) لإعادة التوجيه أو مصادر JavaScript المسموح بها في أنواع تطبيقات OAuth في "تطبيق الويب".
أثبِت ملكية نطاقاتك المعتمَدة باستخدام Google Search Console. يجب ربط حساب Google الذي يمتلك أذونات المالك لنطاق معيّن بمشروع API Console الذي يستخدم هذا النطاق المصرَّح به. لمزيد من المعلومات حول عمليات تأكيد النطاق في Google Search Console، يُرجى الاطّلاع على مقالة تأكيد ملكية موقعك الإلكتروني.
خطوات الاستعداد لعملية التحقّق
على جميع التطبيقات التي تستخدم Google APIs لطلب الوصول إلى البيانات تنفيذ الخطوات التالية لإكمال عملية التحقّق من العلامة التجارية:
- تأكَّد من أنّ تطبيقك لا يندرج ضمن أي من حالات الاستخدام الواردة في قسم استثناءات متطلبات التحقّق.
- يجب التأكّد من أنّ تطبيقك يلتزم بمتطلبات العلامة التجارية الخاصة بواجهات برمجة التطبيقات أو المنتج المرتبط بها. على سبيل المثال، يمكنك الاطّلاع على إرشادات بناء هوية العلامة التجارية لنطاقات "تسجيل الدخول باستخدام حساب Google".
- أثبِت ملكية النطاقات المعتمَدة لمشروعك في Google Search Console. استخدِم حساب Google مرتبطًا بمشروعك على API Console بصفتك مالكًا أو محررًا.
- تأكَّد من أنّ جميع معلومات الهوية البصرية للعلامة التجارية على شاشة طلب الموافقة على OAuth، مثل اسم التطبيق والبريد الإلكتروني المخصّص للدعم ومعرّف الموارد المنتظم (URI) للصفحة الرئيسية ومعرّف الموارد المنتظم (URI) لسياسة الخصوصية وما إلى ذلك، تمثّل هوية التطبيق بدقة.
متطلبات الصفحة الرئيسية للتطبيق
يجب أن تستوفي صفحتك الرئيسية المتطلبات التالية:
- يجب أن تكون صفحتك الرئيسية متاحة للجميع، وليس فقط للمستخدمين الذين سجّلوا الدخول إلى موقعك الإلكتروني.
- يجب أن تكون صلة صفحتك الرئيسية بالتطبيق قيد المراجعة واضحة.
- لا تُعتبر الروابط المؤدية إلى بطاقة بيانات تطبيقك على "متجر Google Play" أو صفحته على Facebook صفحات رئيسية صالحة للتطبيق.
متطلبات رابط سياسة الخصوصية للتطبيق
يجب التأكّد من أنّ سياسة الخصوصية في تطبيقك تستوفي المتطلبات التالية:
- يجب أن تكون سياسة الخصوصية مرئية للمستخدمين، وأن تتم استضافتها ضمن النطاق نفسه الذي تتبعه الصفحة الرئيسية لتطبيقك، وأن يتم ربطها بشاشة طلب الموافقة عبر OAuth في Google API Console. يُرجى العِلم أنّ الصفحة الرئيسية يجب أن تتضمّن وصفًا لوظائف التطبيق، بالإضافة إلى روابط تؤدي إلى سياسة الخصوصية وبنود الخدمة الاختيارية.
- يجب أن تفصح سياسة الخصوصية عن الطريقة التي يصل بها تطبيقك إلى بيانات مستخدمي Google أو يستخدمها أو يخزّنها أو يشاركها. يجب أن يقتصر استخدامك لبيانات مستخدمي Google على الممارسات التي تفصح عنها سياسة الخصوصية المنشورة.
كيفية إرسال تطبيقك لإثبات ملكية العلامة التجارية
يتم تنظيم جميع موارد Cloud Console من خلال مشروع Google Cloud Console. يتألف المشروع من مجموعة من حسابات Google المرتبطة التي لديها الإذن بتنفيذ عمليات المشروع، ومجموعة من واجهات برمجة التطبيقات المفعَّلة، وإعدادات الفوترة والمصادقة والمراقبة لواجهات برمجة التطبيقات هذه. على سبيل المثال، يمكن أن يحتوي المشروع على عميل OAuth واحد أو أكثر، ويمكن ضبط واجهات برمجة التطبيقات لاستخدامها من قِبل هؤلاء العملاء، وضبط شاشة طلب الموافقة على OAuth التي تظهر للمستخدمين قبل أن يمنحوا الإذن بالوصول إلى تطبيقك.
إذا لم يكن أي من عملاء OAuth جاهزًا للإنتاج، ننصحك بحذفه من المشروع الذي يطلب التحقّق. ويمكنك إجراء ذلك في صفحة "العملاء".
لإرسال طلب إثبات الهوية، يُرجى اتّباع الخطوات التالية:
- تأكَّد من أنّ تطبيقك يلتزم ببنود خدمة Google APIs وسياسة بيانات المستخدمين الخاصة بخدمات واجهة برمجة التطبيقات من Google.
- يجب الحرص على تحديث أدوار المالك والمحرِّر للحسابات المرتبطة بمشروعك، بالإضافة إلى عنوان البريد الإلكتروني المخصّص لدعم المستخدمين في شاشة طلب الموافقة المتعلّقة ببروتوكول OAuth ومعلومات الاتصال بالمطوّر في Cloud Console. يضمن ذلك إبلاغ الأعضاء المعنيين في فريقك بأي متطلبات جديدة.
- انتقِل إلى صفحة الهوية البصرية في Cloud Console OAuth.
- انقر على الزر أداة اختيار المشروع.
في مربّع الحوار الاختيار من الذي يظهر، اختَر مشروعك. إذا لم تتمكّن من العثور على مشروعك ولكنك تعرف رقم تعريف المشروع، يمكنك إنشاء عنوان URL في المتصفّح بالتنسيق التالي:
https://console.developers.google.com/auth/branding?project=[PROJECT_ID]
استبدِل [PROJECT_ID] برقم تعريف المشروع الذي تريد استخدامه.
في صفحة الهوية البصرية للعلامة التجارية، قدِّم معلومات الهوية البصرية للعلامة التجارية الخاصة بتطبيقك، بما في ذلك اسم التطبيق وشعاره ومعلومات الاتصال بالمطوّر والروابط ذات الصلة. يتم حفظ أي تغييرات تجريها كـ مسودة هوية بصرية.
انقر على الزر التحقّق من الهوية البصرية للعلامة التجارية لبدء عملية التقييم. تكتمل المراجعة المبرمَجة عادةً في غضون بضع دقائق.
بعد اكتمال التقييم، راجِع الحالة. في حال نجاح العملية، تتغيّر الحالة إلى جاهز للنشر. إذا تعذّر إكمال عملية التحقّق التلقائية، يمكنك الاطّلاع على المشاكل التي تم رصدها وحلّها أو طلب إجراء مراجعة يدوية.
انقر على الزر نشر الهوية البصرية لنشر الهوية البصرية الجديدة.
إذا كان تطبيقك يتطلّب أيضًا التحقّق من النطاقات الحساسة أو المحظورة، يُرجى الانتقال إلى مركز التحقّق من OAuth لتتبُّع حالة الوصول إلى البيانات وتقديم أي معلومات إضافية مطلوبة، مثل فيديو توضيحي. يُرجى العِلم أنّه يجب أن تكون حالة الهوية البصرية لعلامتك التجارية منشورة قبل أن تتمكّن من طلب التحقّق من إمكانية الوصول إلى البيانات.
استخدِم الزر إضافة نطاقات أو إزالتها للإفصاح عن جميع النطاقات التي يطلبها تطبيقك. تتم تعبئة مجموعة أولية من النطاقات اللازمة لميزة "تسجيل الدخول باستخدام حساب Google" مسبقًا في قسم النطاقات غير الحسّاسة. يتم تصنيف النطاقات المضافة على أنّها غير حساسة أو حساسة أو محدودة.
يُرجى تقديم ما يصل إلى ثلاثة روابط تؤدي إلى أي مستندات ذات صلة بالميزات المرتبطة في تطبيقك.
قدِّم أي معلومات إضافية مطلوبة عن تطبيقك في الخطوات اللاحقة.
بعد نشر هوية علامتك التجارية أو إرسال طلب للوصول إلى البيانات، قد يتواصل معك فريق الثقة والأمان في Google عبر البريد الإلكتروني لطلب أي معلومات إضافية أو خطوات يجب إكمالها. يُرجى مراجعة عناوين بريدك الإلكتروني في قسم معلومات الاتصال بالمطوّر وعنوان البريد الإلكتروني المخصّص للدعم في شاشة طلب الموافقة عبر OAuth للاطّلاع على طلبات الحصول على معلومات إضافية. يمكنك أيضًا الاطّلاع على صفحات "العلامة التجارية" أو "مركز التحقّق" في مشروعك للتأكّد من حالة المراجعة الحالية لمشروعك، بما في ذلك ما إذا كانت عملية المراجعة متوقفة مؤقتًا في انتظار ردّك.
استثناءات من متطلبات التحقّق
إذا كان سيتم استخدام تطبيقك في أي من السيناريوهات الموضحة في الأقسام التالية، فلن تحتاج إلى إرساله للمراجعة.
الاستخدام الشخصي
من حالات الاستخدام أن تكون أنت المستخدم الوحيد لتطبيقك أو أن يكون تطبيقك مستخدَمًا من قِبل عدد قليل من المستخدمين الذين تعرفهم جميعًا شخصيًا. قد لا تمانع أنت والعدد المحدود من المستخدمين لديك في تخطّي شاشة التطبيق الذي لم يتم التحقّق منه ومنح حساباتك الشخصية إذن الوصول إلى تطبيقك.
المشاريع المستخدَمة في مستويات التطوير أو الاختبار أو الإعداد
للالتزام بسياسات Google OAuth 2.0، ننصحك بإنشاء مشاريع مختلفة لبيئات الاختبار وبيئة التشغيل الفعلي. ننصحك بإرسال تطبيقك للتحقّق منه فقط إذا أردت إتاحته لأي مستخدم لديه حساب Google. لذلك، إذا كان تطبيقك في مرحلة التطوير أو الاختبار أو الإعداد، لن يكون التحقّق مطلوبًا.
إذا كان تطبيقك في مرحلة التطوير أو الاختبار، يمكنك ترك حالة النشر على الإعداد التلقائي الاختبار. يعني هذا الإعداد أنّ تطبيقك لا يزال قيد التطوير ومتاحًا فقط للمستخدمين الذين تضيفهم إلى قائمة المستخدمين التجريبيين. يجب إدارة قائمة حسابات Google المشاركة في تطوير تطبيقك أو اختباره.
البيانات التي تملكها الخدمة فقط
إذا كان تطبيقك يستخدم حساب خدمة للوصول إلى بياناته فقط، ولا يصل إلى أي بيانات مستخدم (مرتبطة بحساب Google)، فلن تحتاج إلى إرسال طلب للتحقّق من التطبيق.
لفهم المقصود بحسابات الخدمة، يُرجى الاطّلاع على حسابات الخدمة في مستندات Google Cloud. للحصول على تعليمات حول كيفية استخدام حساب خدمة، يُرجى الاطّلاع على استخدام OAuth 2.0 لتطبيقات الخادم إلى الخادم.
الاستخدام الداخلي فقط
يعني ذلك أنّ التطبيق لا يستخدمه سوى الأشخاص في مؤسستك على Google Workspace أو Cloud Identity. يجب أن يكون المشروع مملوكًا للمؤسسة، ويجب ضبط شاشة طلب الموافقة المتعلّقة ببروتوكول OAuth لنوع المستخدم داخلي. في هذه الحالة، قد يحتاج تطبيقك إلى موافقة من مشرف المؤسسة. لمزيد من المعلومات، يُرجى الاطّلاع على اعتبارات إضافية بشأن Google Workspace.
- مزيد من المعلومات حول التطبيقات العامة والداخلية
- يمكنك التعرّف على كيفية وضع علامة على تطبيقك بأنّه داخلي في قسم الأسئلة الشائعة كيف يمكنني وضع علامة على تطبيقي بأنّه داخلي فقط؟
التثبيت على مستوى النطاق
إذا كنت تخطّط لأن يستهدف تطبيقك مستخدمي مؤسسة Google Workspace أو Cloud Identity فقط وأن يستخدم دائمًا التثبيت على مستوى النطاق، لن يتطلّب تطبيقك التحقّق من العلامة التجارية. ومع ذلك، إذا كان تطبيقك يستخدم نطاقات محدودة أو حساسة، يجب التحقق من التطبيق. ويرجع ذلك إلى أنّ التثبيت على مستوى النطاق يتيح لمشرف النطاق منح التطبيقات الداخلية والتطبيقات التابعة لجهات خارجية إذن الوصول إلى بيانات المستخدمين. حسابات مشرفي المؤسسات هي الحسابات الوحيدة التي يمكنها إضافة التطبيق إلى قائمة مسموح بها لاستخدامه ضمن نطاقاتها.
تعرَّف على كيفية جعل تطبيقك متاحًا للتثبيت على مستوى النطاق في قسم الأسئلة الشائعة يضم تطبيقي مستخدمين لديهم حسابات عمل من نطاق Google Workspace آخر.