تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

GetGetIdId.Builder

public final class GetGoogleIdOption.Builder

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

ملخّص

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

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

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

عامل بناء

public Builder()

الطرق المتاحة للجميع

ربط حسابات

public final @NonNull GetGoogleIdOption.Builder associateLinkedAccounts(
    @NonNull String linkedServiceId,
    List<@NonNull String> idTokenDepositionScopes
)

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

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

المَعلمات

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

@NonNull String linkedServiceId

معرِّف الخدمة المُستخدَم عند ربط الحسابات بحساب Google

List<@NonNull String> idTokenDepositionScopes

نطاقات Oauth التي ستحتاج Google إلى إيداع رمزها المميّز لمعرّف Google في الخادم الخلفي لتطبيقك. هذه خطوة اختيارية ويمكن ضبطها على قيمة فارغة. تكون هذه السمة مطلوبة فقط إذا كانت Google تتطلّب نطاقات معيّنة لإيداع الرمز المميّز لرقم التعريف.

إنشاء

public final @NonNull GetGoogleIdOption build()

setAutoSelectEnabled

public final @NonNull GetGoogleIdOption.Builder setAutoSelectEnabled(boolean autoSelectEnabled)

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

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

setfilterByAuthorizedAccounts

public final @NonNull GetGoogleIdOption.Builder setFilterByAuthorizedAccounts(boolean filterByAuthorizedAccounts)

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

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

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

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

public final @NonNull GetGoogleIdOption.Builder setNonce(String nonce)

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

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

setRequestVerifiedPhoneNumber

public final @NonNull GetGoogleIdOption.Builder setRequestVerifiedPhoneNumber(boolean requestVerifiedPhoneNumber)

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

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

setServerClientId

public final @NonNull GetGoogleIdOption.Builder setServerClientId(@NonNull String serverClientId)

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

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