قبل إطلاق تطبيق يطلب بيانات اعتماد المستخدمين من أجل Data Manager API للمستخدمين الخارجيين، يجب أن يخضع مشروعك على Google Cloud لعملية التحقّق من تطبيق Google OAuth.
يتناول هذا الدليل عمليات نقل إعدادات الجمهور المقترَحة أثناء التطوير وخطوات إكمال عملية التحقّق من تطبيق Google OAuth.
مراحل الجمهور المستهدَف للتطبيق
بناءً على مرحلة التطوير، يمكنك ضبط صفحة الجمهور في Google Cloud Console باستخدام إعدادات مختلفة لكل من نوع المستخدم وحالة النشر. اتّبِع هذه المراحل لضمان انتقال سلس من الاختبار الأولي إلى الإطلاق العلني.
المرحلة 1: التطوير الأوّلي (الاختبار)
عند بدء التطوير واختبار طلبات البيانات الأساسية من واجهة برمجة التطبيقات:
حالة النشر: اضبطها على قيد الاختبار.
نوع المستخدم:
إذا كان مشروعك على Google Cloud ينتمي إلى مؤسسة Google Workspace وكان المستخدمون في مؤسستك فقط هم من يستخدمون التطبيق، اختَر داخلي.
في الحالات الأخرى، اختَر خارجي.
المستخدمون التجريبيون: إذا ضبطت نوع المستخدم على خارجي، انقر على إضافة مستخدمين لإضافة حسابات Google التي تستخدمها لإنشاء بيانات الاعتماد يدويًا. يمكن فقط لحسابات Google المدرَجة في القائمة تفويض التطبيق، وتنطبق حدود الاختبار وقواعد انتهاء صلاحية الرموز المميّزة.
لا يلزم إجراء عملية التحقّق أثناء الاختبار. إذا اخترت خارجي، ستظهر للمستخدمين التجريبيين شاشة تحذير تؤكّد أنّ لديهم إذن وصول تجريبي إلى تطبيق لم يتم التحقّق منه قبل الانتقال إلى شاشة طلب الموافقة.
المرحلة 2: قبل الإطلاق (إرسال طلب التحقّق)
عند اكتمال عملية الدمج وإنشاء واجهة المستخدم والتخطيط لإطلاقها خلال الشهر التالي:
عدِّل إعدادات صفحة "الجمهور":
حالة النشر: الانتقال إلى في مرحلة الإنتاج
نوع المستخدم: اضبطه على خارجي إذا كان تطبيقك يقدّم خدمات لعملاء خارج مؤسستك، مثل عملاء المعلنين.
إرسال تطبيقك لإثبات ملكيته يمكن أن تستغرق عملية التحقّق من تطبيق Google OAuth عدة أسابيع، لذا يُرجى إرسال الطلب في أقرب وقت ممكن بعد أن تصبح واجهة المستخدم جاهزة.
متطلبات التحقّق من التطبيقات
لإرسال تطبيقك للتحقّق منه في مركز التحقّق، عليك ضبط إعدادات Google Auth Platform وتجهيز مواد التحقّق المطلوبة.
العلامة التجارية وسياسة الخصوصية
في صفحة "الهوية البصرية للعلامة التجارية" في وحدة تحكّم Google Cloud، تأكَّد من التفاصيل التالية قبل إرسال الطلب:
الصفحة الرئيسية للتطبيق: يجب أن تكون صفحتك الرئيسية متاحة للجميع وأن تتضمّن رابطًا مرئيًا لسياسة الخصوصية في تطبيقك.
رابط سياسة الخصوصية: يجب أن يتطابق عنوان URL لسياسة الخصوصية الذي تم ضبطه في صفحة "الهوية البصرية للعلامة التجارية" مع عنوان URL لسياسة الخصوصية المرتبط بالصفحة الرئيسية لتطبيقك.
نطاقات التحقّق
في صفحة "الوصول إلى البيانات"، اطلب فقط النطاقات التي يحتاجها تطبيقك. تستخدم واجهة Data Manager API النطاقات الحسّاسة التالية:
https://www.googleapis.com/auth/datamanager(النطاق الأساسي)
https://www.googleapis.com/auth/datamanager.partnerlink(لروابط الشركاء)
في طلب التحقّق، قدِّم شرحًا كتابيًا مفصلاً لسبب طلب تطبيقك الوصول إلى النطاقات المطلوبة.
معلومات الاتصال
يرسل فريق التحقّق من Google OAuth جميع المراسلات إلى مالكي المشاريع ومحرّري المشاريع الذين تم ضبطهم في مشروعك على Google Cloud. يُرجى الحرص على تحديث تفاصيل الاتصال هذه باستمرار في وحدة تحكّم Google Cloud كي لا تفوتك طلبات الحصول على المعلومات.
إذا أرسل فريق التحقّق أسئلة متابعة أو طلب إجراء تعديلات (مثل تغييرات على الفيديو التوضيحي أو إعدادات شاشة طلب الموافقة)، يتم إيقاف المراجعة مؤقتًا إلى حين الردّ. إذا ظلّ طلبك في انتظار المراجعة لأكثر من بضعة أسابيع بدون تلقّي أي تحديث، يُرجى التحقّق من صناديق البريد الوارد (بما في ذلك مجلدات الرسائل غير المرغوب فيها والمهملات) لجميع مالكي المشاريع ومحرّريها.
عرض توضيحي بالفيديو
يُرجى تقديم رابط لفيديو توضيحي متاح للجميع (مثل فيديو غير مُدرَج على YouTube أو رابط متاح للجميع على Google Drive) يوضّح كيفية استخدام تطبيقك للنطاقات المطلوبة.
تأكَّد من أنّ الفيديو يستوفي جميع متطلبات فيديو توضيح وظائف التطبيق، بما في ذلك عمليات التحقّق التالية من Data Manager API:
تجربة المستخدم الكاملة ومنح الإذن باستخدام OAuth: اعرض تجربة المستخدم الكاملة في تطبيقك، بدءًا من بدء المستخدم لعملية تسجيل الدخول أو التفويض وحتى إكمال عملية منح الإذن باستخدام OAuth.
مطابقة هوية التطبيق: تأكَّد من أنّ اسم التطبيق وشعاره وهويته البصرية المعروضة في الفيديو تتطابق مع إعدادات صفحة الهوية البصرية في وحدة تحكّم Google Cloud.
إكمال شاشة طلب الموافقة المتعلّقة ببروتوكول OAuth باللغة الإنجليزية: يجب عرض شاشة طلب الموافقة المتعلّقة ببروتوكول OAuth بالكامل مع ضبط أداة اختيار اللغة في أسفل يمين الشاشة على الإنجليزية، والتأكّد من أنّ الشاشة تعرض النطاقات الدقيقة التي يطلبها تطبيقك في Data Manager API.
استخدام النطاقات في واجهة مستخدم تطبيقك: اعرض ميزات التطبيق التي تستخدم النطاقات المطلوبة (على سبيل المثال، إنشاء رابط شريك أو قائمة مستخدمين أو ضبط نقل البيانات في واجهة مستخدم تطبيقك).
المرحلة 3: جاهز للإطلاق (تم التحقّق منه)
بعد أن يرسل إليك فريق التحقّق من Google OAuth إشعارًا بالموافقة على طلب التحقّق من تطبيقك، ليس عليك اتّخاذ أي إجراء. تم الآن التحقّق من تطبيقك، ويمكن للمستخدمين الخارجيين منحه الإذن بدون ظهور شاشة التحذير الخاصة بالتطبيقات التي لم يتم التحقّق منها.