Ta strona została przetłumaczona przez Cloud Translation API.

Integracja Logowania przez Google z aplikacją na Androida

Ostrzeżenie: Logowanie w Google na Androida jest nieaktualne i nie jest już obsługiwane. Aby zapewnić bezpieczeństwo i łatwość obsługi aplikacji, przejdź na Menedżera danych logowania. Menedżer danych uwierzytelniających obsługuje klucze dostępu, hasła i uwierzytelnianie przy użyciu tożsamości z użyciem federacji (np. logowanie z Google). Zapewnia też większe bezpieczeństwo i bardziej spójne wrażenia użytkowników. Informacje dla deweloperów aplikacji na Wear: Menedżer danych logowania będzie obsługiwany w Wear OS 5.1 i nowszych na wybranych zegarkach. Deweloperzy, którzy aktywnie obsługują urządzenia z Wear OS 3, 4 i 5.0 z funkcją logowania się przez Google, powinni nadal używać logowania przez Google na Androida w przypadku aplikacji na Wear. W przyszłości usługa logowania się za pomocą Google będzie obsługiwana przez interfejsy API menedżera danych logowania w przypadku tych wersji Wear OS.

Aby zintegrować logowanie przez Google z aplikacją na Androida, skonfiguruj logowanie przez Google i dodaj do układu aplikacji przycisk, który uruchamia proces logowania.

Zanim zaczniesz

Skonfiguruj projekt w Konsoli interfejsów API Google i ustaw projekt w Android Studio.

Konfigurowanie logowania przez Google i obiektu GoogleSignInClient

W metodzie onCreate aktywności logowania skonfiguruj logowanie przez Google, aby poprosić o dane użytkownika wymagane przez aplikację. Aby na przykład skonfigurować logowanie przez Google w celu żądania identyfikatora użytkownika i podstawowych informacji o profilu, utwórz obiekt GoogleSignInOptions z parametrem DEFAULT_SIGN_IN. Aby poprosić użytkowników o adresy e-mail, utwórz obiekt GoogleSignInOptions z opcją requestEmail.
```
// Configure sign-in to request the user's ID, email address, and basic
// profile. ID and basic profile are included in DEFAULT_SIGN_IN.
GoogleSignInOptions gso = new GoogleSignInOptions.Builder(GoogleSignInOptions.DEFAULT_SIGN_IN)
        .requestEmail()
        .build();
```
Jeśli potrzebujesz dodatkowych zakresów uprawnień, aby uzyskać dostęp do interfejsów API Google, określ je za pomocą requestScopes. Aby zapewnić użytkownikom jak najlepszą obsługę, podczas logowania żądaj tylko zakresów niezbędnych do minimalnego działania aplikacji. Wymagaj dodatkowych zakresów tylko wtedy, gdy są Ci potrzebne, aby użytkownicy widzieli ekran zgody w kontekście wykonanego przez nich działania. Zobacz artykuł Prośba o dodatkowe zakresy.

Następnie w metodzie onCreate aktywności logowania utwórz obiekt GoogleSignInClient z określonymi opcjami.

// Build a GoogleSignInClient with the options specified by gso.
mGoogleSignInClient = GoogleSignIn.getClient(this, gso);

Sprawdzanie, czy zalogowany użytkownik jest już obecny

W metodzie onStart aktywności sprawdź, czy użytkownik jest już zalogowany w aplikacji za pomocą Google.

// Check for existing Google Sign In account, if the user is already signed in
// the GoogleSignInAccount will be non-null.
GoogleSignInAccount account = GoogleSignIn.getLastSignedInAccount(this);
updateUI(account);

Jeśli funkcja GoogleSignIn.getLastSignedInAccount zwraca obiekt GoogleSignInAccount (a nie null), oznacza to, że użytkownik jest już zalogowany w aplikacji za pomocą Google. Zaktualizuj interfejs użytkownika, aby ukryć przycisk logowania, uruchomić główną aktywność lub wykonać inne odpowiednie działanie.

Jeśli GoogleSignIn.getLastSignedInAccount zwraca wartość null, użytkownik nie zalogował się jeszcze w aplikacji za pomocą Google. Zaktualizuj interfejs, aby wyświetlić przycisk logowania w Google.

Dodawanie przycisku logowania w Google do aplikacji

Standardowy przycisk logowania Google Dodaj SignInButton do układu aplikacji:

<com.google.android.gms.common.SignInButton
 android:id="@+id/sign_in_button"
 android:layout_width="wrap_content"
 android:layout_height="wrap_content" />

Opcjonalnie: jeśli zamiast własnych komponentów przycisku logowania używasz domyślnej grafiki przycisku logowania, możesz dostosować rozmiar przycisku za pomocą metody setSize.
```
// Set the dimensions of the sign-in button.
SignInButton signInButton = findViewById(R.id.sign_in_button);
signInButton.setSize(SignInButton.SIZE_STANDARD);
```
W aktywności Androida (np. w metodzie onCreate) zarejestruj metodę OnClickListener przycisku, aby logować użytkownika po jego kliknięciu:
```
findViewById(R.id.sign_in_button).setOnClickListener(this);
```

Rozpoczęcie procesu logowania

W metodzie onClick aktywności obsłuż kliknięcia przycisku logowania, tworząc użycie logowania za pomocą metody getSignInIntent i uruchamiając użycie za pomocą funkcji startActivityForResult.
```
@Override
public void onClick(View v) {
    switch (v.getId()) {
        case R.id.sign_in_button:
            signIn();
            break;
        // ...
    }
}
```
```
private void signIn() {
    Intent signInIntent = mGoogleSignInClient.getSignInIntent();
    startActivityForResult(signInIntent, RC_SIGN_IN);
}
```
Po uruchomieniu intencjonalnego prompta użytkownik musi wybrać konto Google, na które chce się zalogować. Jeśli zażądasz zakresów innych niż profile, email i openid, użytkownik zostanie też poproszony o przyznanie dostępu do żądanych zasobów.

Po zalogowaniu się użytkownika możesz uzyskać obiekt GoogleSignInAccount dla użytkownika w ramach metody onActivityResult aktywności.

@Override
public void onActivityResult(int requestCode, int resultCode, Intent data) {
    super.onActivityResult(requestCode, resultCode, data);

    // Result returned from launching the Intent from GoogleSignInClient.getSignInIntent(...);
    if (requestCode == RC_SIGN_IN) {
        // The Task returned from this call is always completed, no need to attach
        // a listener.
        Task<GoogleSignInAccount> task = GoogleSignIn.getSignedInAccountFromIntent(data);
        handleSignInResult(task);
    }
}

Obiekt GoogleSignInAccount zawiera informacje o zalogowanym użytkowniku, takie jak jego imię i nazwisko.

private void handleSignInResult(Task<GoogleSignInAccount> completedTask) {
    try {
        GoogleSignInAccount account = completedTask.getResult(ApiException.class);

        // Signed in successfully, show authenticated UI.
        updateUI(account);
    } catch (ApiException e) {
        // The ApiException status code indicates the detailed failure reason.
        // Please refer to the GoogleSignInStatusCodes class reference for more information.
        Log.w(TAG, "signInResult:failed code=" + e.getStatusCode());
        updateUI(null);
    }
}

Możesz też uzyskać adres e-mail użytkownika za pomocą getEmail, identyfikatora Google użytkownika (do użytku po stronie klienta) za pomocą getId oraz tokenu identyfikacyjnego użytkownika za pomocą getIdToken. Jeśli chcesz przekazać aktualnie zalogowanego użytkownika serwerowi backendu, wyślij token identyfikacyjny do serwera backendu i potwierdź token na serwerze.