GetGetIdId.Builder

لغة Kotlin |Java

class GetGoogleIdOption.Builder

---

إحدى أدوات إنشاء GetGoogleIdOption.

ملخّص

شركات البناء العامة
Builder()

وظائف عامة
GetGoogleIdOption.Builder	associateLinkedAccounts(     linkedServiceId: String,     idTokenDepositionScopes: List<String>? ) لضبط ما إذا كان سيتم دعم تسجيل الدخول باستخدام حسابات Google المرتبطة بحسابات المستخدمين أم لا.
GetGoogleIdOption	build()
GetGoogleIdOption.Builder	setAutoSelectEnabled(autoSelectEnabled: Boolean) ضبط سلوك الاختيار التلقائي في الطلب
GetGoogleIdOption.Builder	setFilterByAuthorizedAccounts(filterByAuthorizedAccounts: Boolean) يحدِّد هذا الإعداد ما إذا كان سيتم السماح للمستخدم فقط بالاختيار من حسابات Google المصرّح لها بتسجيل الدخول إلى تطبيقك أم لا.
GetGoogleIdOption.Builder	setNonce(nonce: String?) يؤدي هذا الخيار إلى وضع علامة غير مميّزة لاستخدامها في إنشاء رمز مميّز لرقم تعريف Google.
GetGoogleIdOption.Builder	setRequestVerifiedPhoneNumber(requestVerifiedPhoneNumber: Boolean) يحدِّد هذا الإعداد ما إذا كان سيتم طلب رقم هاتف تم إثبات ملكيته أثناء عمليات الاشتراك.
GetGoogleIdOption.Builder	setServerClientId(serverClientId: String) يحدّد هذا الإعداد معرّف العميل للخادم لاستخدامه كجمهور للرموز المميزة التي تم إنشاؤها أثناء تسجيل الدخول في Google ID.

شركات البناء العامة

عامل بناء

Builder()

وظائف عامة

ربط حسابات

fun associateLinkedAccounts(
    linkedServiceId: String,
    idTokenDepositionScopes: List<String>?
): GetGoogleIdOption.Builder

لضبط ما إذا كان سيتم دعم تسجيل الدخول باستخدام حسابات Google المرتبطة بحسابات المستخدمين أم لا.

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

المَعلمات
linkedServiceId: String	معرِّف الخدمة المُستخدَم عند ربط الحسابات بحساب Google
idTokenDepositionScopes: List<String>?	نطاقات Oauth التي ستحتاج Google إلى إيداع رمزها المميّز لمعرّف Google في الخادم الخلفي لتطبيقك. هذه خطوة اختيارية ويمكن ضبطها على قيمة فارغة. تكون هذه السمة مطلوبة فقط إذا كانت Google تتطلّب نطاقات معيّنة لإيداع الرمز المميّز لرقم التعريف.

إنشاء

fun build(): GetGoogleIdOption

setAutoSelectEnabled

fun setAutoSelectEnabled(autoSelectEnabled: Boolean): GetGoogleIdOption.Builder

ضبط سلوك الاختيار التلقائي في الطلب

بالنسبة إلى المستخدمين الذين فعّلوا هذه الميزة، تسمح ميزة "الاختيار التلقائي" باختيار بيانات الاعتماد تلقائيًا بدون انتظار إجراء المستخدم (مثل النقر على الزر "متابعة"). يمكن اختيار بيانات الاعتماد تلقائيًا إذا (1) يمكن استخدام بيانات اعتماد واحدة فقط لتسجيل الدخول، و2) لا يلزم اتخاذ أي إجراء آخر لبيانات الاعتماد هذه (على سبيل المثال، يتم جمع أذونات مشاركة البيانات لحساب Google).

setfilterByAuthorizedAccounts

fun setFilterByAuthorizedAccounts(filterByAuthorizedAccounts: Boolean): GetGoogleIdOption.Builder

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

في حال =\"code true}، لن يتمكّن المستخدم من اختيار أي حساب على Google سيتطلب تفويضًا صريحًا بمشاركة بيانات الملف الشخصي/البريد الإلكتروني الأساسية مع تطبيقك. وقد يقلل ذلك من بعض المعوقات في رحلة المستخدم الذي يسجّل الدخول، ويضمن أن بيانات الاعتماد المعروضة هي "لمستخدم مكرّر الزيارة"، ولكنها تحدّ من حرية المستخدم في الاختيار من بين جميع حسابات Google على الجهاز.

المَعلمات
filterByAuthorizedAccounts: Boolean	السماح للمستخدم بالاختيار من بين حسابات Google المسموح لها بتسجيل الدخول إلى تطبيقك فقط

مجموعة غير المخصّصة

fun setNonce(nonce: String?): GetGoogleIdOption.Builder

يؤدي هذا الخيار إلى وضع علامة غير مميّزة لاستخدامها في إنشاء رمز مميّز لرقم تعريف Google.

المَعلمات
nonce: String?	احتمال استخدامه أثناء إنشاء الرمز المميّز للمعرّف

setRequestVerifiedPhoneNumber

fun setRequestVerifiedPhoneNumber(requestVerifiedPhoneNumber: Boolean): GetGoogleIdOption.Builder

يحدِّد هذا الإعداد ما إذا كان سيتم طلب رقم هاتف تم إثبات ملكيته أثناء عمليات الاشتراك.

لاستخدام هذه الميزة، يجب ضبط الحقل [filterByAuthorizedAccounts] على خطأ، لأن هذه الميزة متاحة فقط أثناء عمليات الاشتراك.

setServerClientId

fun setServerClientId(serverClientId: String): GetGoogleIdOption.Builder

يحدّد هذا الإعداد معرّف العميل للخادم لاستخدامه كجمهور للرموز المميزة التي تم إنشاؤها أثناء تسجيل الدخول في Google ID.

المَعلمات
serverClientId: String	معرِّف العميل للخادم الذي سيتم إصدار الرمز المميّز له