تُكمِّل واجهة برمجة التطبيقات SMS User Consent API واجهة برمجة التطبيقات SMS ريتريفر من خلال السماح للتطبيق بمطالبة المستخدم بمنح حق الوصول إلى محتوى رسالة SMS واحدة. عندما يمنح المستخدم موافقته، سيتمكن التطبيق بعد ذلك من الوصول إلى نص الرسالة بالكامل لإكمال التحقق من الرسائل القصيرة SMS تلقائيًا.
مسار المستخدمين لواجهة برمجة التطبيقات لموافقة مستخدم الرسائل القصيرة
عند استخدام واجهة برمجة التطبيقات SMS User Consent API لملء الرموز لمرة واحدة تلقائيًا، سيُطلب من المستخدم السماح لتطبيقك بالحصول على إذن بقراءة رسالة SMS واحدة. ستظهر للمستخدم الشاشات التالية عند استخدام SMS User Consent API.
عندما يبدأ المستخدم خطوات إثبات الملكية عبر رسالة قصيرة SMS، سيُطلب منه إدخال الرمز لمرة واحدة باستخدام لوحة المفاتيح. ومن المهم القيام بذلك للتعامل مع الحالة التي يتلقى فيها المستخدم رسالة SMS على جهاز مختلف عن الجهاز الذي يعمل عليه التطبيق.
بعد ذلك، إذا طلب تطبيقك موافقة المستخدم عبر الرسائل القصيرة SMS، سيتم عرض رسالة SMS واردة تحتوي على رمز يُستخدم لمرة واحدة للمستخدم مع خيار مشاركة محتوى رسالة SMS واحدة بالكامل. ولن يتم ذلك إلا إذا طلب التطبيق موافقة المستخدم عبر الرسائل القصيرة SMS وكان يعمل على الجهاز الذي استلم الرسالة القصيرة.
إذا اختار المستخدم تقديم محتوى رسالة SMS إلى تطبيقك، ستتم مشاركة النص الكامل لرسالة SMS. يرى المستخدم أن تدفق التحقق من خلال الرسائل القصيرة SMS يكتمل تلقائيًا.
إذا قرر المستخدم عدم المشاركة، سيكتب يدويًا الرمز الذي يُستخدم لمرة واحدة لإكمال خطوات إثبات الملكية عبر الرسائل القصيرة SMS.
مسار المطوّر بشأن واجهة برمجة التطبيقات لموافقة مستخدم الرسائل القصيرة
لتنفيذ جميع خطوات التحقّق من خلال الرسائل القصيرة SMS باستخدام واجهة برمجة التطبيقات SMS User Consent API، عليك التفاعل مع كلٍ من الخادم الخلفي لإرسال رسالة SMS وواجهة برمجة التطبيقات SMS User Consent API للطلب من المستخدم الوصول إلى رسالة واحدة تحتوي على رمز يُستخدم لمرة واحدة.
خطوة بخطوة، يجب على التطبيق والخادم تنفيذ الخطوات التالية لتنفيذ مسار التحقّق من الرسائل القصيرة SMS باستخدام واجهة برمجة التطبيقات SMS User Consent API:
- يستدعي تطبيقك واجهة برمجة التطبيقات SMS User Consent API لبدء الاستماع إلى ردّ رسائل SMS من الخادم. رسالة SMS واردة قبل البدء في الرسائل القصيرة لن تتم إعادة توجيه موافقة المستخدم إلى تطبيقك.
- بعد بدء استخدام واجهة برمجة التطبيقات SMS User Consent API، يطلب تطبيقك إلى أحد الخوادم إثبات ملكية رقم هاتف المستخدم باستخدام ميزة إثبات الهوية عن طريق الرسائل القصيرة SMS.
- عندما يتلقّى جهاز المستخدم رسالة SMS تحتوي على رمز يُستخدَم لمرة واحدة، تعرض "خدمات Google Play" محتوى الرسالة للمستخدم وتطلب الموافقة على إتاحة ذلك النص لتطبيقك.
- وإذا وافق المستخدم، ستتوفّر رسالة SMS الكاملة لتطبيقك.
- يحلّل تطبيقك الرمز لمرة واحدة من نص الرسالة ويرسله إلى الخادم.
راجع طلب موافقة لمرّة واحدة لقراءة رمز التحقّق عبر رسالة قصيرة SMS للحصول على التفاصيل.