GetGoogleIdOption.Builder
public final class GetGoogleIdOption.Builder
Trình tạo cho GetGoogleIdOption.
Tóm tắt
Hàm khởi tạo công khai |
|---|
Builder() |
Phương thức công khai |
|
|---|---|
final @NonNull GetGoogleIdOption.Builder |
associateLinkedAccounts(Đặt xem có hỗ trợ đăng nhập bằng Tài khoản Google được liên kết với tài khoản của người dùng hay không. |
final @NonNull GetGoogleIdOption |
build() |
final @NonNull GetGoogleIdOption.Builder |
setAutoSelectEnabled(boolean autoSelectEnabled)Đặt hành vi tự động chọn trong yêu cầu. |
final @NonNull GetGoogleIdOption.Builder |
Đặt các thông tin xác nhận cần đưa vào mã thông báo nhận dạng của Google. |
final @NonNull GetGoogleIdOption.Builder |
setFilterByAuthorizedAccounts(boolean filterByAuthorizedAccounts)Đặt xem chỉ cho phép người dùng chọn trong số những Tài khoản Google đã được uỷ quyền đăng nhập vào ứng dụng của bạn hay không. |
final @NonNull GetGoogleIdOption.Builder |
setHostedDomainFilter(String hostedDomainFilter)Đặt bộ lọc miền được lưu trữ để hạn chế tính năng Đăng nhập bằng Google đối với các tài khoản trong một miền Google Workspace cụ thể. |
final @NonNull GetGoogleIdOption.Builder |
Đặt số chỉ dùng một lần để sử dụng khi tạo mã thông báo nhận dạng của Google. |
final @NonNull GetGoogleIdOption.Builder |
setRequestVerifiedPhoneNumber(boolean requestVerifiedPhoneNumber)Đặt xem có yêu cầu số điện thoại đã xác minh trong quá trình đăng ký hay không. |
final @NonNull GetGoogleIdOption.Builder |
setServerClientId(@NonNull String serverClientId)Đặt mã ứng dụng khách của máy chủ để dùng làm đối tượng cho mã nhận dạng Google được tạo trong quá trình đăng nhập. |
Hàm khởi tạo công khai
Phương thức công khai
associateLinkedAccounts
public final @NonNull GetGoogleIdOption.Builder associateLinkedAccounts(
@NonNull String linkedServiceId,
List<@NonNull String> idTokenDepositionScopes
)
Đặt xem có hỗ trợ đăng nhập bằng Tài khoản Google được liên kết với tài khoản của người dùng hay không.
Khi bạn chọn một thông tin đăng nhập như vậy, mã thông báo nhận dạng Google cho Tài khoản Google mà tài khoản đã chọn được liên kết sẽ được gửi đến máy chủ của bạn trước, sau đó được trả về cho bạn. Tương tự như quy trình đăng nhập thông thường, phần phụ trợ của bạn có thể dùng mã thông báo nhận dạng để đăng nhập cho người dùng. Xin lưu ý rằng quá trình gửi mã thông báo nhận dạng sẽ chỉ diễn ra trong lần đăng nhập đầu tiên bằng thông tin đăng nhập này. Những lần đăng nhập tiếp theo sẽ không yêu cầu một bản khai, vì mã nhận dạng sẽ đã được liên kết với tài khoản của người dùng.
| Thông số | |
|---|---|
@NonNull String linkedServiceId |
mã dịch vụ được dùng khi liên kết tài khoản với một Tài khoản Google. |
List<@NonNull String> idTokenDepositionScopes |
Các phạm vi OAuth mà Google sẽ cần để gửi mã thông báo nhận dạng của Google đến máy chủ phụ trợ của ứng dụng. Đây là tham số không bắt buộc và có thể được đặt thành giá trị rỗng. Chỉ bắt buộc nếu Google yêu cầu các phạm vi cụ thể để có thể gửi mã thông báo nhận dạng. |
setAutoSelectEnabled
public final @NonNull GetGoogleIdOption.Builder setAutoSelectEnabled(boolean autoSelectEnabled)
Đặt hành vi tự động chọn trong yêu cầu.
Đối với những người dùng chọn sử dụng, tính năng Tự động chọn cho phép tự động chọn một thông tin đăng nhập mà không cần chờ người dùng thực hiện thao tác (chẳng hạn như nhấn vào nút "tiếp tục"). Hệ thống có thể tự động chọn một thông tin đăng nhập nếu 1) chỉ có thể dùng một thông tin đăng nhập để đăng nhập; và 2) không cần thực hiện thêm hành động nào đối với thông tin đăng nhập này (ví dụ: quyền chia sẻ dữ liệu đã được thu thập cho một Tài khoản Google).
setClaims
public final @NonNull GetGoogleIdOption.Builder setClaims(@NonNull List<@NonNull Claim> claims)
Đặt các thông tin xác nhận cần đưa vào mã thông báo nhận dạng của Google.
Để biết danh sách các thông tin xác nhận có sẵn, hãy xem tài liệu. Mọi thông báo xác nhận quyền sở hữu không được hỗ trợ sẽ bị bỏ qua.
setFilterByAuthorizedAccounts
public final @NonNull GetGoogleIdOption.Builder setFilterByAuthorizedAccounts(boolean filterByAuthorizedAccounts)
Đặt xem chỉ cho phép người dùng chọn trong số những Tài khoản Google đã được uỷ quyền đăng nhập vào ứng dụng của bạn hay không. Giá trị mặc định là true.
Nếu {@code true}, người dùng sẽ không thể chọn bất kỳ Tài khoản Google nào mà nếu không thì sẽ yêu cầu uỷ quyền rõ ràng để chia sẻ dữ liệu cơ bản về hồ sơ/email với ứng dụng của bạn. Điều này có thể giảm bớt một số phiền hà trong hành trình đăng nhập của người dùng và đảm bảo rằng thông tin đăng nhập được trả về là của "người dùng cũ", nhưng hạn chế quyền tự do lựa chọn của người dùng trong số tất cả Tài khoản Google trên thiết bị.
| Thông số | |
|---|---|
boolean filterByAuthorizedAccounts |
có nên chỉ cho phép người dùng chọn trong số những Tài khoản Google đã được uỷ quyền đăng nhập vào ứng dụng của bạn hay không |
setHostedDomainFilter
public final @NonNull GetGoogleIdOption.Builder setHostedDomainFilter(String hostedDomainFilter)
Đặt bộ lọc miền được lưu trữ để hạn chế tính năng Đăng nhập bằng Google đối với các tài khoản trong một miền Google Workspace cụ thể.
Nếu bạn truyền một chuỗi rỗng hoặc chuỗi có giá trị rỗng, thì sẽ không có quá trình lọc nào được thực hiện.
| Thông số | |
|---|---|
String hostedDomainFilter |
miền cần lọc (ví dụ: "example.com") |
setNonce
public final @NonNull GetGoogleIdOption.Builder setNonce(String nonce)
Đặt số chỉ dùng một lần để sử dụng khi tạo mã thông báo nhận dạng của Google.
| Thông số | |
|---|---|
String nonce |
số chỉ dùng một lần để sử dụng trong quá trình tạo mã thông báo nhận dạng |
setRequestVerifiedPhoneNumber
public final @NonNull GetGoogleIdOption.Builder setRequestVerifiedPhoneNumber(boolean requestVerifiedPhoneNumber)
Đặt xem có yêu cầu số điện thoại đã xác minh trong quá trình đăng ký hay không.
Để sử dụng tính năng này, bạn phải đặt trường [filterByAuthorizedAccounts] thành false một cách rõ ràng, vì tính năng này chỉ có trong quá trình đăng ký.
setServerClientId
public final @NonNull GetGoogleIdOption.Builder setServerClientId(@NonNull String serverClientId)
Đặt mã ứng dụng khách của máy chủ để dùng làm đối tượng cho mã nhận dạng Google được tạo trong quá trình đăng nhập.