GetGoogleIdOption.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 المميّزة لتعريف المستخدم" التي يتم إنشاؤها أثناء تسجيل الدخول.

وظائف الإنشاء العامة

عامل بناء

Builder()

وظائف عامة

associateLinkedAccounts

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 التي سبق أن تم تفويضها لتسجيل الدخول إلى تطبيقك فقط. القيمة التلقائية هي true.

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

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

setNonce

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

لضبط القيمة غير القابلة للتكرار التي سيتم استخدامها عند إنشاء رمز مميّز لهوية Google.

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

setRequestVerifiedPhoneNumber

fun setRequestVerifiedPhoneNumber(requestVerifiedPhoneNumber: Boolean): GetGoogleIdOption.Builder

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

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

setServerClientId

fun setServerClientId(serverClientId: String): GetGoogleIdOption.Builder

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

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